Autentifikācija un drošība
Šajā lapā
Nodarbība pārrakstīta 2026. gada 3. novembrī, balstoties uz OpenAI dokumentāciju par spraudņu Autentifikāciju un Drošību un privātumu. Iepriekšējā versija aprakstīja API atslēgu autentifikāciju un
authkonfigurāciju neeksistējošā manifestā; ChatGPT nevar prezentēt pielāgotu API atslēgu, tā vietā tas ievēro MCP specifikācijā definēto autorizācijas plūsmu (OAuth 2.1). Avoti: Authentication · Security & Privacy.
Kam nepieciešama autentifikācija
Daudzi MCP serveri var darboties anonīmā tikai lasīšanas režīmā. Tomēr jebkuram serverim, kas izpauž lietotājam specifiskus datus vai veic rakstīšanas operācijas, ir jāautentificē lietotājs. Autorizācijas līgums seko MCP specifikācijai, kas ir identiska gan ChatGPT, gan Codex vidē: OAuth 2.1 plūsma, iesaistot trīs dalībniekus.
- Resursu serveris: Tavs MCP serveris, kas piedāvā rīkus un pārbauda piekļuves pilnvaru katrā pieprasījumā.
- Autorizācijas serveris: Tavs identitātes nodrošinātājs, kas izsniedz pilnvaras un publicē savu atklāšanas metadatus.
- Klients: OpenAI resursdators (ChatGPT vai Codex), kas darbojas lietotāja vārdā.
OpenAI stingri iesaka paļauties uz izveidotu identitātes nodrošinātāju, nevis veidot autentifikāciju no nulles; viņu dokumentācija konkrēti norāda uz Auth0 un Stytch.
Ko prasa specifikācija
Aizsargāta resursa metadati. Tavam MCP serverim ir jāpublicē dokuments, piemēram, adresē https://your-mcp.example.com/.well-known/oauth-protected-resource, kas satur tā kanonisko identifikatoru (resource), tā autorizācijas serverus (authorization_servers) un pēc izvēles atbalstītās scopes (scopes_supported). Ja ierodas pieprasījums bez derīgas autentifikācijas, serverim ir jāatbild ar 401 Unauthorized un galveni, kas norāda uz šo dokumentu:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Autorizācijas servera metadati, kas atrodas adresē /.well-known/oauth-authorization-server vai /.well-known/openid-configuration, ir jāiekļauj izdevējs (issuer), autorizācijas un pilnvaru beigu punkti, kā arī code_challenge_methods_supported, kas satur S256. Bez tā MCP serveris netiek atbalstīts, jo PKCE ir obligāts.
Parametrs resource no sākuma līdz beigām. ChatGPT pievieno resource=… autorizācijas un pilnvaru pieprasījumiem. Tavam autorizācijas serverim šī vērtība ir jāiekopē pilnvarā (bieži vien kā aud apgalvojums), un tavam MCP serverim ir jānoraida jebkura pilnvara, kas nav izsniegta tieši tam.
Kā ChatGPT reģistrējas kā klients
Pastāv trīs metodes. Vēlamā metode ir CIMD (Client ID Metadata Documents): ChatGPT izmanto HTTPS mitināta metadatu dokumenta URL kā client_id, ko nolasī tavs autorizācijas serveris. To iespējo, publicējot client_id_metadata_document_supported: true. ChatGPT atbalsta divas autentifikācijas metodes pilnvaru beigu punktā: none (publisks klients, ko aizsarga PKCE) un private_key_jwt (parakstīts apgalvojums, ko var pārbaudīt, izmantojot ChatGPT publicēto publisko atslēgu). Dinamiska klienta reģistrācija (DCR) joprojām ir iespējama, ja publicē registration_endpoint: ChatGPT reģistrējas vienu reizi katram savienojumam un atkārtoti izmanto šo klientu. Trešā opcija ir iepriekš definēts OAuth klients.
Attiecībā uz pāradresācijām, precīzi nokopē URI, kas parādīts ChatGPT MCP servera pārvaldības lapā, uz savu autorizācijas servera atļauto sarakstu. Šis URI ir atkarīgs no izdevēja identifikācijas atbalsta (RFC 9207, parametrs iss, kas tiek atgriezts katrā autorizācijas atbildē).
Lietotājam redzamā plūsma
- ChatGPT nolasī tava servera aizsargāta resursa metadatus.
- Tas identificē sevi kā OAuth klientu (izmantojot CIMD, DCR vai iepriekš definētu klientu).
- Pirmajā aizsargāta rīka izsaukumā tas iniciē autorizācijas koda + PKCE plūsmu: lietotājs piesakās un piekrīt pieprasītajām scopes.
- ChatGPT apmaina kodu pret pilnvaru un pievieno to turpmākajiem MCP pieprasījumiem (
Authorization: Bearer …). - Tavs serveris pārbauda pilnvaru katrā pieprasījumā pirms rīka izpildes.
Deklarēšana, kuriem rīkiem nepieciešams konts
ChatGPT rāda sava konta saistīšanas saskarni tikai tad, ja tavs serveris signalizē, ka OAuth ir pieejams vai nepieciešams. Tam ir nepieciešamas abas puses: metadati un izpildlaika kļūda.
Pirmkārt, metadati: katrs rīks deklarē savu politiku sadaļā _meta.securitySchemes. noauth nozīmē, ka to var izsaukt anonīmi, savukārt oauth2 pieprasa pilnvaru ar norādītajām scopes. Abu deklarēšana signalizē, ka rīku var sākt lietot bez konta, bet saistīšana atbloķē papildu funkcionalitāti. Deklarē to katram rīkam atsevišķi, pat ja viss serveris ievēro vienu un to pašu politiku.
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
}
);
Otrkārt, izpildlaika kļūda: ja pilnvara trūkst vai ir nederīga, rīkam ir jāatgriež kļūdas rezultāts, kas satur _meta["mcp/www_authenticate"] ar parametriem error un error_description. Šis saturs ir tas, kas faktiski izraisa pieteikšanās saskarnes parādīšanos. verifyToken ir tava pārbaudes funkcija; Python un TypeScript MCP SDK nodrošina palīglīdzekļus tās rakstīšanai.
Katras pilnvaras pārbaude
Kad plūsma ir pabeigta, ChatGPT pievieno pilnvaru katram pieprasījumam tādā pašā formā. Uztver to kā neuzticamu un pats veic visas standarta resursu servera pārbaudes: paraksta validāciju, izmantojot tava autorizācijas servera publicētās atslēgas (JWKS) un iss apgalvojumu; laika derīgumu (exp, nbf); auditoriju (aud vai resource) un nepieciešamās scopes; kam seko tavi paši biznesa noteikumi. Neveiksmes gadījumā: atgriez 401 un galveni WWW-Authenticate, kas restartē OAuth plūsmu.
ChatGPT identificēšana kā klienta
Lai pārbaudītu, vai pieprasījums patiešām nāk no ChatGPT, pastāv divas metodes. ChatGPT TLS savienojuma laikā uzrāda OpenAI pārvaldītu klienta sertifikātu (mTLS). Pārbaudi, vai tas veido ķēdi līdz starpposma iestādei, ko publicējusi OpenAI, vai tas ir derīgs klienta autentifikācijai un vai tam ir dnsName mtls.prod.connectors.openai.com. Nepiespraud lapas sertifikāta pirksta nospiedumu, jo OpenAI to var rotēt. Vari arī filtrēt, pamatojoties uz publicētajiem IP adrešu diapazoniem. mTLS autentificē ChatGPT; OAuth turpina autentificēt lietotāju.
ChatGPT neatbalsta mašīnas-mašīnai atļaujas (client credentials, servisa konti, JWT bearer apgalvojumi), pielāgotas API atslēgas vai klienta nodrošinātus mTLS sertifikātus.
OpenAI drošības principi
- Minimālās privilēģijas: Pieprasi tikai nepieciešamās scopes, krātuvi un tīkla piekļuvi.
- Skaidra piekrišana: Lietotājiem ir jāsaprot, kad tie saista kontu vai piešķir rakstīšanas piekļuvi; izmanto resursdatora apstiprinājumus destruktīvām darbībām.
- Aizsardzība vairākos līmeņos: Pieņem, ka uzvedības injicēšanas un ļaunprātīgas ievades sasniegs tavu serveri. Validē visas ievades servera pusē, pat tās, ko nodrošina modelis, un uzturi revīzijas žurnālus.
Attiecībā uz datiem: iekļauj structuredContent tikai to, kas pieprasījumam nepieciešams, publicē saglabāšanas politiku, ievēro dzēšanas pieprasījumus un maskē personas datus žurnālos. Attiecībā uz saskarni: komponents darbojas izolētā iframe ar stingru satura drošības politiku, bez piekļuves window.alert, window.prompt, window.confirm vai navigator.clipboard. Attiecībā uz operācijām: veic drošības pārskatu pirms palaišanas, brīdini par atkārtotiem autentifikācijas neveiksmes gadījumiem un uzturi atkarības atjauninātas.
Autentifikācijas testēšana
Sāc ar izstrādes nomnieku, kas izsniedz īslaicīgas pilnvaras, ierobežo piekļuvi uzticamiem testētājiem pirms atvēršanas un plāno atsaukšanu, atsvaidzināšanu un scopes izmaiņas. Uztveri trūkstošu vai beiguies derīguma termiņam pilnvaru kā autentifikācijas trūkumu, sniedzot noderīgu kļūdas ziņojumu. MCP Inspector sadaļā Auth ļauj soli pa solim izsekot OAuth plūsmai, lai redzētu, kur tā neizdodas.
Galvenās atziņas
- Privāti dati vai rakstīšanas operācijas: OAuth 2.1 saskaņā ar MCP specifikāciju, ar PKCE
S256 - Serveris publicē aizsargāta resursa metadatus un atbild ar
401+WWW-Authenticate - CIMD ir vēlamā reģistrācijas metode; DCR un iepriekš definēti klienti paliek kā opcijas
- Saistīšanas saskarne:
securitySchemeskatram rīkam un kļūda, kas satur_meta["mcp/www_authenticate"] - Pārbaudi katru pilnvaru katrā pieprasījumā; mTLS identificē ChatGPT, OAuth identificē lietotāju