Salt la conținutul principal
Română— Alege o limbă
Meniu

Autentificare și securitate

Lecția 8 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Cine trebuie să se autentifice
  2. Ce cere specificația
  3. Cum se înregistrează ChatGPT ca client
  4. Fluxul vizibil pentru utilizator
  5. Declararea instrumentelor care necesită un cont
  6. Verificarea fiecărui token
  7. Identificarea ChatGPT drept client
  8. Principiile de securitate ale OpenAI
  9. Testarea autentificării
  10. Puncte cheie

Lecție rescrisă la 3 noiembrie 2026 pe baza documentației OpenAI privind Autentificarea și Securitatea și confidențialitatea pentru plugin-uri. Versiunea anterioară descria autentificarea prin cheie API și o configurație auth într-un manifest inexistent; ChatGPT nu poate prezenta o cheie API personalizată și urmează în schimb fluxul de autorizare definit în specificația MCP (OAuth 2.1). Surse: Authentication · Security & Privacy.

Cine trebuie să se autentifice

Multe servere MCP pot funcționa anonim, în mod read-only. Totuși, orice server care expune date specifice utilizatorului sau efectuează operațiuni de scriere trebuie să autentifice utilizatorul. Contractul de autorizare urmează specificația MCP, care este identică în ChatGPT și Codex: un flux OAuth 2.1 care implică trei actori.

  • Serverul de resurse: Serverul dumneavoastră MCP, care expune instrumente și verifică token-ul de acces la fiecare cerere.
  • Serverul de autorizare: Furnizorul dumneavoastră de identitate, care emite token-uri și publică metadatele sale de descoperire.
  • Clientul: Gazda OpenAI (ChatGPT sau Codex), care acționează în numele utilizatorului.

OpenAI recomandă cu fermitate să vă bazați pe un furnizor de identitate consacrat, în loc să construiți autentificarea de la zero; documentația lor indică în mod specific Auth0 și Stytch.

Ce cere specificația

Metadate pentru resursa protejată. Serverul dumneavoastră MCP trebuie să publice un document, de exemplu la https://your-mcp.example.com/.well-known/oauth-protected-resource, care să conțină identificatorul său canonic (resource), serverele sale de autorizare (authorization_servers) și, opțional, domeniile de aplicare suportate (scopes_supported). Când sosește o cerere fără o autentificare validă, serverul trebuie să răspundă cu 401 Unauthorized și un antet care indică spre acest document:

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

Metadate pentru serverul de autorizare, situate la /.well-known/oauth-authorization-server sau /.well-known/openid-configuration, trebuie să includă emitentul (issuer), punctele finale de autorizare și de token, precum și code_challenge_methods_supported care conține S256. Fără aceasta, serverul MCP nu este suportat, deoarece PKCE este obligatoriu.

Parametrul resource cap-la-cap. ChatGPT adaugă resource=… la cererile de autorizare și de token. Serverul dumneavoastră de autorizare trebuie să copieze aceasta în token (adesea ca revendicare aud), iar serverul dumneavoastră MCP trebuie să respingă orice token care nu a fost emis specific pentru el.

Cum se înregistrează ChatGPT ca client

Trei metode coexistă. Metoda preferată este CIMD (Client ID Metadata Documents): ChatGPT folosește URL-ul unui document de metadate găzduit pe HTTPS drept client_id, pe care serverul dumneavoastră de autorizare îl citește. Activați acest lucru publicând client_id_metadata_document_supported: true. ChatGPT suportă două metode de autentificare la punctul final al token-ului: none (client public protejat prin PKCE) și private_key_jwt (afirmație semnată, verificabilă cu cheia publică publicată de ChatGPT). Înregistrarea dinamică a clientului (DCR) rămâne posibilă dacă publicați un registration_endpoint: ChatGPT se înregistrează o singură dată per conexiune și reutilizează acel client. Un client OAuth predefinit este a treia opțiune.

În ceea ce privește redirecționările, copiați exact URI-ul afișat pe pagina de gestionare a serverului MCP din ChatGPT în lista de permisiuni a serverului dumneavoastră de autorizare. Acest URI depinde de suportul pentru Identificarea Emitentului (RFC 9207, parametrul iss returnat în fiecare răspuns de autorizare).

Fluxul vizibil pentru utilizator

  1. ChatGPT citește metadatele resursei protejate ale serverului dumneavoastră.
  2. Se identifică drept client OAuth (prin CIMD, DCR sau un client predefinit).
  3. La primul apel către un instrument protejat, inițiază fluxul authorization code + PKCE: utilizatorul se autentifică și își dă consimțământul pentru domeniile de aplicare solicitate.
  4. ChatGPT schimbă codul pe un token și îl atașează la cererile MCP ulterioare (Authorization: Bearer …).
  5. Serverul dumneavoastră verifică token-ul la fiecare cerere înainte de a executa instrumentul.

