Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Awtentikazzjoni u Sigurtà

Lezzjoni 8 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Min għandu bżonn jawtentika ruħu
  2. X’titlob l-ispeċifikazzjoni
  3. Kif ChatGPT jirreġistra bħala klijent
  4. Il-fluss viżibbli għall-utent
  5. Dikjarazzjoni ta’ liema għodod jeħtieġu kont
  6. Verifika ta’ kull token
  7. Identifikazzjoni ta’ ChatGPT bħala l-klijent
  8. Il-prinċipji tas-sigurtà ta’ OpenAI
  9. Ittestjar tal-awtentikazzjoni
  10. Punti Ewlenin

Lezzjoni miktuba mill-ġdid fit-3 ta’ Novembru 2026 ibbażata fuq id-dokumentazzjoni tal-plugin Authentication u Security & Privacy ta’ OpenAI. Il-verżjoni preċedenti kienet tiddeskrivi l-awtentikazzjoni tal-API key u konfigurazzjoni auth f’manifest li ma jeżistix; ChatGPT ma jistax jippreżenta API key personalizzata u minflok isegwi l-fluss ta’ awtorizzazzjoni definit fl-ispeċifikazzjoni MCP (OAuth 2.1). Sorsi: Authentication · Security & Privacy.

Min għandu bżonn jawtentika ruħu

Ħafna servers MCP jistgħu jaħdmu f’modalità ta’ qari biss b’mod anonimu. Madankollu, kull server li jesponi data speċifika għall-utent jew iwettaq operazzjonijiet ta’ kitba għandu jawtentika lill-utent. Il-kuntratt ta’ awtorizzazzjoni jsegwi l-ispeċifikazzjoni MCP, li hija identika f’ChatGPT u Codex: fluss OAuth 2.1 li jinvolvi tliet atturi.

  • Is-server tar-riżorsa: Is-server MCP tiegħek, li jesponi għodod u jivverifika t-token tal-aċċess fuq kull talba.
  • Is-server ta’ awtorizzazzjoni: Il-fornitur tal-identità tiegħek, li joħroġ tokens u jippubblika l-metadejta ta’ skoperta tiegħu.
  • Il-klijent: L-host ta’ OpenAI (ChatGPT jew Codex), li jaġixxi f’isem l-utent.

OpenAI tirrakkomanda b’mod qawwi li tiddependi fuq fornitur tal-identità stabbilit minflok tibni l-awtentikazzjoni minn xejn; id-dokumentazzjoni tagħhom tindika speċifikament lil Auth0 u Stytch.

X’titlob l-ispeċifikazzjoni

Metadejta tar-Riżorsa Protetta. Is-server MCP tiegħek għandu jippubblika dokument, pereżempju f’https://your-mcp.example.com/.well-known/oauth-protected-resource, li fih l-identifikatur kanoniku tiegħu (resource), is-servers ta’ awtorizzazzjoni tiegħu (authorization_servers), u opzjonalment l-ambiti appoġġjati (scopes_supported). Meta tasal talba mingħajr awtentikazzjoni valida, is-server għandu jwieġeb b’401 Unauthorized u header li jipponta lejn dan id-dokument:

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

Metadejta tas-Server ta’ Awtorizzazzjoni, li tinsab f’/.well-known/oauth-authorization-server jew /.well-known/openid-configuration, għandha tinkludi l-emittent (issuer), l-endpoints ta’ awtorizzazzjoni u token, u code_challenge_methods_supported li fih S256. Mingħajr dan, is-server MCP mhuwiex appoġġjat, peress li PKCE huwa obbligatorju.

Il-parametru resource minn tarf għal tarf. ChatGPT iżid resource=… mat-talbiet ta’ awtorizzazzjoni u token. Is-server ta’ awtorizzazzjoni tiegħek għandu jikkopja dan fit-token (spiss bħala l-claim aud), u s-server MCP tiegħek għandu jiċħad kull token li ma ġiex maħruġ speċifikament għalih.

Kif ChatGPT jirreġistra bħala klijent

