Todentaminen ja turvallisuus
Tällä sivulla
Oppitunti kirjoitettu uudelleen 3. marraskuuta 2026 OpenAI:n Authentication ja Security & Privacy -liitännäisdokumentaation pohjalta. Edellinen versio kuvasi API-avaintodennusta ja
auth-määritystä olemattomassa manifestissa; ChatGPT ei voi esittää mukautettua API-avainta, vaan noudattaa MCP-määrittelyn mukaista valtuutusvuota (OAuth 2.1). Lähteet: Authentication · Security & Privacy.
Kuka tarvitsee todennuksen
Monet MCP-palvelimet voivat toimia nimettömästi vain luku -tilassa. Mikä tahansa palvelin, joka paljastaa käyttäjäkohtaisia tietoja tai suorittaa kirjoitustoimintoja, on kuitenkin todennettava käyttäjä. Valtuutussopimus noudattaa MCP-määrittelyä, joka on identtinen ChatGPT:ssä ja Codexissa: OAuth 2.1 -vuoro, johon osallistuu kolme toimijaa.
- Resurssipalvelin: Sinun MCP-palvelimesi, joka tarjoaa työkaluja ja tarkistaa pääsytunnuksen jokaisessa pyynnössä.
- Valtuutuspalvelin: Identiteetintarjoajasi, joka myöntää tunnuksia ja julkaisee havaintometatietonsa.
- Asiakas: OpenAI-isäntä (ChatGPT tai Codex), joka toimii käyttäjän puolesta.
OpenAI suosittelee vahvasti vakiintuneen identiteetintarjoajan käyttöä todennuksen rakentamisen sijaan alusta alkaen; heidän dokumentaationsa viittaa erityisesti Auth0:hon ja Stytchiin.
Mitä määrittely vaatii
Suojatun resurssin metatiedot. MCP-palvelimesi on julkaistava asiakirja, esimerkiksi osoitteessa https://your-mcp.example.com/.well-known/oauth-protected-resource, joka sisältää sen kanonisen tunnisteen (resource), valtuutuspalvelimensa (authorization_servers) ja valinnaisesti tuetut laajuudet (scopes_supported). Kun pyyntö saapuu ilman voimassa olevaa todennusta, palvelimen on vastattava koodilla 401 Unauthorized ja otsikolla, joka osoittaa tähän asiakirjaan:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Valtuutuspalvelimen metatiedot, jotka sijaitsevat osoitteessa /.well-known/oauth-authorization-server tai /.well-known/openid-configuration, on sisällettävä myöntäjä (issuer), valtuutus- ja tunnuspäätepisteet sekä code_challenge_methods_supported, joka sisältää arvon S256. Ilman tätä MCP-palvelin ei ole tuettu, sillä PKCE on pakollinen.
Parametri resource päästä päähän. ChatGPT lisää parametrin resource=… valtuutus- ja tunnuspyyntöihin. Valtuutuspalvelimesi on kopioitava tämä tunnukseen (usein väitteenä aud), ja MCP-palvelimesi on hylättävä kaikki tunnuksen, jota ei ole myönnetty nimenomaan sille.
Miten ChatGPT rekisteröityy asiakkaaksi
Kolme menetelmää coexistoi. Ensisijainen menetelmä on CIMD (Client ID Metadata Documents): ChatGPT käyttää HTTPS-yhteydellä isännöidyn metatietoasiakirjan URL-osoitetta client_id:nä, jonka valtuutuspalvelimesi lukee. Ota tämä käyttöön julkaisemalla client_id_metadata_document_supported: true. ChatGPT tukee kahta todennusmenetelmää tunnuspäätepisteessä: none (julkinen asiakas, jota suojaa PKCE) ja private_key_jwt (allekirjoitettu väite, joka on varmennettavissa ChatGPT:n julkaisemalla julkisella avaimella). Dynaaminen asiakasrekisteröinti (DCR) on edelleen mahdollista, jos julkaiset registration_endpoint: ChatGPT rekisteröityy kerran yhteyttä kohden ja käyttää tätä asiakasta uudelleen. Ennalta määritelty OAuth-asiakas on kolmas vaihtoehto.
Uudelleenohjausten osalta kopioi tarkka URI, joka näkyy ChatGPT:n MCP-palvelinhallintasivulla, valtuutuspalvelimesi sallittujen luetteloon. Tämä URI riippuu myöntäjän tunnistamisen tuesta (RFC 9207, parametri iss, joka palautetaan jokaisessa valtuutusvastauksessa).
Käyttäjälle näkyvä vuoro
- ChatGPT lukee palvelimesi suojatun resurssin metatiedot.
- Se tunnistaa itsensä OAuth-asiakkaaksi (CIMD:n, DCR:n tai ennalta määritellyn asiakkaan kautta).
- Ensimmäisellä suojatun työkalun kutsulla se aloittaa valtuutuskoodi + PKCE -vuoron: käyttäjä kirjautuu sisään ja myöntää pyydetyt laajuudet.
- ChatGPT vaihtaa koodin tunnukseen ja liittää sen myöhempiin MCP-pyyntöihin (
Authorization: Bearer …). - Palvelimesi tarkistaa tunnuksen jokaisessa pyynnössä ennen työkalun suorittamista.
Ilmoittaminen, mitkä työkalut vaativat tilin
ChatGPT näyttää tilin linkitysliittymän vain, jos palvelimesi signaloi, että OAuth on saatavilla tai vaadittu. Tämä vaatii molemmat osat: metatiedot ja ajonaikaisen virheen.
Ensinnäkin metatiedot: jokainen työkalu ilmoittaa käytäntönsä kohdassa _meta.securitySchemes. noauth tarkoittaa, että sitä voi kutsua nimettömästi, kun taas oauth2 vaatii tunnuksen ilmoitetuilla laajuuksilla. Molempien ilmoittaminen signaloi, että työkalu voi aloittaa ilman tiliä, mutta linkitys avaa enemmän toiminnallisuuksia. Ilmoita tämä työkalukohtaisesti, vaikka koko palvelin noudattaisi samaa käytäntöä.
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
}
);
Toiseksi ajonaikainen virhe: kun tunnus puuttuu tai on virheellinen, työkalun on palautettava virhetulos, joka sisältää _meta["mcp/www_authenticate"] parametreilla error ja error_description. Tämä sisältö on se, mikä itse asiassa käynnistää kirjautumisliittymän. verifyToken on varmennustoimintosi; Python- ja TypeScript-MCP-SDK:t tarjoavat apuohjelmia sen kirjoittamiseen.
Jokaisen tunnuksen tarkistaminen
Kun vuoro on valmis, ChatGPT liittää tunnuksen sellaisenaan jokaiseen pyyntöön. Kohtele sitä epäluotettavana ja suorita kaikki standardit resurssipalvelimen varmennukset itse: allekirjoituksen validointi käyttämällä valtuutuspalvelimesi julkaisemia avaimia (JWKS) ja väitettä iss; aikakelpoisuus (exp, nbf); kohdeyleisö (aud tai resource) ja vaaditut laajuudet; tätä seuraavat omat liiketoimintasääntösi. Epäonnistuessa: palauta 401 ja otsikko WWW-Authenticate, mikä käynnistää OAuth-vuoron uudelleen.
ChatGPT:n tunnistaminen asiakkaaksi
Jotta voit varmistaa pyynnön tulevan aidosti ChatGPT:ltä, on olemassa kaksi menetelmää. ChatGPT esittää OpenAI:n hallinnoiman asiakasvarmenteen TLS-yhteyden aikana (mTLS). Varmista, että se ketjutuu OpenAI:n julkaisemaan väliarviointiviranomaiseen, on voimassa asiakastodennusta varten ja sillä on dnsName mtls.prod.connectors.openai.com. Älä kiinnitä lehtivarmenteen sormenjälkeä, sillä OpenAI voi vaihtaa sen. Voit myös suodattaa julkaistujen IP-osoitealueiden perusteella. mTLS todentaa ChatGPT:n; OAuth jatkaa käyttäjän todentamista.
ChatGPT ei tue koneesta koneeseen -oikeuksia (client credentials, palvelutilit, JWT bearer -väitteet), mukautettuja API-avaimia eikä asiakkaan toimittamia mTLS-varmenteita.
OpenAI:n turvallisuusperiaatteet
- Vähimmäisoikeudet: Pyydä vain tarvittavia laajuuksia, tallennustilaa ja verkkoyhteyksiä.
- Nimenomainen suostumus: Käyttäjien on ymmärrettävä, milloin he linkittävät tiliä tai myöntävät kirjoitusoikeuksia; käytä isännän vahvistuksia tuhoisille toiminnoille.
- Syvyyspuolustus: Oleta, että kehoteinjektiot ja haitalliset syötteet päätyvät palvelimellesi. Validoi kaikki syötteet palvelinpuolella, jopa mallin tarjoamat, ja ylläpidä tarkistuslokeja.
Tietojen osalta: sisällytä structuredContent-kenttään vain pyynnön tarvitsemat tiedot, julkaise säilytyskäytäntö, kunnioita poistopyyntöjä ja peitä henkilökohtaiset tiedot lokeista. Käyttöliittymän osalta: komponentti suoritetaan eristetyssä iframe-kehyksessä tiukan Content Security Policy -käytännön alaisena, ilman pääsyä kohtiin window.alert, window.prompt, window.confirm tai navigator.clipboard. Toimintojen osalta: suorita turvallisuuskatsaus ennen julkaisua, hälytä toistuvista todennusvirheistä ja pidä riippuvuudet ajan tasalla.
Todennuksen testaaminen
Aloita kehitysvuokralaisesta, joka myöntää lyhytikäisiä tunnuksia, rajoita pääsy luotettuihin testaajiin ennen avaamista ja suunnittele peruuttaminen, päivitys ja laajuusmuutokset. Kohtele puuttuvaa tai vanhentunutta tunnusta todennuksen puutteena ja tarjoa hyödyllinen virheilmoitus. MCP Inspectorin Auth-asetusten avulla voit jäljittää OAuth-vuoron vaiheittain nähdäksesi, missä se epäonnistuu.
Keskeiset asiat
- Yksityiset tiedot tai kirjoitukset: OAuth 2.1 MCP-määrittelyn mukaisesti, PKCE
S256:lla - Palvelin julkaisee suojatun resurssin metatiedot ja vastaa koodilla
401+WWW-Authenticate - CIMD on ensisijainen rekisteröintimenetelmä; DCR ja ennalta määritellyt asiakkaat ovat edelleen vaihtoehtoja
- Linkitysliittymä:
securitySchemestyökalua kohden ja virhe, joka sisältää_meta["mcp/www_authenticate"] - Tarkista jokainen tunnus jokaisessa pyynnössä; mTLS tunnistaa ChatGPT:n, OAuth tunnistaa käyttäjän