Declararea instrumentelor care necesită un cont

ChatGPT afișează interfața de legare a contului doar dacă serverul dumneavoastră semnalează că OAuth este disponibil sau necesar. Acest lucru necesită ambele componente: metadate și o eroare la runtime.

În primul rând, metadatele: fiecare instrument își declară politica în _meta.securitySchemes. noauth înseamnă că poate fi apelat anonim, în timp ce oauth2 necesită un token cu domeniile de aplicare indicate. Declararea ambelor semnalează că instrumentul poate porni fără un cont, dar legarea deblochează funcționalități suplimentare. Declarați acest lucru per instrument, chiar dacă întregul server urmează aceeași politică.

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

În al doilea rând, eroarea la runtime: când token-ul lipsește sau este invalid, instrumentul trebuie să returneze un rezultat de eroare care conține _meta["mcp/www_authenticate"] cu parametrii error și error_description. Acest conținut este cel care declanșează efectiv interfața de autentificare. verifyToken este funcția dumneavoastră de verificare; SDK-urile MCP pentru Python și TypeScript oferă ajutoare pentru scrierea acesteia.

Verificarea fiecărui token

Odată ce fluxul se încheie, ChatGPT atașează token-ul ca atare la fiecare cerere. Tratați-l ca fiind nesigur și efectuați singuri toate verificările standard ale serverului de resurse: validarea semnăturii folosind cheile publicate de serverul dumneavoastră de autorizare (JWKS) și revendicarea iss; valabilitatea temporală (exp, nbf); audiența (aud sau resource) și domeniile de aplicare necesare; urmate de propriile dumneavoastră reguli de afaceri. În caz de eșec: returnați 401 și un antet WWW-Authenticate, ceea ce repornește fluxul OAuth.

Identificarea ChatGPT drept client

Pentru a verifica dacă o cerere provine genuine de la ChatGPT, există două metode. ChatGPT prezintă un certificat client gestionat de OpenAI în timpul conexiunii TLS (mTLS). Verificați dacă acesta lanțuiește către autoritatea intermediară publicată de OpenAI, este valid pentru autentificarea clientului și are dnsName mtls.prod.connectors.openai.com. Nu fixați amprenta certificatului leaf, deoarece OpenAI îl poate roti. De asemenea, puteți filtra pe baza intervalelor de adrese IP publicate. mTLS autentifică ChatGPT; OAuth continuă să autentifice utilizatorul.

ChatGPT nu suportă permisiuni machine-to-machine (client credentials, conturi de serviciu, afirmații JWT bearer), chei API personalizate sau certificate mTLS furnizate de client.

Principiile de securitate ale OpenAI

  • Privilegiu minim: Solicitați doar domeniile de aplicare, stocarea și accesul la rețea necesare.
  • Consimțământ explicit: Utilizatorii trebuie să înțeleagă când leagă un cont sau acordă acces de scriere; folosiți confirmările gazdei pentru acțiuni distructive.
  • Apărare în profunzime: Presupuneți că injecțiile de prompt și inputurile malițioase vor ajunge la serverul dumneavoastră. Validați toate inputurile lato-server, chiar și pe cele furnizate de model, și mențineți jurnale de audit.

În ceea ce privește datele: includeți în structuredContent doar ceea ce necesită cererea, publicați o politică de retenție, onorați cererile de ștergere și mascați datele personale în jurnale. În ceea ce privește interfața: componenta rulează într-un iframe izolat sub o Politică Strictă de Securitate a Conținutului, fără acces la window.alert, window.prompt, window.confirm sau navigator.clipboard. În ceea ce privește operațiunile: efectuați o revizuire de securitate înainte de lansare, alertați în cazul eșecurilor repetate de autentificare și mențineți dependențele la zi.

Testarea autentificării

Începeți cu un tenant de dezvoltare care emite token-uri cu durată scurtă de viață, restricționați accesul la testeri de încredere înainte de deschidere și planificați revocarea, reîmprospătarea și modificările domeniilor de aplicare. Tratați un token lipsă sau expirat ca pe o lipsă de autentificare, furnizând un mesaj de eroare util. Setările Auth din MCP Inspector vă permit să urmăriți fluxul OAuth pas cu pas pentru a vedea unde se blochează.

Puncte cheie

  • Date private sau scrieri: OAuth 2.1 conform specificației MCP, cu PKCE S256
  • Serverul publică metadate pentru resursa protejată și răspunde cu 401 + WWW-Authenticate
  • CIMD este metoda preferată de înregistrare; DCR și clienții predefiniți rămân opțiuni
  • Interfața de legare: securitySchemes per instrument și o eroare care conține _meta["mcp/www_authenticate"]
  • Verificați fiecare token la fiecare cerere; mTLS identifică ChatGPT, OAuth identifică utilizatorul