Jikkoegżistu tliet metodi. Il-metodu preferut huwa CIMD (Client ID Metadata Documents): ChatGPT juża l-URL ta’ dokument ta’ metadejta ospitat fuq HTTPS bħala l-client_id, li s-server ta’ awtorizzazzjoni tiegħek jaqra. Ippermetti dan billi tippubblika client_id_metadata_document_supported: true. ChatGPT jappoġġja żewġ metodi ta’ awtentikazzjoni fl-endpoint tat-token: none (klijent pubbliku protett minn PKCE) u private_key_jwt (asserzjoni ffirmata verifikabbli bil-key pubblika ppubblikata minn ChatGPT). Ir-Reġistrazzjoni Dinamika tal-Klijent (DCR) tibqa’ possibbli jekk tippubblika registration_endpoint: ChatGPT jirreġistra darba għal kull konnessjoni u jerġa’ juża dak il-klijent. Klijent OAuth predefinit huwa t-tielet għażla.

Fir-rigward tar-ridirezzjonijiet, ikkopja l-URI eżatt muri fil-paġna tal-ġestjoni tas-server MCP f’ChatGPT fil-lista ta’ permessi tas-server ta’ awtorizzazzjoni tiegħek. Din l-URI tiddependi fuq l-appoġġ għall-Identifikazzjoni tal-Emittent (RFC 9207, il-parametru iss ritornat f’kull risposta ta’ awtorizzazzjoni).

Il-fluss viżibbli għall-utent

  1. ChatGPT jaqra l-metadejta tar-riżorsa protetta tas-server tiegħek.
  2. Jidentifika ruħu bħala klijent OAuth (permezz ta’ CIMD, DCR, jew klijent predefinit).
  3. Fl-ewwel sejħa għal għodda protetta, jibda l-fluss authorization code + PKCE: l-utent jidħol u jagħti l-kunsens għall-ambiti mitluba.
  4. ChatGPT jiskambja l-kodiċi għal token u jwaħħlu mat-talbiet MCP sussegwenti (Authorization: Bearer …).
  5. Is-server tiegħek jivverifika t-token fuq kull talba qabel ma jesegwixxi l-għodda.

Dikjarazzjoni ta’ liema għodod jeħtieġu kont

ChatGPT juri l-interfaċċa ta’ rabt tal-kont tiegħu biss jekk is-server tiegħek jissinjala li OAuth huwa disponibbli jew meħtieġ. Dan jeħtieġ ** iż-żewġ partijiet**: metadejta u żball ta’ runtime.

L-ewwel, il-metadejta: kull għodda tiddikjara l-politika tagħha f’_meta.securitySchemes. noauth tfisser li tista’ tissejjaħ b’mod anonimu, filwaqt li oauth2 teħtieġ token bl-ambiti indikati. Id-dikjarazzjoni taż-żewġ metodi tissuġġerixxi li l-għodda tista’ tibda mingħajr kont, iżda r-rabt jiftaħ aktar funzjonalità. Iddikjara dan għal kull għodda, anke jekk is-server kollu jsegwi l-istess politika.

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

It-tieni, l-iżball ta’ runtime: meta t-token jonqos jew ikun invalidu, l-għodda għandha tirritorna riżultat ta’ żball li fih _meta["mcp/www_authenticate"] bil-parametri error u error_description. Dan il-kontenut huwa dak li attwalment jattiva l-interfaċċa tad-dħul. verifyToken hija l-funzjoni ta’ verifika tiegħek; l-SDKs ta’ MCP għal Python u TypeScript jipprovdu għajnuna biex tiktebha.

Verifika ta’ kull token

Ladarba l-fluss jintemm, ChatGPT iwaħħal it-token kif inhu ma’ kull talba. Ittrattah bħala mhux affidabbli u wettaq il-verifiki kollha standard tas-server tar-riżorsa int stess: validazzjoni tal-firma bl-użu ta’ keys ippubblikati mis-server ta’ awtorizzazzjoni tiegħek (JWKS) u l-claim iss; validità temporali (exp, nbf); udjenza (aud jew resource) u ambiti meħtieġa; segwiti mir-regoli tan-negozju tiegħek stess. Fil-każ ta’ falliment: irritorna 401 u header WWW-Authenticate, li jerġa’ jibda l-fluss OAuth.

