Autentifikacija i sigurnost
Na ovoj stranici
Lekcija je ponovno napisana 3. studenog 2026. na temelju OpenAI-jeve dokumentacije o autentifikaciji te sigurnosti i privatnosti za dodatke. Prethodna verzija opisivala je autentifikaciju API ključem i konfiguraciju
authu manifestu koji ne postoji; ChatGPT ne može prikazati prilagođeni API ključ, već slijedi tijek autorizacije definiran u MCP specifikaciji (OAuth 2.1). Izvori: Authentication · Security & Privacy.
Tko se mora autentificirati
Mnogi MCP poslužitelji mogu raditi u načinu samo za čitanje anonimno. Međutim, svaki poslužitelj koji izlaže podatke specifične za korisnika ili izvodi operacije pisanja mora autentificirati korisnika. Ugovor o autorizaciji slijedi MCP specifikaciju, koja je identična u ChatGPT-u i Codexu: tijek OAuth 2.1 koji uključuje tri aktera.
- Poslužitelj resursa: Tvoj MCP poslužitelj, koji izlaže alate i provjerava pristupni token za svaki zahtjev.
- Poslužitelj za autorizaciju: Tvoj davatelj identiteta, koji izdaje tokene i objavljuje svoje metapodatke otkrivanja.
- Klijent: OpenAI domaćin (ChatGPT ili Codex), koji djeluje u ime korisnika.
OpenAI snažno preporučuje oslanjanje na etabliranog davatelja identiteta umjesto izrade autentifikacije od nule; njihova dokumentacija posebno ističe Auth0 i Stytch.
Što specifikacija zahtijeva
Metapodaci zaštićenog resursa. Tvoj MCP poslužitelj mora objaviti dokument, primjerice na https://your-mcp.example.com/.well-known/oauth-protected-resource, koji sadrži njegov kanonski identifikator (resource), njegove poslužitelje za autorizaciju (authorization_servers) i opcionalno podržane opsege (scopes_supported). Kada stigne zahtjev bez valjane autentifikacije, poslužitelj mora odgovoriti s 401 Unauthorized i zaglavljem koje pokazuje na ovaj dokument:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Metapodaci poslužitelja za autorizaciju, smješteni na /.well-known/oauth-authorization-server ili /.well-known/openid-configuration, moraju uključivati izdavatelja (issuer), krajnje točke za autorizaciju i tokene te code_challenge_methods_supported koji sadrži S256. Bez ovoga, MCP poslužitelj nije podržan jer je PKCE obavezan.
Parametar resource od kraja do kraja. ChatGPT dodaje resource=… zahtjevima za autorizaciju i token. Tvoj poslužitelj za autorizaciju mora kopirati ovo u token (često kao tvrdnju aud), a tvoj MCP poslužitelj mora odbiti svaki token koji nije izdan specifično za njega.
Kako se ChatGPT registrira kao klijent
Postoje tri metode koje koegzistiraju. Preferirana metoda je CIMD (Client ID Metadata Documents): ChatGPT koristi URL dokumenta s metapodacima hostiranog na HTTPS-u kao client_id, koji tvoj poslužitelj za autorizaciju čita. Omogući ovo objavljivanjem client_id_metadata_document_supported: true. ChatGPT podržava dvije metode autentifikacije na krajnjoj točki tokena: none (javni klijent zaštićen PKCE-om) i private_key_jwt (potpisana tvrdnja provjerljiva javnim ključem koji je objavio ChatGPT). Dinamička registracija klijenta (DCR) ostaje moguća ako objaviš registration_endpoint: ChatGPT se registrira jednom po vezi i ponovno koristi tog klijenta. Unaprijed definirani OAuth klijent treća je opcija.
Što se tiče preusmjeravanja, kopiraj točan URI prikazan na stranici za upravljanje MCP poslužiteljem u ChatGPT-u na popis dopuštenih URL-ova svog poslužitelja za autorizaciju. Taj URI ovisi o podršci za identifikaciju izdavatelja (RFC 9207, parametar iss vraćen u svakom odgovoru na autorizaciju).
Tijek vidljiv korisniku
- ChatGPT čita metapodatke zaštićenog resursa tvog poslužitelja.
- Identificira se kao OAuth klijent (putem CIMD-a, DCR-a ili unaprijed definiranog klijenta).
- Pri prvom pozivu zaštićenog alata, pokreće tijek koda za autorizaciju + PKCE: korisnik se prijavljuje i daje pristanak za tražene opsege.
- ChatGPT razmjenjuje kod za token i attaches ga na naknadne MCP zahtjeve (
Authorization: Bearer …). - Tvoj poslužitelj provjerava token pri svakom zahtjevu prije izvršavanja alata.
Deklariranje alata koji zahtijevaju račun
ChatGPT prikazuje svoje sučelje za povezivanje računa samo ako tvoj poslužitelj signalizira da je OAuth dostupan ili obavezan. To zahtijeva oba dijela: metapodatke i pogrešku u vrijeme izvođenja.
Prvo, metapodaci: svaki alat deklarira svoju politiku u _meta.securitySchemes. noauth znači da se može pozvati anonimno, dok oauth2 zahtijeva token s naznačenim opsezima. Deklariranje oba signalizira da alat može početi bez računa, ali povezivanje otključava više funkcionalnosti. Deklariraj ovo po alatu, čak i ako cijeli poslužitelj slijedi istu politiku.
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
}
);
Drugo, pogreška u vrijeme izvođenja: kada token nedostaje ili je nevažeći, alat mora vratiti rezultat pogreške koji sadrži _meta["mcp/www_authenticate"] s parametrima error i error_description. Ovaj sadržaj je ono što zapravo pokreće sučelje za prijavu. verifyToken je tvoja funkcija za provjeru; Python i TypeScript MCP SDK-ovi pružaju pomoćne funkcije za njezino pisanje.
Provjera svakog tokena
Nakon što se tijek završi, ChatGPT attaches token kakav jest na svaki zahtjev. Tretiraj ga kao nepouzdan i samostalno izvrši sve standardne provjere poslužitelja resursa: validaciju potpisa korištenjem ključeva koje je objavio tvoj poslužitelj za autorizaciju (JWKS) i tvrdnje iss; vremensku valjanost (exp, nbf); publiku (aud ili resource) i potrebne opsege; nakon čega slijede tvoja vlastita poslovna pravila. U slučaju neuspjeha: vrati 401 i zaglavlje WWW-Authenticate, što ponovno pokreće OAuth tijek.
Identificiranje ChatGPT-a kao klijenta
Za provjeru dolazi li zahtjev doista od ChatGPT-a, postoje dvije metode. ChatGPT prezentira klijentski certifikat kojim upravlja OpenAI tijekom TLS veze (mTLS). Provjeri lanac do međuposredničkog tijela koje je objavio OpenAI, da je valjan za autentifikaciju klijenta i da ima dnsName mtls.prod.connectors.openai.com. Nemoj fiksirati otisak lista certifikata jer ga OpenAI može rotirati. Također možeš filtrirati na temelju objavljenih raspona IP adresa. mTLS autentificira ChatGPT; OAuth i dalje autentificira korisnika.
ChatGPT ne podržava dozvole stroj-stroj (client credentials, servisni računi, JWT bearer tvrdnje), prilagođene API ključeve niti mTLS certifikate koje pruža klijent.
OpenAI-jeva sigurnosna načela
- Najmanji privilegij: Zatraži samo opsege, pohranu i mrežni pristup koji su nužni.
- Eksplicitni pristanak: Korisnici moraju razumjeti kada povezuju račun ili odobravaju pristup pisanju; koristi potvrde domaćina za destruktivne radnje.
- Obrana u dubini: Pretpostavi da će injekcije prompta i zlonamjerni unosi stići do tvog poslužitelja. Validiraj sve unose na strani poslužitelja, čak i one koje pruža model, i vodi revizijske zapise.
Što se tiče podataka: uključi samo ono što zahtjev treba u structuredContent, objavi politiku zadržavanja, poštuj zahtjeve za brisanje i maskiraj osobne podatke u zapisnicima. Što se tiče sučelja: komponenta se pokreće u izoliranom iframeu pod strogom Politikom sigurnosti sadržaja (CSP), bez pristupa window.alert, window.prompt, window.confirm ili navigator.clipboard. Što se tiče operacija: provedi sigurnosnu reviziju prije lansiranja, upozori na ponovljene neuspjehe autentifikacije i održavaj ovisnosti ažurnima.
Testiranje autentifikacije
Započni s razvojnim zakupom koji izdaje tokene kratkog vijeka trajanja, ograniči pristup pouzdanim testerima prije otvaranja javnosti i planiraj opoziv, osvježavanje i promjene opsega. Tretiraj nedostajući ili istekli token kao nedostatak autentifikacije, pružajući korisnu poruku o pogrešci. Postavke Auth u MCP Inspectoru omogućuju ti praćenje OAuth tijeka korak po korak kako bi vidio gdje puca.
Ključne točke
- Privatni podaci ili pisanje: OAuth 2.1 prema MCP specifikaciji, s PKCE
S256 - Poslužitelj objavljuje metapodatke zaštićenog resursa i odgovara s
401+WWW-Authenticate - CIMD je preferirana metoda registracije; DCR i unaprijed definirani klijenti ostaju opcije
- Sučelje za povezivanje:
securitySchemespo alatu i pogreška koja sadrži_meta["mcp/www_authenticate"] - Provjeri svaki token pri svakom zahtjevu; mTLS identificira ChatGPT, OAuth identificira korisnika