Overovanie totožnosti a bezpečnosť
Na tejto strane
Lekcia prepísaná 3. novembra 2026 na základe dokumentácie OpenAI o overovaní totožnosti a bezpečnosti a súkromí pre pluginy. Predchádzajúca verzia popisovala overovanie pomocou API kľúča a konfiguráciu
authv neexistujúcom manifeste; ChatGPT nedokáže predložiť vlastný API kľúč a namiesto toho nasleduje autorizačný tok definovaný v špecifikácii MCP (OAuth 2.1). Zdroje: Authentication · Security & Privacy.
Kto sa musí overiť
Mnohé servery MCP môžu pracovať anonymne v režime len na čítanie. Akýkoľvek server, ktorý však sprístupňuje údaje špecifické pre používateľa alebo vykonáva operácie zápisu, musí používateľa overiť. Autorizačná zmluva sa riadi špecifikáciou MCP, ktorá je identická v ChatGPT aj Codex: tok OAuth 2.1 zahŕňajúci troch aktérov.
- Server zdrojov: Tvoj server MCP, ktorý sprístupňuje nástroje a overuje prístupový token pri každej požiadavke.
- Autorizačný server: Tvoj poskytovateľ identity, ktorý vydáva tokeny a publikuje svoje metadáta objavovania.
- Klient: Hostiteľ OpenAI (ChatGPT alebo Codex), konajúci v mene používateľa.
OpenAI dôrazne odporúča spoliehať sa na zavedeného poskytovateľa identity namiesto budovania overovania od nuly; ich dokumentácia konkrétne odkazuje na služby Auth0 a Stytch.
Čo vyžaduje špecifikácia
Metadáta chráneného zdroja. Tvoj server MCP musí publikovať dokument, napríklad na adrese https://your-mcp.example.com/.well-known/oauth-protected-resource, obsahujúci jeho kanonický identifikátor (resource), jeho autorizačné servery (authorization_servers) a voliteľne podporované rozsahy (scopes_supported). Keď dorazí požiadavka bez platného overenia, server musí odpovedať stavom 401 Unauthorized a hlavičkou ukazujúcou na tento dokument:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Metadáta autorizačného servera, umiestnené na /.well-known/oauth-authorization-server alebo /.well-known/openid-configuration, musia obsahovať vydavateľa (issuer), koncové body pre autorizáciu a tokeny a code_challenge_methods_supported obsahujúce S256. Bez toho je server MCP nepodporovaný, keďže PKCE je povinné.
Parameter resource od začiatku do konca. ChatGPT pridáva resource=… do požiadaviek na autorizáciu aj tokeny. Tvoj autorizačný server musí túto hodnotu skopírovať do tokenu (často ako nárok aud) a tvoj server MCP musí odmietnuť akýkoľvek token, ktorý nebol vydaný špecificky preňho.
Ako sa ChatGPT registruje ako klient
Existujú tri spôsoby. Uprednostňovanou metódou je CIMD (Client ID Metadata Documents): ChatGPT používa URL adresu dokumentu s metadátami hosteného na HTTPS ako client_id, ktorý si tvoj autorizačný server prečíta. Povoľ to publikovaním client_id_metadata_document_supported: true. ChatGPT podporuje dve metódy overovania na koncovom bode tokenu: none (verejný klient chránený pomocou PKCE) a private_key_jwt (podpísané tvrdenie overiteľné pomocou verejného kľúča publikovaného ChatGPT). Dynamická registrácia klienta (DCR) zostáva možná, ak publikuješ registration_endpoint: ChatGPT sa zaregistruje raz na pripojenie a tohto klienta opakovane používa. Tretiou možnosťou je preddefinovaný klient OAuth.
Pokiaľ ide o presmerovania, skopíruj presnú URI adresu zobrazenú na stránke správy servera MCP v ChatGPT do zoznamu povolených adries svojho autorizačného servera. Táto URI závisí od podpory identifikácie vydavateľa (RFC 9207, parameter iss vrátený v každej odpovedi na autorizáciu).
Tok viditeľný pre používateľa
- ChatGPT si prečíta metadáta chráneného zdroja tvojho servera.
- Identifikuje sa ako klient OAuth (prostredníctvom CIMD, DCR alebo preddefinovaného klienta).
- Pri prvom volaní chráneného nástroja iniciuje tok autorizačného kódu + PKCE: používateľ sa prihlási a udelí súhlas s požadovanými rozsahmi.
- ChatGPT vymení kód za token a pripojí ho k následným požiadavkám MCP (
Authorization: Bearer …). - Tvoj server overí token pri každej požiadavke pred vykonaním nástroja.
Deklarovanie, ktoré nástroje vyžadujú účet
ChatGPT zobrazí rozhranie na prepojenie účtu iba vtedy, ak tvoj server signalizuje, že OAuth je dostupné alebo požadované. To si vyžaduje obe časti: metadáta a chybu počas behu.
Po prvé, metadáta: každý nástroj deklaruje svoju politiku v _meta.securitySchemes. noauth znamená, že ho možno volať anonymne, zatiaľ čo oauth2 vyžaduje token s uvedenými rozsahmi. Deklarovanie oboch signalizuje, že nástroj môže začať bez účtu, ale prepojenie odomkne viac funkcií. Deklaruj to pre každý nástroj, aj keď sa celý server riadi rovnakou politikou.
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
}
);
Po druhé, chyba počas behu: keď token chýba alebo je neplatný, nástroj musí vrátiť výsledok chyby obsahujúci _meta["mcp/www_authenticate"] s parametrami error a error_description. Tento obsah je tým, čo skutočne spúšťa prihlasovacie rozhranie. verifyToken je tvoja funkcia na overovanie; SDK pre MCP v Pythone a TypeScrite poskytujú pomocné funkcie na jej napísanie.
Overovanie každého tokenu
Akonáhle sa tok dokončí, ChatGPT pripojí token tak, ako je, ku každej požiadavke. Pokladaj ho za nedôveryhodný a vykonaj všetky štandardné overenia servera zdrojov sám: validáciu podpisu pomocou kľúčov publikovaných tvojím autorizačným serverom (JWKS) a nároku iss; časovú platnosť (exp, nbf); cieľového príjemcu (aud alebo resource) a požadované rozsahy; po ktorých nasledujú tvoje vlastné obchodné pravidlá. Pri zlyhaní: vráť 401 a hlavičku WWW-Authenticate, čo reštartuje tok OAuth.
Identifikácia ChatGPT ako klienta
Na overenie, že požiadavka skutočne pochádza od ChatGPT, existujú dve metódy. ChatGPT predkladá počas pripojenia TLS klientsky certifikát spravovaný spoločnosťou OpenAI (mTLS). Over, či tvorí reťazec s intermediárnou autoritou publikovanou spoločnosťou OpenAI, či je platný na overovanie klienta a či má dnsName mtls.prod.connectors.openai.com. Nepripínaj odtlačok listového certifikátu, keďže OpenAI ho môže rotovať. Môžeš tiež filtrovať na základe publikovaných rozsahov IP adries. mTLS overuje ChatGPT; OAuth pokračuje v overovaní používateľa.
ChatGPT nepodporuje oprávnenia stroj-stroj (client credentials, servisné účty, JWT bearer tvrdenia), vlastné API kľúče ani klientske certifikáty mTLS.
Bezpečnostné zásady OpenAI
- Najmenšie privilégium: Požaduj iba rozsahy, úložisko a sieťový prístup, ktoré sú nevyhnutné.
- Explicitný súhlas: Používatelia musia chápať, kedy prepojujú účet alebo udeľujú prístup na zápis; na deštruktívne akcie používaj potvrdenia hostiteľa.
- Obrana do hĺbky: Predpokladaj, že injekcie promptov a škodlivé vstupy sa dostanú na tvoj server. Validuj všetky vstupy na strane servera, aj tie poskytnuté modelom, a udržiavaj auditné záznamy.
Pokiaľ ide o údaje: zahrň do structuredContent iba to, čo požiadavka potrebuje, publikuj zásady uchovávania, rešpektuj požiadavky na vymazanie a maskuj osobné údaje v záznamoch. Pokiaľ ide o rozhranie: komponent beží v izolovanom iframe pod prísnou zásadou zabezpečenia obsahu (CSP), bez prístupu k window.alert, window.prompt, window.confirm alebo navigator.clipboard. Pokiaľ ide o operácie: pred spustením vykonaj bezpečnostnú kontrolu, upozorni na opakované zlyhania overovania a udržiavaj závislosti aktuálne.
Testovanie overovania
Začni s vývojovým tenantom, ktorý vydáva krátkodobé tokeny, obmedz prístup na dôveryhodných testerov pred otvorením pre verejnosť a plánuj odvolávanie, obnovovanie a zmeny rozsahov. Chýbajúci alebo expirovaný token považuj za chýbajúce overenie a poskytni užitočnú chybovú správu. Nastavenia Auth v MCP Inspector ti umožňujú krok za krokom sledovať tok OAuth a zistiť, kde sa pokazí.
Kľúčové poznatky
- Súkromné údaje alebo zápisy: OAuth 2.1 podľa špecifikácie MCP, s PKCE
S256 - Server publikuje metadáta chráneného zdroja a odpovedá stavom
401+WWW-Authenticate - CIMD je uprednostňovaná metóda registrácie; DCR a preddefinovaní klienti zostávajú možnosťami
- Rozhranie prepojenia:
securitySchemespre každý nástroj a chyba obsahujúca_meta["mcp/www_authenticate"] - Over každý token pri každej požiadavke; mTLS identifikuje ChatGPT, OAuth identifikuje používateľa