Hitelesítés és biztonság
Ezen az oldalon
- Kinek kell hitelesítenie magát
- Amit a specifikáció előír
- Hogyan regisztrál a ChatGPT kliensként
- A felhasználó által látható folyamat
- Annak deklarálása, mely eszközök igényelnek fiókot
- Minden token ellenőrzése
- A ChatGPT azonosítása kliensként
- Az OpenAI biztonsági alapelvei
- A hitelesítés tesztelése
- Főbb megállapítások
A leckét 2026. november 3-án írtuk át az OpenAI Hitelesítés és Biztonság és adatvédelem bővítmény-dokumentációja alapján. A korábbi verzió API-kulcs alapú hitelesítést és egy nem létező manifest fájlban található
authkonfigurációt írt le; a ChatGPT nem képes egyéni API-kulcsot megjeleníteni, ehelyett az MCP specifikáció által meghatározott jogosultsági folyamatot (OAuth 2.1) követi. Források: Hitelesítés · Biztonság és adatvédelem.
Kinek kell hitelesítenie magát
Számos MCP szerver működhet névtelenül, csak olvasási módban. Ugyanakkor minden olyan szervernek, amely felhasználóspecifikus adatokat tesz közzé vagy írási műveleteket hajt végre, hitelesítenie kell a felhasználót. A jogosultsági szerződés az MCP specifikációt követi, amely a ChatGPT és a Codex esetében is azonos: egy OAuth 2.1 folyamat, amely három szereplőt érint.
- Az erőforrás-szerver: A te MCP szervered, amely eszközöket tesz közzé, és minden kérésnél ellenőrzi a hozzáférési tokent.
- A jogosultsági szerver: A te személyazonosság-kezelőd (Identity Provider), amely tokeneket állít ki és közzéteszi a felderítési metaadatait.
- A kliens: Az OpenAI hoszt (ChatGPT vagy Codex), amely a felhasználó nevében jár el.
Az OpenAI határozottan javasolja bevált személyazonosság-kezelő igénybevételét a hitelesítés nulláról történő felépítése helyett; dokumentációjuk kifejezetten az Auth0-t és a Stytchet emeli ki.
Amit a specifikáció előír
Védett erőforrás metaadatai. Az MCP szerverednek közzé kell tennie egy dokumentumot, például a https://your-mcp.example.com/.well-known/oauth-protected-resource címen, amely tartalmazza a kanonikus azonosítóját (resource), a jogosultsági szervereit (authorization_servers), és opcionálisan a támogatott hatóköröket (scopes_supported). Ha egy kérés érvényes hitelesítés nélkül érkezik, a szervernek 401 Unauthorized válasszal és egy erre a dokumentumra mutató fejléccel kell válaszolnia:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
A jogosultsági szerver metaadatai, amelyek a /.well-known/oauth-authorization-server vagy a /.well-known/openid-configuration útvonalon találhatók, tartalmazniuk kell a kibocsátót (issuer), a hitelesítési és token végpontokat, valamint a code_challenge_methods_supported mezőt, amelynek tartalmaznia kell az S256 értéket. Enélkül az MCP szerver nem támogatott, mivel a PKCE kötelező.
A resource paraméter végig a folyamatban. A ChatGPT hozzáadja a resource=… paramétert a hitelesítési és token kérésekhez. A jogosultsági szerverednek ezt másolnia kell a tokenbe (gyakran az aud claimként), az MCP szerverednek pedig el kell utasítania minden olyan tokent, amelyet nem kifejezetten neki állítottak ki.
Hogyan regisztrál a ChatGPT kliensként
Három módszer létezik egyszerre. Az előnyben részesített módszer a CIMD (Client ID Metadata Documents): a ChatGPT egy HTTPS-en hosztolt metaadat-dokumentum URL-jét használja client_id-ként, amelyet a jogosultsági szervered olvas be. Ezt úgy engedélyezed, hogy közzéteszed a client_id_metadata_document_supported: true értéket. A ChatGPT két hitelesítési módszert támogat a token végponton: none (nyilvános kliens, amelyet PKCE véd) és private_key_jwt (aláírt állítás, amely a ChatGPT által közzétett nyilvános kulccsal ellenőrizhető). A Dinamikus Kliens Regisztráció (DCR) továbbra is lehetséges, ha közzéteszel egy registration_endpoint-ot: a ChatGPT regisztrál egyszer kapcsolatonként, és újrahasználja azt a klienst. Egy előre definiált OAuth kliens a harmadik lehetőség.
Az átirányítások tekintetében másold be pontosan azt az URI-t, amely a ChatGPT MCP szerver kezelőoldalán megjelenik, a jogosultsági szervered engedélyezési listájába. Ez az URI függ a kibocsátó azonosításának támogatásától (RFC 9207, az iss paraméter, amely minden hitelesítési válaszban visszatér).
A felhasználó által látható folyamat
- A ChatGPT beolvassa a szervered védett erőforrás metaadatait.
- Azonosítja magát OAuth kliensként (CIMD, DCR vagy egy előre definiált kliens segítségével).
- Egy védett eszköz első hívásakor elindítja az authorization code + PKCE folyamatot: a felhasználó bejelentkezik és jóváhagyja a kért hatóköröket.
- A ChatGPT beváltja a kódot tokenre, és csatolja azt a későbbi MCP kérésekhez (
Authorization: Bearer …). - A szervered minden kérésnél ellenőrzi a tokent, mielőtt végrehajtaná az eszközt.
Annak deklarálása, mely eszközök igényelnek fiókot
A ChatGPT csak akkor jeleníti meg a fiók összekapcsolására szolgáló felületet, ha a szervered jelzi, hogy az OAuth elérhető vagy kötelező. Ehhez mindkét félre szükség van: metaadatokra és egy futásidejű hibára.
Először a metaadatok: minden eszköz deklarálja a saját szabályzatát a _meta.securitySchemes mezőben. A noauth azt jelenti, hogy névtelenül hívható, míg az oauth2 tokent igényel a jelzett hatókörökkel. Mindkettő deklarálása azt jelzi, hogy az eszköz fiók nélkül is elindítható, de az összekapcsolás több funkciót old fel. Deklaráld ezt eszközönként, még akkor is, ha az egész szerver ugyanazt a szabályzatot követi.
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
}
);
Másodszor a futásidejű hiba: ha a token hiányzik vagy érvénytelen, az eszköznek egy olyan hibaeredményt kell visszaadnia, amely tartalmazza a _meta["mcp/www_authenticate"] mezőt az error és error_description paraméterekkel. Ez a tartalom az, ami valójában kiváltja a bejelentkezési felületet. A verifyToken a te ellenőrző függvényed; a Python és TypeScript MCP SDK-k segédfüggvényeket biztosítanak ennek megírásához.
Minden token ellenőrzése
Miután a folyamat lezárult, a ChatGPT változatlanul csatolja a tokent minden kéréshez. Kezeld bizalmatlanként, és végezd el saját magad az összes szabványos erőforrás-szerver ellenőrzést: aláírás-ellenőrzés a jogosultsági szervered által közzétett kulcsok (JWKS) és az iss claim segítségével; időbeli érvényesség (exp, nbf); címzett (aud vagy resource) és szükséges hatókörök; ezt követően pedig a saját üzleti szabályaidat. Hiba esetén: adj vissza 401 státuszt és egy WWW-Authenticate fejlécet, ami újraindítja az OAuth folyamatot.
A ChatGPT azonosítása kliensként
Annak ellenőrzésére, hogy egy kérés valóban a ChatGPT-től származik, két módszer létezik. A ChatGPT egy OpenAI által kezelt kliens tanúsítványt mutat be a TLS kapcsolat során (mTLS). Ellenőrizd, hogy ez a tanúsítvány az OpenAI által közzétett közbenső hatósághoz láncolódik, érvényes-e kliens hitelesítésre, és rendelkezik-e a dnsName értékkel: mtls.prod.connectors.openai.com. Ne rögzítsd a levéltanúsítvány ujjlenyomatát, mivel az OpenAI forgathatja azt. Szűrhetsz a közzétett IP-címtartományok alapján is. Az mTLS a ChatGPT-t hitelesíti; az OAuth továbbra is a felhasználót hitelesíti.
A ChatGPT nem támogatja a gép-gép közötti jogosultságokat (client credentials, szolgáltatásfiókok, JWT bearer állítások), egyéni API-kulcsokat vagy a kliens által biztosított mTLS tanúsítványokat.
Az OpenAI biztonsági alapelvei
- Legkisebb jogosultság elve: Csak a szükséges hatóköröket, tárhelyet és hálózati hozzáférést kérd.
- Kifejezett hozzájárulás: A felhasználóknak tisztában kell lenniük azzal, mikor kapcsolnak össze fiókot vagy adnak írási hozzáférést; használj hoszt megerősítéseket romboló műveletekhez.
- Többrétegű védelem: Feltételezd, hogy a prompt-beszúrások és a rosszindulatú bemenetek elérik a szerveredet. Ellenőrizd az összes bemenetet szerveroldalon, még azokat is, amelyeket a modell biztosít, és vezess naplókat.
Az adatok tekintetében: csak azt add hozzá a structuredContent-hez, amire a kérésnek szüksége van, tegyél közzé egy megőrzési szabályzatot, teljesítsd a törlési kéréseket, és maszkold a személyes adatokat a naplókban. A felület tekintetében: a komponens egy elkülönített iframe-ben fut szigorú Content Security Policy alatt, nincs hozzáférése a window.alert, window.prompt, window.confirm vagy a navigator.clipboard elemekhez. A műveletek tekintetében: végezz biztonsági felülvizsgálatot az indítás előtt, figyelmeztess ismétlődő hitelesítési hibák esetén, és tartsd naprakészen a függőségeket.
A hitelesítés tesztelése
Kezdd egy fejlesztői bérlővel, amely rövid élettartamú tokeneket állít ki, korlátozd a hozzáférést megbízható tesztelők számára, mielőtt megnyitnád, és tervezz a visszavonásra, frissítésre és hatókör-változtatásokra. A hiányzó vagy lejárt tokent hitelesítés hiányaként kezeld, és adj vissza egy segítőkész hibaüzenetet. Az MCP Inspector Auth beállításai lehetővé teszik az OAuth folyamat lépésről lépésre történő nyomon követését, hogy lásd, hol szakad meg.
Főbb megállapítások
- Privát adatok vagy írás: OAuth 2.1 az MCP specifikáció szerint, PKCE
S256használatával - A szerver közzéteszi a védett erőforrás metaadatait, és
401+WWW-Authenticateválasszal válaszol - A CIMD az előnyben részesített regisztrációs módszer; a DCR és az előre definiált kliensek továbbra is opciók
- Összekapcsolási felület:
securitySchemeseszközönként és egy hiba, amely tartalmazza a_meta["mcp/www_authenticate"]mezőt - Ellenőrizd minden tokent minden kérésnél; az mTLS azonosítja a ChatGPT-t, az OAuth a felhasználót