Authenticatie en beveiliging
Op deze pagina
Les herschreven op 3 november 2026 op basis van de documentatie van OpenAI over Authenticatie en Beveiliging en privacy voor plug-ins. De vorige versie beschreef authenticatie via API-sleutels en een
auth-configuratie in een niet-bestaand manifest; ChatGPT kan geen aangepaste API-sleutel presenteren en volgt in plaats daarvan de autorisatiestroom zoals gedefinieerd in de MCP-specificatie (OAuth 2.1). Bronnen: Authentication · Security & Privacy.
Wie moet zich authenticeren
Veel MCP-servers kunnen anoniem werken in een read-only modus. Elke server die echter gebruikersspecifieke gegevens onthult of schrijfbewerkingen uitvoert, moet de gebruiker authenticeren. Het autorisatiecontract volgt de MCP-specificatie, die identiek is in ChatGPT en Codex: een OAuth 2.1-stroom met drie actoren.
- De resource server: Uw MCP-server, die tools beschikbaar stelt en bij elk verzoek het toegangstoken verifieert.
- De authorization server: Uw identiteitsprovider, die tokens uitgeeft en zijn discoverymetagegevens publiceert.
- De client: De OpenAI-host (ChatGPT of Codex), die namens de gebruiker handelt.
OpenAI raadt ten zeerste aan om een gevestigde identiteitsprovider te gebruiken in plaats van authenticatie vanaf nul te bouwen; hun documentatie wijst specifiek op Auth0 en Stytch.
Wat de specificatie vereist
Protected Resource Metadata. Uw MCP-server moet een document publiceren, bijvoorbeeld op https://your-mcp.example.com/.well-known/oauth-protected-resource, dat de canonieke identifier (resource), de autorisatieservers (authorization_servers) en optioneel de ondersteunde scopes (scopes_supported) bevat. Wanneer een verzoek binnenkomt zonder geldige authenticatie, moet de server antwoorden met 401 Unauthorized en een header die naar dit document verwijst:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Authorization Server Metadata, gelegen op /.well-known/oauth-authorization-server of /.well-known/openid-configuration, moet de issuer (issuer), autorisatie- en token-eindpunten bevatten, evenals code_challenge_methods_supported met daarin S256. Zonder dit wordt de MCP-server niet ondersteund, aangezien PKCE verplicht is.
De resource-parameter end-to-end. ChatGPT voegt resource=… toe aan autorisatie- en tokenverzoeken. Uw autorisatieserver moet deze kopiëren naar het token (vaak als de aud-claim), en uw MCP-server moet elk token afwijzen dat niet specifiek voor deze server is uitgegeven.
Hoe ChatGPT zich registreert als client
Drie methoden bestaan naast elkaar. De voorkeursmethode is CIMD (Client ID Metadata Documents): ChatGPT gebruikt de URL van een op HTTPS gehost metadocument als client_id, die uw autorisatieserver uitleest. Schakel dit in door client_id_metadata_document_supported: true te publiceren. ChatGPT ondersteunt twee authenticatiemethoden bij het token-eindpunt: none (publieke client beschermd door PKCE) en private_key_jwt (ondertekende assertie verifieerbaar met de publieke sleutel gepubliceerd door ChatGPT). Dynamic Client Registration (DCR) blijft mogelijk als u een registration_endpoint publiceert: ChatGPT registreert zich eenmaal per verbinding en hergebruikt die client. Een vooraf gedefinieerde OAuth-client is de derde optie.
Wat omleidingen betreft: kopieer de exacte URI die wordt weergegeven op de beheerpagina voor MCP-servers in ChatGPT naar de allowlist van uw autorisatieserver. Deze URI is afhankelijk van ondersteuning voor Issuer Identification (RFC 9207, de iss-parameter die in elke autorisatie-respons wordt teruggegeven).
De stroom voor de gebruiker
- ChatGPT leest de protected resource metadata van uw server.
- Het identificeert zichzelf als een OAuth-client (via CIMD, DCR of een vooraf gedefinieerde client).
- Bij de eerste aanroep van een beveiligde tool start het de authorization code + PKCE-stroom: de gebruiker logt in en stemt in met de gevraagde scopes.
- ChatGPT wisselt de code in voor een token en voegt dit toe aan daaropvolgende MCP-verzoeken (
Authorization: Bearer …). - Uw server verifieert het token bij elk verzoek voordat de tool wordt uitgevoerd.
Aangeven welke tools een account vereisen
ChatGPT toont alleen de interface voor accountkoppeling als uw server aangeeft dat OAuth beschikbaar of vereist is. Dit vereist beide helften: metadata en een runtime-fout.
Ten eerste de metadata: elke tool declareert zijn beleid in _meta.securitySchemes. noauth betekent anoniem aanroepbaar, terwijl oauth2 een token vereist met de aangegeven scopes. Beide declareren geeft aan dat de tool kan starten zonder account, maar dat koppeling meer functionaliteit ontsluit. Declareer dit per tool, zelfs als de hele server hetzelfde beleid volgt.
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
}
);
Ten tweede de runtime-fout: wanneer het token ontbreekt of ongeldig is, moet de tool een foutresultaat retourneren dat _meta["mcp/www_authenticate"] bevat met de parameters error en error_description. Deze inhoud is wat daadwerkelijk de login-interface activeert. verifyToken is uw verificatiefunctie; de Python- en TypeScript-MCP-SDK’s bieden hulpmiddelen om deze te schrijven.
Elk token verifiëren
Zodra de stroom is voltooid, voegt ChatGPT het token ongewijzigd toe aan elk verzoek. Beschouw het als niet-vertrouwd en voer zelf alle standaardverificaties voor een resource server uit: validatie van de handtekening met behulp van sleutels die door uw autorisatieserver zijn gepubliceerd (JWKS) en de iss-claim; tijdsgeldigheid (exp, nbf); doelgroep (aud of resource) en vereiste scopes; gevolgd door uw eigen bedrijfsregels. Bij mislukking: retourneer 401 en een WWW-Authenticate-header, wat de OAuth-stroom opnieuw start.
ChatGPT identificeren als de client
Om te verifiëren dat een verzoek daadwerkelijk van ChatGPT komt, bestaan er twee methoden. ChatGPT presenteert een door OpenAI beheerd clientcertificaat tijdens de TLS-verbinding (mTLS). Verifieer dat dit certificaat een keten vormt met de tussenliggende autoriteit die door OpenAI is gepubliceerd, geldig is voor clientauthenticatie en de dnsName mtls.prod.connectors.openai.com heeft. Pin niet de vingerafdruk van het leaf-certificaat vast, aangezien OpenAI dit kan roteren. U kunt ook filteren op basis van gepubliceerde IP-adresbereiken. mTLS authenticatieert ChatGPT; OAuth authenticatieert de gebruiker.
ChatGPT ondersteunt geen machine-to-machine-machtigingen (client credentials, serviceaccounts, JWT bearer-asserties), aangepaste API-sleutels of door de client verstrekte mTLS-certificaten.
De beveiligingsprincipes van OpenAI
- Minste privilege: Vraag alleen de scopes, opslag en netwerktegang die nodig zijn.
- Expliciete toestemming: Gebruikers moeten begrijpen wanneer ze een account koppelen of schrijftoegang verlenen; gebruik hostbevestigingen voor destructieve acties.
- Verdediging in diepte: Ga ervan uit dat prompt-injecties en kwaadaardige inputs uw server bereiken. Valideer alle inputs server-side, zelfs die door het model worden geleverd, en houd auditlogs bij.
Wat gegevens betreft: neem alleen op wat het verzoek nodig heeft in structuredContent, publiceer een bewaarbeleid, eer verwijderingsverzoeken en maskeer persoonlijke gegevens in logs. Wat de interface betreft: de component draait in een geïsoleerde iframe onder een strikt Content Security Policy, zonder toegang tot window.alert, window.prompt, window.confirm of navigator.clipboard. Wat operaties betreft: voer een beveiligingsreview uit voor de lancering, waarschuw bij herhaalde authenticatiefouten en houd afhankelijkheden up-to-date.
Authenticatie testen
Begin met een development-tenant die kortlopende tokens uitgeeft, beperk de toegang tot vertrouwde testers voordat u deze opent, en plan voor intrekking, vernieuwing en wijzigingen in scopes. Beschouw een ontbrekend of verlopen token als een gebrek aan authenticatie en bied een behulpzaam foutbericht. De instellingen Auth in MCP Inspector stellen u in staat om de OAuth-stroom stap voor stap te traceren om te zien waar deze vastloopt.
Belangrijkste punten
- Privégegevens of schrijfbewerkingen: OAuth 2.1 volgens de MCP-specificatie, met PKCE
S256 - De server publiceert protected resource metadata en antwoordt met
401+WWW-Authenticate - CIMD is de voorkeursregistratiemethode; DCR en vooraf gedefinieerde clients blijven opties
- Koppelinterface:
securitySchemesper tool en een fout met_meta["mcp/www_authenticate"] - Verifieer elk token bij elk verzoek; mTLS identificeert ChatGPT, OAuth identificeert de gebruiker