Godkendelse og sikkerhed
På denne side
Lektionen er omskrevet den 3. november 2026 baseret på OpenAIs dokumentation om Authentication og Security & Privacy for plugins. Den tidligere version beskrev API-nøgle-godkendelse og en
auth-konfiguration i et ikke-eksisterende manifest; ChatGPT kan ikke præsentere en brugerdefineret API-nøgle og følger i stedet autorisationsflowet defineret i MCP-specifikationen (OAuth 2.1). Kilder: Authentication · Security & Privacy.
Hvem skal godkendes
Mange MCP-servere kan køre anonymt i skrivebeskyttet tilstand. Enhver server, der eksponerer brugerspecifikke data eller udfører skriveoperationer, skal dog godkende brugeren. Autorisationskontrakten følger MCP-specifikationen, som er identisk i ChatGPT og Codex: et OAuth 2.1-flow, der involverer tre aktører.
- Ressourceserveren: Din MCP-server, som eksponerer værktøjer og verificerer adgangstokenet ved hver anmodning.
- Autorisationsserveren: Din identitetsudbyder, som udsteder tokens og offentliggør sine opdagelsesmetadata.
- Klienten: OpenAI-værten (ChatGPT eller Codex), der handler på brugerens vegne.
OpenAI anbefaler stærkt at stole på en etableret identitetsudbyder frem for at bygge godkendelse fra bunden; deres dokumentation peger specifikt på Auth0 og Stytch.
Hvad specifikationen kræver
Metadata for beskyttede ressourcer. Din MCP-server skal offentliggøre et dokument, f.eks. på https://your-mcp.example.com/.well-known/oauth-protected-resource, der indeholder dens kanoniske identifikator (resource), dens autorisationsservere (authorization_servers) og valgfrit de understøttede scopes (scopes_supported). Når en anmodning ankommer uden gyldig godkendelse, skal serveren svare med 401 Unauthorized og en header, der peger på dette dokument:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Metadata for autorisationsserver, placeret på /.well-known/oauth-authorization-server eller /.well-known/openid-configuration, skal inkludere udstederen (issuer), autorisations- og token-endpoints samt code_challenge_methods_supported, der indeholder S256. Uden dette er MCP-serveren ikke understøttet, da PKCE er obligatorisk.
Parameteren resource end-to-end. ChatGPT tilføjer resource=… til autorisations- og token-anmodninger. Din autorisationsserver skal kopiere dette ind i tokenet (ofte som aud-claimet), og din MCP-server skal afvise ethvert token, der ikke er udstedt specifikt til den.
Hvordan ChatGPT registreres som klient
Tre metoder eksisterer sideløbende. Den foretrukne metode er CIMD (Client ID Metadata Documents): ChatGPT bruger URL’en til et HTTPS-hostet metadatadokument som client_id, som din autorisationsserver læser. Aktiver dette ved at offentliggøre client_id_metadata_document_supported: true. ChatGPT understøtter to godkendelsesmetoder ved token-endpointet: none (offentlig klient beskyttet af PKCE) og private_key_jwt (signeret assertion, der kan verificeres med den offentlige nøgle offentliggjort af ChatGPT). Dynamisk klientregistrering (DCR) forbliver mulig, hvis du offentliggør et registration_endpoint: ChatGPT registrerer én gang pr. forbindelse og genbruger denne klient. En foruddefineret OAuth-klient er den tredje mulighed.
Hvad angår omdirigeringer, skal du kopiere den nøjagtige URI, der vises på siden for MCP-serverstyring i ChatGPT, ind i din autorisationsservers tilladelsesliste. Denne URI afhænger af understøttelse af Issuer Identification (RFC 9207, parameteren iss, der returneres i hvert autorisationssvar).
Brugerens flow
- ChatGPT læser din servers metadata for beskyttede ressourcer.
- Den identificerer sig selv som en OAuth-klient (via CIMD, DCR eller en foruddefineret klient).
- Ved det første kald til et beskyttet værktøj initierer den authorization code + PKCE-flowet: brugeren logger ind og giver samtykke til de anmodede scopes.
- ChatGPT udveksler koden mod et token og vedhæfter det til efterfølgende MCP-anmodninger (
Authorization: Bearer …). - Din server verificerer tokenet ved hver anmodning, før værktøjet udføres.
Erklæring af hvilke værktøjer, der kræver en konto
ChatGPT viser kun sin grænseflade til kontolinking, hvis din server signalerer, at OAuth er tilgængelig eller påkrævet. Dette kræver begge dele: metadata og en runtime-fejl.
Først metadata: Hvert værktøj erklærer sin politik i _meta.securitySchemes. noauth betyder, at det kan kaldes anonymt, mens oauth2 kræver et token med de angivne scopes. At erklære begge dele signalerer, at værktøjet kan starte uden en konto, men linking låser op for mere funktionalitet. Erklær dette pr. værktøj, selvom hele serveren følger den samme politik.
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
}
);
Dernæst runtime-fejlen: Når tokenet mangler eller er ugyldigt, skal værktøjet returnere et fejlresultat, der indeholder _meta["mcp/www_authenticate"] med parametrene error og error_description. Dette indhold er det, der faktisk udløser login-grænsefladen. verifyToken er din verifikationsfunktion; Python- og TypeScript-MCP-SDK’erne tilbyder hjælpere til at skrive den.
Verificering af hvert token
Når flowet er gennemført, vedhæfter ChatGPT tokenet, som det er, til hver anmodning. Behandl det som ikke-betroet og udfør alle standardverifikationer for ressourceserveren selv: signaturvalidering ved hjælp af nøgler offentliggjort af din autorisationsserver (JWKS) og iss-claimet; tidsmæssig gyldighed (exp, nbf); målgruppe (aud eller resource) og påkrævede scopes; efterfulgt af dine egne forretningsregler. Ved fejl: returner 401 og en WWW-Authenticate-header, hvilket genstarter OAuth-flowet.
Identificering af ChatGPT som klienten
For at verificere, at en anmodning rent faktisk kommer fra ChatGPT, findes der to metoder. ChatGPT præsenterer et OpenAI-administreret klientcertifikat under TLS-forbindelsen (mTLS). Verificer, at det kæder til den mellemliggende myndighed offentliggjort af OpenAI, er gyldigt til klientgodkendelse, og har dnsName’et mtls.prod.connectors.openai.com. Pin ikke fingerprintet på leaf-certifikatet, da OpenAI kan rotere det. Du kan også filtrere baseret på offentliggjorte IP-adresseområder. mTLS godkender ChatGPT; OAuth fortsætter med at godkende brugeren.
ChatGPT understøtter ikke maskine-til-maskine-tilladelser (client credentials, servicekonti, JWT bearer-assertions), brugerdefinerede API-nøgler eller klientleverede mTLS-certifikater.
OpenAIs sikkerhedsprincipper
- Mindste privilegium: Anmod kun om de scopes, den lagring og netværksadgang, der er nødvendig.
- Eksplicit samtykke: Brugere skal forstå, hvornår de linker en konto eller giver skriveadgang; brug værtsbekræftelser for destruktive handlinger.
- Forsvar i dybden: Antag, at prompt-injektioner og ondsindede input vil nå din server. Valider alle input på serversiden, selv dem leveret af modellen, og før revisionslogfiler.
Hvad angår data: Inkluder kun det, anmodningen har brug for, i structuredContent, offentliggør en opbevaringspolitik, overhold sletningsanmodninger og maskér personlige data i logfiler. Hvad angår grænsefladen: Komponenten kører i en isoleret iframe under en streng Content Security Policy uden adgang til window.alert, window.prompt, window.confirm eller navigator.clipboard. Hvad angår operationer: Udfør en sikkerhedsgennemgang før lancering, varsling ved gentagne godkendelsesfejl, og hold afhængigheder opdateret.
Test af godkendelse
Start med en udviklingstenant, der udsteder kortlivede tokens, begræns adgangen til betroede testere, før du åbner op, og planlæg for tilbagekaldelse, opdatering og ændringer af scopes. Behandl et manglende eller udløbet token som manglende godkendelse og giv en hjælpsom fejlmeddelelse. Indstillingen Auth i MCP Inspector giver dig mulighed for at spore OAuth-flowet trin for trin for at se, hvor det bryder sammen.
Vigtige pointer
- Private data eller skrivning: OAuth 2.1 ifølge MCP-specifikationen med PKCE
S256 - Serveren offentliggør metadata for beskyttede ressourcer og svarer med
401+WWW-Authenticate - CIMD er den foretrukne registreringsmetode; DCR og foruddefinerede klienter forbliver muligheder
- Linking-grænseflade:
securitySchemespr. værktøj og en fejl, der indeholder_meta["mcp/www_authenticate"] - Verificer hvert token ved hver anmodning; mTLS identificerer ChatGPT, OAuth identificerer brugeren