Identifikazzjoni ta’ ChatGPT bħala l-klijent

Biex tivverifika li talba ġejja verament minn ChatGPT, jeżistu żewġ metodi. ChatGPT jippreżenta ċertifikat tal-klijent immaniġġjat minn OpenAI matul il-konnessjoni TLS (mTLS). Ivvverifika li jgħaqqad mal-awtorità intermedjarja ppubblikata minn OpenAI, li huwa validu għall-awtentikazzjoni tal-klijent, u li għandu d-dnsName mtls.prod.connectors.openai.com. Tiffissax il-fingerprint taċ-ċertifikat tal-weraq, peress li OpenAI tista’ ddawru. Tista’ wkoll tiffiltrabbażat fuq firxi ta’ indirizzi IP ippubblikati. L-mTLS jawtentika lil ChatGPT; l-OAuth ikompli jawtentika lill-utent.

ChatGPT ma jappoġġjax permessi minn magna għal magna (client credentials, kontijiet ta’ servizz, asserzjonijiet JWT bearer), API keys personalizzati, jew ċertifikati mTLS ipprovduti mill-klijent.

Il-prinċipji tas-sigurtà ta’ OpenAI

  • Privileġġ minimu: Itlob biss l-ambiti, il-ħażna, u l-aċċess tan-network meħtieġa.
  • Kunsens espliċitu: L-utenti għandhom jifhmu meta qed jorbtu kont jew jagħtu aċċess ta’ kitba; uża konfermi tal-host għal azzjonijiet distruttivi.
  • Difiża fil-fond: Assumi li l-injezzjonijiet tal-prompt u inputs malizzjużi se jaslu għas-server tiegħek. Ivvvalida l-inputs kollha fuq in-naħa tas-server, anke dawk ipprovduti mill-mudell, u żomm logs tal-awditjar.

Fir-rigward tad-data: inkludi biss dak li teħtieġ it-talba f’structuredContent, ippubblika politika ta’ retenzjoni, onora t-talbiet ta’ tħassir, u aħbi data personali fil-logs. Fir-rigward tal-interfaċċa: il-komponent jaħdem f’iframe iżolat taħt Politika ta’ Sigurtà tal-Kontenut stretta, mingħajr aċċess għal window.alert, window.prompt, window.confirm, jew navigator.clipboard. Fir-rigward tal-operazzjonijiet: wettaq reviżjoni tas-sigurtà qabel it-tnedija, avża dwar fallimenti ripetuti ta’ awtentikazzjoni, u żomm id-dipendenzi aġġornati.

Ittestjar tal-awtentikazzjoni

Ibda b’tenant ta’ żvilupp li joħroġ tokens b’ħajja qasira, illimita l-aċċess għal testers affidabbli qabel ma tiftaħ għal kulħadd, u ppjana għar-revoka, ir-refresh, u bidliet fl-ambiti. Ittratta token nieqes jew skadut bħala nuqqas ta’ awtentikazzjoni, u pprovdi messaġġ ta’ żball utli. L-issettjar Auth fl-MCP Inspector jippermettilek issegwi l-fluss OAuth pass pass biex tara fejn jinkiser.

Punti Ewlenin

  • Data privata jew kitbiet: OAuth 2.1 skont l-ispeċifikazzjoni MCP, b’PKCE S256
  • Is-server jippubblika metadejta tar-riżorsa protetta u jwieġeb b’401 + WWW-Authenticate
  • CIMD huwa l-metodu ta’ reġistrazzjoni preferut; DCR u klijenti predefiniti jibqgħu għażliet
  • Interfaċċa ta’ rabt: securitySchemes għal kull għodda u żball li fih _meta["mcp/www_authenticate"]
  • Ivvverifika kull token fuq kull talba; l-mTLS jidentifika lil ChatGPT, l-OAuth jidentifika lill-utent