Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Avtentikacija in varnost

Lekcija 8 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Kdo se mora avtenticirati
  2. Kaj zahteva specifikacija
  3. Kako se ChatGPT registrira kot odjemalec
  4. Tok, ki ga vidi uporabnik
  5. Deklariranje orodij, ki zahtevajo račun
  6. Preverjanje vsakega žetona
  7. Identifikacija ChatGPT kot odjemalca
  8. Varnostna načela OpenAI
  9. Testiranje avtentikacije
  10. Ključne ugotovitve

Lekcija je bila ponovno napisana 3. novembra 2026 na podlagi dokumentacije OpenAI o avtentikaciji ter varnosti in zasebnosti za vtičnike. Prejšnja različica je opisovala avtentikacijo s ključem API in konfiguracijo auth v neobstoječem manifestu; ChatGPT ne more predstaviti ključa API po meri, temveč sledi toku avtorizacije, opredeljenemu v specifikaciji MCP (OAuth 2.1). Viri: Authentication · Security & Privacy.

Kdo se mora avtenticirati

Številni strežniki MCP lahko delujejo v načinu samo za branje anonimno. Vendar pa se mora vsak strežnik, ki razkriva podatke, specifične za uporabnika, ali izvaja operacije pisanja, avtenticirati uporabnika. Pogodba o avtorizaciji sledi specifikaciji MCP, ki je enaka v ChatGPT in Codex: tok OAuth 2.1, ki vključuje tri akterje.

  • Strežnik virov: Vaš strežnik MCP, ki razkriva orodja in preverja žeton za dostop pri vsaki zahtevi.
  • Avtorizacijski strežnik: Vaš ponudnik identitete, ki izdaja žetone in objavlja svoje metapodatke odkrivanja.
  • Odjemalec: Gostitelj OpenAI (ChatGPT ali Codex), ki deluje v imenu uporabnika.

OpenAI močno priporoča zanašanje na uveljavljenega ponudnika identitete namesto gradnje avtentikacije od nič; njihova dokumentacija posebej izpostavlja Auth0 in Stytch.

Kaj zahteva specifikacija

Metapodatki zaščitenega vira. Vaš strežnik MCP mora objaviti dokument, na primer na naslovu https://your-mcp.example.com/.well-known/oauth-protected-resource, ki vsebuje njegov kanonični identifikator (resource), njegove avtorizacijske strežnike (authorization_servers) in po izbiri podprte obsege (scopes_supported). Ko prispe zahteva brez veljavne avtentikacije, mora strežnik odgovoriti s 401 Unauthorized in glavo, ki kaže na ta dokument:

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"

Metapodatki avtorizacijskega strežnika, ki se nahajajo na /.well-known/oauth-authorization-server ali /.well-known/openid-configuration, morajo vključevati izdajatelja (issuer), končni točki za avtorizacijo in žetone ter code_challenge_methods_supported, ki vsebuje S256. Brez tega strežnik MCP ni podprt, saj je PKCE obvezen.

Parameter resource od konca do konca. ChatGPT doda resource=… zahtevam za avtorizacijo in žetone. Vaš avtorizacijski strežnik mora to kopirati v žeton (pogosto kot trditev aud), vaš strežnik MCP pa mora zavrniti vsak žeton, ki ni bil izdan posebej zanj.

Kako se ChatGPT registrira kot odjemalec

Sobivajo tri metode. Prednostna metoda je CIMD (Client ID Metadata Documents): ChatGPT uporabi URL dokumenta z metapodatki, gostovanega na HTTPS, kot client_id, ki ga prebere vaš avtorizacijski strežnik. To omogočite z objavo client_id_metadata_document_supported: true. ChatGPT podpira dve metodi avtentikacije na končni točki žetona: none (javni odjemalec, zaščiten s PKCE) in private_key_jwt (podpisan potrditveni stavek, preverljiv z javnim ključem, ki ga objavi ChatGPT). Dinamična registracija odjemalca (DCR) ostaja mogoča, če objavite registration_endpoint: ChatGPT se registrira enkrat na povezavo in ponovno uporabi tega odjemalca. Tretja možnost je vnaprej določen odjemalec OAuth.

Glede preusmeritev kopirajte točen URI, prikazan na strani za upravljanje strežnika MCP v ChatGPT, na seznam dovoljenih naslovov vašega avtorizacijskega strežnika. Ta URI je odvisen od podpore identifikaciji izdajatelja (RFC 9207, parameter iss, vrnjen v vsakem odgovoru na avtorizacijo).

Tok, ki ga vidi uporabnik

  1. ChatGPT prebere metapodatke zaščitenega vira vašega strežnika.
  2. Identificira se kot odjemalec OAuth (prek CIMD, DCR ali vnaprej določenega odjemalca).
  3. Ob prvem klicu zaščitenega orodja sproži tok avtorizacijske kode + PKCE: uporabnik se prijavi in poda soglasje za zahtevane obsege.
  4. ChatGPT zamenja kodo za žeton in ga priloži naslednjim zahtevam MCP (Authorization: Bearer …).
  5. Vaš strežnik preveri žeton pri vsaki zahtevi pred izvedbo orodja.

