Tapatybė ir saugumas
Šiame puslapyje
Pamoka perrašyta 2026 m. lapkričio 3 d. remiantis „OpenAI“ dokumentacija apie Tapatybę ir Saugumą bei privatumą papildiniams. Ankstesnė versija aprašė API rakto autentifikavimą ir
authkonfigūraciją neegzistuojančiame manifeste; „ChatGPT“ negali pateikti tinkinto API rakto, o vietoj to laikosi MCP specifikacijoje apibrėžtos autorizacijos eigos (OAuth 2.1). Šaltiniai: Authentication · Security & Privacy.
Kam reikia autentifikacijos
Daugelis MCP serverių gali veikti anonimiškai, tik skaitymo režimu. Tačiau bet kuris serveris, atskleidžiantis su naudotoju susijusius duomenis arba atliekantis rašymo operacijas, privalo autentifikuoti naudotoją. Autorizacijos sutartis laikosi MCP specifikacijos, kuri „ChatGPT“ ir „Codex“ sistemose yra identiška: tai OAuth 2.1 eiga, apimanti tris veikėjus.
- Išteklių serveris: Jūsų MCP serveris, kuris pateikia įrankius ir kiekvieno užklausos metu tikrina prieigos žetoną.
- Autorizacijos serveris: Jūsų tapatybės teikėjas, kuris išduoda žetonus ir skelbia savo atradimo metaduomenis.
- Klientas: „OpenAI“ mazgas („ChatGPT“ arba „Codex“), veikiantis naudotojo vardu.
„OpenAI“ primygtinai rekomenduoja pasikliauti nusistovėjusiu tapatybės teikėju, o ne kurti autentifikavimą nuo nulio; jų dokumentacijoje konkrečiai nurodomi „Auth0“ ir „Stytch“.
Ko reikalauja specifikacija
Apsaugoto ištekliaus metaduomenys. Jūsų MCP serveris privalo paskelbti dokumentą, pavyzdžiui, adresu https://your-mcp.example.com/.well-known/oauth-protected-resource, kuriame būtų nurodytas jo kanoninis identifikatorius (resource), jo autorizacijos serveriai (authorization_servers) ir, pasirinktinai, palaikomos sritys (scopes_supported). Kai gaunama užklausa be galiojančio autentifikavimo, serveris privalo atsakyti kodu 401 Unauthorized ir antrašte, nukreipiančia į šį dokumentą:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Autorizacijos serverio metaduomenys, esantys adresu /.well-known/oauth-authorization-server arba /.well-known/openid-configuration, privalo apimti leidėją (issuer), autorizacijos ir žetonų galinius taškus bei code_challenge_methods_supported, kuriame būtų S256. Be to MCP serveris nėra palaikomas, nes PKCE yra privalomas.
Parametras resource nuo pradžios iki galo. „ChatGPT“ prie autorizacijos ir žetonų užklausų prideda resource=…. Jūsų autorizacijos serveris privalo nukopijuoti tai į žetoną (dažnai kaip aud teiginį), o jūsų MCP serveris privalo atmesti bet kurį žetoną, išduotą ne konkrečiai jam.
Kaip „ChatGPT“ registruojasi kaip klientas
Gyvena trys metodai. Pageidaujamas metodas yra CIMD (Client ID Metadata Documents): „ChatGPT“ kaip client_id naudoja HTTPS serveryje talpinamo metaduomenų dokumento URL, kurį skaito jūsų autorizacijos serveris. Tai įgalinkite paskelbdami client_id_metadata_document_supported: true. „ChatGPT“ žetonų galiniame taške palaiko du autentifikavimo metodus: none (viešas klientas, apsaugotas PKCE) ir private_key_jwt (pasirašytas teiginys, tikrinamas naudojant „ChatGPT“ paskelbtą viešąjį raktą). Dinaminė kliento registracija (DCR) išlieka galima, jei paskelbiate registration_endpoint: „ChatGPT“ registruojasi vieną kartą per ryšį ir pakartotinai naudoja tą klientą. Iš anksto apibrėžtas OAuth klientas yra trečioji opcija.
Kalbant apie nukreipimus, tiksliai nukopijuokite URI, rodomą „ChatGPT“ MCP serverio valdymo puslapyje, į savo autorizacijos serverio leidimų sąrašą. Šis URI priklauso nuo leidėjo identifikavimo palaikymo (RFC 9207, parametras iss, grąžinamas kiekviename autorizacijos atsakyme).
Naudotojui matoma eiga
- „ChatGPT“ nuskaitys jūsų serverio apsaugoto ištekliaus metaduomenis.
- Prisistatys kaip OAuth klientas (per CIMD, DCR arba iš anksto apibrėžtą klientą).
- Pirmojo kreipimosi į apsaugotą įrankį metu jis inicijuos autorizacijos kodo + PKCE eigą: naudotojas prisijungia ir sutinka su prašomomis sritimis.
- „ChatGPT“ iškeičia kodą į žetoną ir prideda jį prie vėlesnių MCP užklausų (
Authorization: Bearer …). - Jūsų serveris prieš vykdydamas įrankį kiekvieno užklausos metu patikrina žetoną.
Nurodymas, kuriems įrankiams reikia paskyros
„ChatGPT“ rodo savo paskyrų susiejimo sąsają tik tada, kai jūsų serveris signalizuoja, kad OAuth yra prieinamas arba būtinas. Tam reikia abiejų dalių: metaduomenų ir vykdymo laiko klaidos.
Pirma, metaduomenys: kiekvienas įrankis deklaruoja savo politiką _meta.securitySchemes. noauth reiškia, kad galima kviesti anonimiškai, o oauth2 reikalauja žetono su nurodytomis sritimis. Abiejų deklaravimas signalizuoja, kad įrankis gali pradėti darbą be paskyros, tačiau susiejimas atrakina daugiau funkcionalumo. Deklaruokite tai kiekvienam įrankiui atskirai, net jei visas serveris laikosi tos pačios politikos.
server.registerTool(
"create_doc",
{
title: "Create Document",
description: "Creates a new document in the user's account.",
inputSchema: { title: z.string().min(1) },
_meta: { securitySchemes: [{ type: "oauth2", scopes: ["docs.write"] }] },
},
async ({ title }, extra) => {
const token = await verifyToken(extra); // signature, iss, aud, exp, scopes
if (!token) {
return {
isError: true,
content: [{ type: "text", text: "Login required to create a document." }],
_meta: {
"mcp/www_authenticate": [
'Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", error="insufficient_scope", error_description="Link your account to continue"',
],
},
};
}
// … create document for token.sub
}
);
Antra, vykdymo laiko klaida: kai žetono trūksta arba jis negalioja, įrankis privalo grąžinti klaidos rezultatą, kuriame būtų _meta["mcp/www_authenticate"] su parametrais error ir error_description. Būtent šis turinys suaktyvina prisijungimo sąsają. verifyToken yra jūsų tikrinimo funkcija; Python ir TypeScript MCP SDK pateikia pagalbos funkcijas jai parašyti.
Kiekvieno žetono tikrinimas
Kai eiga baigiama, „ChatGPT“ prie kiekvienos užklausos prideda žetoną tokį, koks jis yra. Laikykite jį nepatikimu ir patys atlikite visus standartinius išteklių serverio tikrinimus: parašo validavimą naudojant jūsų autorizacijos serverio paskelbtus raktus (JWKS) ir teiginį iss; laiko galiojimą (exp, nbf); auditoriją (aud arba resource) ir reikiamas sritis; po to taikykite savo verslo taisykles. Nepavykus: grąžinkite 401 ir antraštę WWW-Authenticate, kuri iš naujo paleidžia OAuth eigą.
„ChatGPT“ identifikavimas kaip kliento
Norint patikrinti, ar užklausa tikrai ateina iš „ChatGPT“, egzistuoja du metodai. „ChatGPT“ TLS ryšio metu pateikia „OpenAI“ valdomą kliento sertifikatą (mTLS). Patikrinkite, ar jis grandine siejasi su tarpine institucija, kurią paskelbė „OpenAI“, ar jis galioja kliento autentifikavimui ir ar turi dnsName mtls.prod.connectors.openai.com. Neprikabinkite lapo sertifikato piršto atspaudo, nes „OpenAI“ gali jį pakeisti. Taip pat galite filtruoti pagal paskelbtus IP adresų diapazonus. mTLS autentifikuoja „ChatGPT“, o OAuth toliau autentifikuoja naudotoją.
„ChatGPT“ nepalaiko mašinos ir mašinos leidimų (client credentials, paslaugų paskyrų, JWT bearer teiginių), tinkintų API raktų ar kliento pateiktų mTLS sertifikatų.
„OpenAI“ saugumo principai
- Mažiausios privilegijos: Prašykite tik būtinų sričių, saugyklos ir tinklo prieigos.
- Aiškus sutikimas: Naudotojai privalo suprasti, kada jie susieja paskyrą arba suteikia rašymo prieigą; destruktyviems veiksmams naudokite mazgo patvirtinimus.
- Gynyba gylyje: Darykite prielaidą, kad į jūsų serverį pateks raginimų injekcijos ir kenkėjiškos įvestys. Tikrinkite visas įvestis serverio pusėje, net tas, kurias pateikė modelis, ir tvarkykite audito žurnalus.
Kalbant apie duomenis: į structuredContent įtraukite tik tai, ko reikia užklausai, paskelbkite išsaugojimo politiką, vykdykite ištrynimo prašymus ir užmaskuokite asmens duomenis žurnaluose. Kalbant apie sąsają: komponentas veikia izoliuotame „iframe“ pagal griežtą turinio saugumo politiką, be prieigos prie window.alert, window.prompt, window.confirm arba navigator.clipboard. Kalbant apie operacijas: prieš paleidimą atlikite saugumo peržiūrą, praneškite apie pasikartojančius autentifikavimo gedimus ir atnaujinkite priklausomybes.
Autentifikavimo testavimas
Pradėkite nuo kūrimo nuomininko, kuris išduoda trumpalaikius žetonus, prieš atverdami prieigą apribokite ją patikimiems testeriams ir suplanuokite atšaukimą, atnaujinimą bei sričių keitimą. Žetono nebuvimą arba galiojimo pabaigą traktuokite kaip autentifikavimo stoką ir pateikite naudingą klaidos pranešimą. MCP Inspector nustatymuose Auth leidžia žingsnis po žingsnio atsekti OAuth eigą ir pamatyti, kur ji stringa.
Svarbiausi punktai
- Privatiniai duomenys arba rašymas: OAuth 2.1 pagal MCP specifikaciją, su PKCE
S256 - Serveris skelbia apsaugoto ištekliaus metaduomenis ir atsako
401+WWW-Authenticate - CIMD yra pageidaujamas registracijos metodas; DCR ir iš anksto apibrėžti klientai lieka kaip opcijos
- Susiejimo sąsaja:
securitySchemeskiekvienam įrankiui ir klaida, turinti_meta["mcp/www_authenticate"] - Tikrinkite kiekvieną žetoną kiekvieno užklausos metu; mTLS identifikuoja „ChatGPT“, OAuth identifikuoja naudotoją