Fíordheimhniú agus Slándáil
Ar an leathanach seo
- Cé a bhfuil gá le fíordheimhniú aige
- Cad a éilíonn an sonraíocht
- Conas a chláraíonn ChatGPT mar chliaint
- An sruth atá le feiceáil ag an úsáideoir
- Ag dearbhú cé na huirlisí a éilíonn cuntas
- Gach comhartha a fhíorú
- ChatGPT a shainaithint mar an cliant
- Prionsabail slándála OpenAI
- Fíordheimhniú a thástáil
- Príomhphointí
An ceacht athscríofa ar an 3 Samhain, 2026 bunaithe ar dhoiciméadú Fíordheimhniú agus Slándáil & Príobháideachas breiseáin OpenAI. Chuir an leagan roimhe seo síos ar fhíordheimhniú eochair API agus cumraíocht
authi manifest nach bhfuil ann; ní féidir le ChatGPT eochair API saincheaptha a thaispeáint agus leanann sé an sruth údaraithe atá sainithe sa sonraíocht MCP (OAuth 2.1). Foinse: Fíordheimhniú · Slándáil & Príobháideachas.
Cé a bhfuil gá le fíordheimhniú aige
Is féidir le go leor freastalaithe MCP oibriú gan ainm i mód léamh-amháin. Mar sin féin, caithfidh aon fhreastalaí a nochtann sonraí sonraithe don úsáideoir nó a dhéanann oibríochtaí scríofa an t-úsáideoir a fhíordheimhniú. Leanann an conradh údaraithe an sonraíocht MCP, atá comhionann i ChatGPT agus i Codex: sruth OAuth 2.1 ina bhfuil trí ghníomhaire i gceist.
- An freastalaí acmhainne: Do fhreastalaí MCP, a nochtann uirlisí agus a fhíoraíonn an chomhartha rochtana ar gach iarratas.
- An freastalaí údaraithe: Do sholáthraí céannachta, a eisíonn comharthaí agus a fhoilsíonn a mhéiteashonraí aimsithe.
- An cliant: Óstach OpenAI (ChatGPT nó Codex), ag gníomhú thar ceann an úsáideora.
Molann OpenAI go láidir brath ar sholáthraí céannachta bunaithe seachas fíordheimhniú a thógáil ón mbun; léiríonn a ndoiciméadú go sonrach Auth0 agus Stytch.
Cad a éilíonn an sonraíocht
Méiteashonraí Acmhainne Cosanta. Caithfidh do fhreastalaí MCP doiciméad a fhoilsiú, mar shampla ag https://your-mcp.example.com/.well-known/oauth-protected-resource, ina bhfuil a aitheantóir canónach (resource), a fhreastalaithe údaraithe (authorization_servers), agus go roghnach na scóip a dtacaítear leo (scopes_supported). Nuair a thagann iarratas gan fhíordheimhniú bailí, caithfidh an freastalaí freagairt le 401 Unauthorized agus ceanncheathrú a threoraíonn chuig an doiciméad seo:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Méiteashonraí Freastalaí Údaraithe, suite ag /.well-known/oauth-authorization-server nó /.well-known/openid-configuration, caithfidh siad an t-eisitheoir (issuer), na críochphointí údaraithe agus comharthaí, agus code_challenge_methods_supported ina bhfuil S256 a áireamh. Gan é seo, ní thacaítear leis an bhfreastalaí MCP, toisc go bhfuil PKCE éigeantach.
An paraiméadar resource ó cheann ceann. Cuireann ChatGPT resource=… le hiarratais údaraithe agus comharthaí. Caithfidh do fhreastalaí údaraithe é seo a chóipeáil isteach sa chomhartha (go minic mar an maíomh aud), agus caithfidh do fhreastalaí MCP diúltú d’aon chomhartha nach eisíodh go sonrach dó.
Conas a chláraíonn ChatGPT mar chliaint
Tá trí mhodh ann atá ag obair le chéile. Is é CIMD (Client ID Metadata Documents) an modh is fearr: úsáideann ChatGPT URL doiciméid mhéiteashonraí atá óstáilte ar HTTPS mar an client_id, a léann do fhreastalaí údaraithe. Cumasaigh é seo trí client_id_metadata_document_supported: true a fhoilsiú. Tacaíonn ChatGPT le dhá mhodh fíordheimhnithe ag an gcríochphointe comharthaí: none (cliant poiblí cosanta ag PKCE) agus private_key_jwt (maíomh sínithe is féidir a fhíorú leis an eochair phoiblí a d’fhoilsigh ChatGPT). Tá Clárú Dinimiciúil Cliant (DCR) fós indéanta má fhoilsíonn tú registration_endpoint: cláraíonn ChatGPT uair amháin in aghaidh an naisc agus athúsáideann sé an cliant sin. Is é cliant OAuth réamhshainithe an tríú rogha.
Maidir le hathsheoladh, cóipeáil an URI beacht a thaispeántar ar an leathanach bainistíochta freastalaí MCP i ChatGPT isteach i liosta ceadaithe do fhreastalaí údaraithe. Braitheann an URI seo ar thacaíocht d’Aitheantas Eisitheora (RFC 9207, an paraiméadar iss a fhilltear i ngach freagra údaraithe).
An sruth atá le feiceáil ag an úsáideoir
- Léann ChatGPT méiteashonraí na hacmhainne cosanta ó do fhreastalaí.
- Sainaithníonn sé é féin mar chliaint OAuth (trí CIMD, DCR, nó cliant réamhshainithe).
- Ar an gcéad ghla ar uirlis chosanta, tosaíonn sé an sruth cód údaraithe + PKCE: logálann an t-úsáideoir isteach agus tugann sé toiliú do na scóip a iarradh.
- Malartaíonn ChatGPT an cód le comhartha agus ceanglaíonn sé leis na hiarratais MCP ina dhiaidh sin (
Authorization: Bearer …). - Fíoraíonn do fhreastalaí an comhartha ar gach iarratas sula ndéanann sé an uirlis a fhorghníomhú.
Ag dearbhú cé na huirlisí a éilíonn cuntas
Ní thaispeánann ChatGPT a chomhéadan nascadh cuntais ach amháin má chuireann do fhreastalaí in iúl go bhfuil OAuth ar fáil nó ag teastáil. Éilíonn sé seo an dá leath: méiteashonraí agus earráid rúntíme.
Ar dtús, na méiteashonraí: dearbhaíonn gach uirlis a polasaí i _meta.securitySchemes. Ciallaíonn noauth gur féidir gla a chur air gan ainm, ach éilíonn oauth2 comhartha leis na scóip a léirítear. Má dhearbhaíonn tú an dá cheann, cuireann sé in iúl gur féidir leis an uirlis tosú gan chuntas, ach osclaíonn an nascadh feidhmiúlacht bhreise. Dearbhaigh é seo in aghaidh na huirlise, fiú má leanann an freastalaí iomlán an polasaí céanna.
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
}
);
Sa dara háit, an earráid rúntíme: nuair a bhíonn an comhartha in easnamh nó neamhbhailí, caithfidh an uirlis toradh earráide a thabhairt ar ais ina bhfuil _meta["mcp/www_authenticate"] le paraiméadair error agus error_description. Is é an t-ábhar seo a spreagann an comhéadan logála isteach i ndáiríre. Is é verifyToken do fheidhm fíoraithe; soláthraíonn SDKanna MCP Python agus TypeScript cabhair chun é a scríobh.
Gach comhartha a fhíorú
Nuair a bheidh an sruth críochnaithe, ceanglaíonn ChatGPT an comhartha mar atá sé le gach iarratas. Déileáil leis mar rud nach bhfuil muinín ann agus déan gach fíorú freastalaí acmhainne caighdeánach tú féin: bailíochtú sínithe ag baint úsáide as eochracha a d’fhoilsigh do fhreastalaí údaraithe (JWKS) agus an maíomh iss; bailíocht ama (exp, nbf); lucht féachana (aud nó resource) agus scóip riachtanacha; agus ina dhiaidh sin do chuid rialacha gnó féin. Ar theip: fill 401 agus ceanncheathrú WWW-Authenticate, a atosóidh an sruth OAuth.
ChatGPT a shainaithint mar an cliant
Chun a fhíorú go dtagann iarratas i ndáiríre ó ChatGPT, tá dhá mhodh ann. Taispeánann ChatGPT teastas cliant arna bhainistiú ag OpenAI le linn an naisc TLS (mTLS). Fíoraigh go ndéanann sé slabhrú leis an údarás idirmheánach a d’fhoilsigh OpenAI, go bhfuil sé bailí le haghaidh fíordheimhniú cliant, agus go bhfuil an dnsName mtls.prod.connectors.openai.com aige. Ná déan méarlorg an teastais duilleoige a phionnú, toisc go bhféadfadh OpenAI é a rothlú. Is féidir leat scagadh a dhéanamh bunaithe ar raonta seoltaí IP a foilsíodh freisin. Déanann mTLS fíordheimhniú ar ChatGPT; déanann OAuth fíordheimhniú ar an úsáideoir.
Ní thacaíonn ChatGPT le ceadanna meaisín-go-meaisín (client credentials, cuntais seirbhíse, maímh JWT bearer), eochracha API saincheaptha, ná teastais mTLS arna soláthar ag an gcliant.
Prionsabail slándála OpenAI
- An pribhléid is lú: Iarr ach na scóip, an stóráil, agus an rochtain líonra atá riachtanach.
- Toiliú sainráite: Caithfidh úsáideoirí a thuiscint cathain atá siad ag nascadh cuntais nó ag tabhairt rochtana scríofa; úsáid deimhnithe ón óstach le haghaidh gníomhartha millteacha.
- Cosaint i doimhneacht: Glac leis go sroichfidh instealltaí praschuir agus ionchuir mhailíseacha do fhreastalaí. Fíoraigh gach ionchur taobh an fhreastalaí, fiú iad siúd a sholáthraíonn an tsamhail, agus coinnigh logaí iniúchta.
Maidir le sonraí: ná cuir san áireamh ach an méid a theastaíonn don iarratas i structuredContent, foilsigh polasaí coinneála, urramaigh iarratais scriosta, agus mascáil sonraí pearsanta i logaí. Maidir leis an gcomhéadan: rithann an chomhpháirt i iframe leithlisithe faoi Bheartas Slándála Ábhair (CSP) dian, gan rochtain ar window.alert, window.prompt, window.confirm, nó navigator.clipboard. Maidir le hoibríochtaí: déan athbhreithniú slándála roimh sheoladh, tabhair foláireamh maidir le teipeanna fíordheimhnithe arís agus arís eile, agus coinnigh spleáchais cothrom le dáta.
Fíordheimhniú a thástáil
Tosaigh le tionónta forbartha a eisíonn comharthaí gearrthéarmacha, srianta rochtana do thástálaithe iontaofa sula n-osclaítear suas é, agus déan pleanáil do chúlghairm, athnuachan, agus athruithe scóip. Déileáil le comhartha atá in easnamh nó as dáta mar easpa fíordheimhnithe, ag soláthar teachtaireachta earráide cabhrach. Ceadaíonn na socruithe Auth in MCP Inspector duit an sruth OAuth a rianú céim ar chéim chun a fheiceáil cá bhfuil sé ag briseadh.
Príomhphointí
- Sonraí príobháideacha nó scríbhinní: OAuth 2.1 de réir shonraíocht MCP, le PKCE
S256 - Foilsíonn an freastalaí méiteashonraí acmhainne cosanta agus freagraíonn sé le
401+WWW-Authenticate - Is é CIMD an modh clárúcháin is fearr; fanann DCR agus cliain réamhshainithe mar roghanna
- Comhéadan nascadh:
securitySchemesin aghaidh na huirlise agus earráid ina bhfuil_meta["mcp/www_authenticate"] - Fíoraigh gach comhartha ar gach iarratas; sainaithníonn mTLS ChatGPT, sainaithníonn OAuth an t-úsáideoir