Autentimine ja turvalisus
Sellel lehel
Õppetund kirjutati ümber 3. novembril 2026, tuginedes OpenAI dokumentatsioonile Authentication ja Security & Privacy pluginate kohta. Eelmine versioon kirjeldas API-võtme autentimist ja
authkonfiguratsiooni olematus manifestis; ChatGPT ei saa esitada kohandatud API-võtit, vaid järgib MCP spetsifikatsioonis määratletud volitusvoogu (OAuth 2.1). Allikad: Authentication · Security & Privacy.
Kes peab autentima
Paljud MCP-serverid saavad töötada anonüümses kirjutuskaitstud režiimis. Iga server, mis avaldab kasutajaspetsiifilisi andmeid või teostab kirjutamistoiminguid, peab aga kasutaja autentima. Volitamisleping järgib MCP spetsifikatsiooni, mis on ChatGPT ja Codexi puhul identne: OAuth 2.1 voog, mis hõlmab kolme osapoolt.
- Ressursiserver: Sinu MCP-server, mis avaldab tööriistu ja kontrollib iga päringu puhul juurdepääsutokenit.
- Volitusserver: Sinu identiteediteenuse pakkuja, mis väljastab tokeneid ja avaldab oma avastamismetaandmeid.
- Klient: OpenAI host (ChatGPT või Codex), tegutseb kasutaja nimel.
OpenAI soovitab tungivalt tugineda väljakujunenud identiteediteenuse pakkujale, mitte ehitada autentimist nullist; nende dokumentatsioon viitab konkreetselt Auth0-le ja Stytchile.
Mida spetsifikatsioon nõuab
Kaitstud ressursi metaandmed. Sinu MCP-server peab avaldama dokumendi, näiteks aadressil https://your-mcp.example.com/.well-known/oauth-protected-resource, mis sisaldab selle kanoonilist identifikaatorit (resource), volitusservereid (authorization_servers) ja valikuliselt toetatud ulatusi (scopes_supported). Kui saabub päring ilma kehtiva autentimiseta, peab server vastama olekukoodiga 401 Unauthorized ja päisega, mis viitab sellele dokumendile:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Volitusserveri metaandmed, asukohas /.well-known/oauth-authorization-server või /.well-known/openid-configuration, peavad sisaldama väljastajat (issuer), volitus- ja tokeni lõpp-punkte ning code_challenge_methods_supported, mis sisaldab väärtust S256. Ilma selleta ei ole MCP-server toetatud, kuna PKCE on kohustuslik.
Parameeter resource otsast otsani. ChatGPT lisab volitus- ja tokenipäringutesse parameetri resource=…. Sinu volitusserver peab selle tokenisse kopeerima (sageli kui väite aud) ja sinu MCP-server peab tagasi lükkama iga tokeni, mida pole konkreetselt selle jaoks väljastatud.
Kuidas ChatGPT kliendina registreerub
Kolm meetodit eksisteerivad paralleelselt. Eelistatud meetod on CIMD (Client ID Metadata Documents): ChatGPT kasutab HTTPS-i kaudu majutatava metaandmete dokumendi URL-i kui client_id, mida sinu volitusserver loeb. Selle lubamiseks avalda client_id_metadata_document_supported: true. ChatGPT toetab tokeni lõpp-punktis kahte autentimismeetodit: none (avalik klient, kaitstud PKCE-ga) ja private_key_jwt (allkirjastatud kinnitus, mida saab kontrollida ChatGPT avaldatud avaliku võtmega). Dünaamiline kliendi registreerimine (DCR) on samuti võimalik, kui avaldad registration_endpoint: ChatGPT registreerub iga ühenduse kohta üks kord ja kasutab seda klienti edaspidi. Eelmääratud OAuth-klient on kolmas võimalus.
Ümbersuunamiste puhul kopeeri MCP-serveri halduslehel ChatGPT-is kuvatav URI täpselt oma volitusserveri lubatud loendisse. See URI sõltub väljastaja identifitseerimise (RFC 9207, parameeter iss, mis tagastatakse igas volitusvastuses) toetusest.
Kasutajale suunatud voog
- ChatGPT loeb sinu serveri kaitstud ressursi metaandmed.
- See identifitseerib ennast OAuth-kliendina (kasutades CIMD-d, DCR-i või eelmääratud klienti).
- Esimesel kaitstud tööriista kutsumisel algatab see volituskoodi + PKCE voo: kasutaja logib sisse ja annab nõusoleku taotletud ulatustele.
- ChatGPT vahetab koodi tokeni vastu ja lisab selle järgnevatele MCP-päringutele (
Authorization: Bearer …). - Sinu server kontrollib iga päringu puhul tokenit enne tööriista käivitamist.
Tööriistade deklareerimine, mis nõuavad kontot
ChatGPT kuvab oma konto sidumise liidese ainult siis, kui sinu server annab märku, et OAuth on saadaval või nõutav. See nõuab mõlemat poolt: metaandmeid ja käivitusaja viga.
Esiteks metaandmed: iga tööriist deklareerib oma poliitika väljas _meta.securitySchemes. noauth tähendab, et seda saab kutsuda anonüümselt, samas kui oauth2 nõuab tokenit näidatud ulatustega. Mõlema deklareerimine annab märku, et tööriista saab kasutada ilma kontota, kuid sidumine avab rohkem funktsioone. Deklareeri see iga tööriista kohta eraldi, isegi kui kogu server järgib sama poliitikat.
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
}
);
Teiseks käivitusaja viga: kui token puudub või on kehtetu, peab tööriist tagastama veatulemuse, mis sisaldab _meta["mcp/www_authenticate"] parameetritega error ja error_description. See sisu on see, mis tegelikult käivitab sisselogimisliidese. verifyToken on sinu kontrollifunktsioon; Pythoni ja TypeScripti MCP SDK-d pakuvad abivahendeid selle kirjutamiseks.
Iga tokeni kontrollimine
Kui voog on lõpule viidud, lisab ChatGPT tokeni muutumatul kujul igale päringule. Kohtle seda usaldamatusena ja teosta ise kõik standardsed ressursiserveri kontrollid: allkirja valideerimine, kasutades sinu volitusserveri avaldatud võtmeid (JWKS) ja väidet iss; ajaline kehtivus (exp, nbf; sihtrühm (aud või resource) ja nõutavad ulatused; seejärel oma ärireeglid. Ebaõnnestumisel: tagasta 401 ja päis WWW-Authenticate, mis taaskäivitab OAuth voo.
ChatGPT identifitseerimine kliendina
Et veenduda, et päring pärineb tõesti ChatGPT-lt, on olemas kaks meetodit. ChatGPT esitab TLS-ühenduse ajal OpenAI hallatava kliendisertifikaadi (mTLS). Kontrolli, et see ahelduks OpenAI avaldatud vahepealse asutusega, oleks kehtiv kliendi autentimiseks ja omaks dnsName väärtust mtls.prod.connectors.openai.com. Ära lukusta lehesertifikaadi sõrmejälge, kuna OpenAI võib seda rotatsiooni käigus muuta. Saad filtreerida ka avaldatud IP-aadresside vahemike põhjal. mTLS autentib ChatGPT; OAuth jätkab kasutaja autentimist.
ChatGPT ei toeta masinatevahelisi õigusi (client credentials, teenusekontod, JWT bearer kinnitused), kohandatud API-võtmeid ega kliendi pakutavaid mTLS-sertifikaate.
OpenAI turvapõhimõtted
- Vähimad õigused: Taotle ainult vajalikke ulatusi, salvestusruumi ja võrgujuurdepääsu.
- Selge nõusolek: Kasutajad peavad mõistma, millal nad kontot seovad või kirjutamisõigust annavad; kasuta hävitavate toimingute jaoks hosti kinnitusi.
- Sügavuskaitse: Eelda, et vihje süstimised ja pahatahtlikud sisendid jõuavad sinu serverini. Valideeri kõik sisendid serveripoolselt, isegi need, mille mudel on esitanud, ja pea alles auditeerimislogisid.
Andmete osas: lisa structuredContent ainult see, mida päring vajab, avalda säilitamispoliitika, austa kustutamistaotlusi ja maskeeri isikuandmed logides. Liidese osas: komponent töötab isoleeritud iframe’is range sisuturbepoliitika (CSP) all, ilma juurdepääsuta window.alert, window.prompt, window.confirm või navigator.clipboard. Toimingute osas: vii enne käivitamist läbi turvaülevaade, teavita korduvatest autentimisvigadest ja hoia sõltuvused ajakohasena.
Autentimise testimine
Alusta arenduskeskkonnast, mis väljastab lühiajalisi tokeneid, piira juurdepääsu usaldusväärsetele testijatele enne avalikustamist ja planeeri tühistamist, värskendamist ja ulatuste muutmist. Kohtle puuduvat või aegunud tokenit autentimise puudumisena, pakkudes kasulikku veateadet. MCP Inspectori seaded Auth võimaldavad sul OAuth voogu samm-sammult jälgida, et näha, kus see katkeb.
Peamised punktid
- Privaatsed andmed või kirjutamised: OAuth 2.1 vastavalt MCP spetsifikatsioonile, koos PKCE
S256-ga - Server avaldab kaitstud ressursi metaandmed ja vastab
401+WWW-Authenticate-ga - CIMD on eelistatud registreerimismeetod; DCR ja eelmääratud kliendid jäävad võimalikeks variantideks
- Sidumisliides:
securitySchemesiga tööriista kohta ja viga, mis sisaldab_meta["mcp/www_authenticate"] - Kontrolli iga tokenit igal päringul; mTLS identifitseerib ChatGPT, OAuth identifitseerib kasutaja