Deklariranje orodij, ki zahtevajo račun

ChatGPT prikaže vmesnik za povezavo računa le, če vaš strežnik signalizira, da je OAuth na voljo ali zahtevan. To zahteva oba dela: metapodatke in napako med izvajanjem.

Najprej metapodatki: vsako orodje deklarira svojo politiko v _meta.securitySchemes. noauth pomeni, da je klicljivo anonimno, medtem ko oauth2 zahteva žeton z navedenimi obsegi. Deklariranje obeh signalizira, da se lahko orodje zažene brez računa, vendar povezava odklene več funkcionalnosti. To deklarirajte na ravni orodja, tudi če celoten strežnik sledi isti politiki.

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
  }
);

Drugič, napaka med izvajanjem: ko žeton manjka ali ni veljaven, mora orodje vrniti rezultat napake, ki vsebuje _meta["mcp/www_authenticate"] s parametroma error in error_description. Ta vsebina je tista, ki dejansko sproži vmesnik za prijavo. verifyToken je vaša funkcija za preverjanje; SDK-ji MCP za Python in TypeScript ponujajo pomočnike za njeno pisanje.

Preverjanje vsakega žetona

Ko se tok zaključi, ChatGPT priloži žeton takšen, kot je, vsaki zahtevi. Obravnavajte ga kot nezanesljivega in sami izvedite vsa standardna preverjanja strežnika virov: preverjanje podpisa z uporabo ključev, ki jih objavi vaš avtorizacijski strežnik (JWKS), in trditve iss; časovna veljavnost (exp, nbf); ciljna publika (aud ali resource) in zahtevani obsegi; temu sledijo vaša lastna poslovna pravila. Ob neuspehu: vrnite 401 in glavo WWW-Authenticate, kar ponovno sproži tok OAuth.

Identifikacija ChatGPT kot odjemalca

Za preverjanje, ali zahteva resnično prihaja od ChatGPT, obstajata dve metodi. ChatGPT med povezavo TLS predstavi potrdilo odjemalca, ki ga upravlja OpenAI (mTLS). Preverite, ali veriga vodi do vmesnega organa, ki ga objavi OpenAI, ali je veljavno za avtentikacijo odjemalca in ali ima dnsName mtls.prod.connectors.openai.com. Ne pripenjajte prstnega odtisa končnega potrdila, saj ga lahko OpenAI zamenja. Filtrirate lahko tudi na podlagi objavljenih razponov IP-naslovov. mTLS avtenticira ChatGPT; OAuth še naprej avtenticira uporabnika.

ChatGPT ne podpira dovoljenj od stroja do stroja (client credentials, storitveni računi, trditve JWT bearer), ključev API po meri ali potrdil mTLS, ki jih zagotovi odjemalec.

Varnostna načela OpenAI

  • Najmanjša privilegija: Zahtevajte le obsege, shrambo in omrežni dostop, ki so nujni.
  • Izrecno soglasje: Uporabniki morajo razumeti, kdaj povezujejo račun ali podeljujejo dostop za pisanje; za destruktivna dejanja uporabite potrditve gostitelja.
  • Obramba v globino: Predpostavljajte, da bodo vbrizganja pozivov in zlonamerni vnosi dosegli vaš strežnik. Preverite vse vnose na strani strežnika, tudi tiste, ki jih zagotovi model, in vzdržujte revizijske dnevnike.

Glede podatkov: v structuredContent vključite le tisto, kar zahteva potrebuje, objavite politiko hrambe, upoštevajte zahteve za brisanje in maskirajte osebne podatke v dnevnikih. Glede vmesnika: komponenta se izvaja v izoliranem iframe-u pod strogo varnostno politiko vsebine (CSP), brez dostopa do window.alert, window.prompt, window.confirm ali navigator.clipboard. Glede operacij: pred zagonom opravite varnostni pregled, opozarjajte na ponavljajoče se napake avtentikacije in vzdržujte odvisnosti posodobljene.

Testiranje avtentikacije

Začnite z razvojnem najemnikom, ki izdaja kratkotrajne žetone, omejite dostop zaupanja vrednim testerjem, preden ga odprete širše, in načrtujte preklic, osveževanje in spremembe obsegov. Manjkajoč ali potekel žeton obravnavajte kot odsotnost avtentikacije in zagotovite uporabno sporočilo o napaki. Nastavitve Auth v MCP Inspectorju vam omogočajo sledenje toku OAuth korak za korakom, da vidite, kje se poruši.

Ključne ugotovitve

  • Zasebni podatki ali pisanje: OAuth 2.1 po specifikaciji MCP, s PKCE S256
  • Strežnik objavi metapodatke zaščitenega vira in odgovori s 401 + WWW-Authenticate
  • CIMD je prednostna metoda registracije; DCR in vnaprej določeni odjemalci ostajajo možnosti
  • Vmesnik za povezavo: securitySchemes na orodje in napaka, ki vsebuje _meta["mcp/www_authenticate"]
  • Preverite vsak žeton pri vsaki zahtevi; mTLS identificira ChatGPT, OAuth identificira uporabnika