Автентикация и сигурност
На тази страница
Урокът е пренаписан на 3 ноември 2026 г. въз основа на документацията на OpenAI за Автентикация и Сигурност и поверителност на плъгините. Предишната версия описваше автентикация чрез API ключ и конфигурация
authв несъществуващ манифест; ChatGPT не може да представи персонализиран API ключ и вместо това следва потока на оторизация, дефиниран в спецификацията MCP (OAuth 2.1). Източници: Authentication · Security & Privacy.
Кой трябва да се автентикира
Много MCP сървъри могат да работят анонимно в режим само за четене. Въпреки това, всеки сървър, който излага данни, специфични за потребителя, или извършва операции на запис, трябва да автентикира потребителя. Договорът за оторизация следва спецификацията MCP, която е идентична в ChatGPT и Codex: поток OAuth 2.1, включващ три участника.
- Сървърът с ресурси: Вашият MCP сървър, който излага инструменти и проверява токена за достъп при всяка заявка.
- Сървърът за оторизация: Вашият доставчик на самоличност, който издава токени и публикува своите метаданни за откриване.
- Клиентът: Хостът на OpenAI (ChatGPT или Codex), действащ от името на потребителя.
OpenAI силно препоръчва да разчитате на утвърден доставчик на самоличност, вместо да изграждате автентикация от нулата; тяхната документация конкретно посочва Auth0 и Stytch.
Какво изисква спецификацията
Метаданни за защитен ресурс. Вашият MCP сървър трябва да публикува документ, например на адрес https://your-mcp.example.com/.well-known/oauth-protected-resource, съдържащ неговия каноничен идентификатор (resource), неговите сървъри за оторизация (authorization_servers) и по желание поддържаните обхвати (scopes_supported). Когато пристигне заявка без валидна автентикация, сървърът трябва да отговори с 401 Unauthorized и заглавка, сочеща към този документ:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Метаданни на сървъра за оторизация, разположени на /.well-known/oauth-authorization-server или /.well-known/openid-configuration, трябва да включват издателя (issuer), крайните точки за оторизация и токени, както и code_challenge_methods_supported, съдържащ S256. Без това MCP сървърът не се поддържа, тъй като PKCE е задължително.
Параметърът resource от край до край. ChatGPT добавя resource=… към заявките за оторизация и токени. Вашият сървър за оторизация трябва да копира това в токена (често като твърдение aud), а вашият MCP сървър трябва да отхвърли всеки токен, който не е издаден специално за него.
Как ChatGPT се регистрира като клиент
Съществуват три метода, които съвместно действат. Предпочитаният метод е CIMD (Client ID Metadata Documents): ChatGPT използва URL адреса на документ с метаданни, хостван чрез HTTPS, като client_id, който вашият сървър за оторизация прочита. Активирайте това, като публикувате client_id_metadata_document_supported: true. ChatGPT поддържа два метода за автентикация в крайната точка за токени: none (публичен клиент, защитен от PKCE) и private_key_jwt (подписано твърдение, което може да се провери с публичния ключ, публикуван от ChatGPT). Динамична регистрация на клиент (DCR) остава възможна, ако публикувате registration_endpoint: ChatGPT се регистрира веднъж на връзка и преизползва този клиент. Предварително дефиниран OAuth клиент е третата опция.
Що се отнася до пренасочванията, копирайте точно URI адреса, показан на страницата за управление на MCP сървъра в ChatGPT, в списъка с разрешени адреси на вашия сървър за оторизация. Този URI зависи от поддръжката на идентификация на издателя (RFC 9207, параметърът iss, върнат във всеки отговор за оторизация).
Потребителският поток
- ChatGPT прочита метаданните за защитения ресурс на вашия сървър.
- То се идентифицира като OAuth клиент (чрез CIMD, DCR или предварително дефиниран клиент).
- При първото извикване на защитен инструмент, то инициира потока код за оторизация + PKCE: потребителят влиза и дава съгласие за поисканите обхвати.
- ChatGPT разменя кода за токен и го прикачва към последващите MCP заявки (
Authorization: Bearer …). - Вашият сървър проверява токена при всяка заявка, преди да изпълни инструмента.
Деклариране на инструментите, изискващи акаунт
ChatGPT показва интерфейса си за свързване на акаунт само ако вашият сървър сигнализира, че OAuth е наличен или задължителен. Това изисква и двете половини: метаданни и грешка по време на изпълнение.
Първо, метаданните: всеки инструмент декларира своята политика в _meta.securitySchemes. noauth означава, че може да се извиква анонимно, докато oauth2 изисква токен с посочените обхвати. Декларирането и на двете сигнализира, че инструментът може да стартира без акаунт, но свързването отключва повече функционалност. Декларирайте това за всеки инструмент, дори ако целият сървър следва една и съща политика.
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
}
);
Второ, грешката по време на изпълнение: когато токенът липсва или е невалиден, инструментът трябва да върне резултат с грешка, съдържащ _meta["mcp/www_authenticate"] с параметрите error и error_description. Това съдържание е това, което действително задейства интерфейса за вход. verifyToken е вашата функция за проверка; SDK за MCP за Python и TypeScript предоставят помощни средства за написването ѝ.
Проверка на всеки токен
След приключване на потока, ChatGPT прикачва токена както е към всяка заявка. Третирайте го като ненадежден и извършете всички стандартни проверки на сървъра с ресурси сами: валидиране на подписа, използвайки ключове, публикувани от вашия сървър за оторизация (JWKS) и твърдението iss; времева валидност (exp, nbf); аудитория (aud или resource) и изискваните обхвати; последвано от вашите собствени бизнес правила. При неуспех: върнете 401 и заглавка WWW-Authenticate, което рестартира OAuth потока.
Идентифициране на ChatGPT като клиент
За да проверите дали заявката наистина идва от ChatGPT, съществуват два метода. ChatGPT представя сертификат на клиент, управляван от OpenAI по време на TLS връзката (mTLS). Проверете дали той верижно води до междинния орган, публикуван от OpenAI, дали е валиден за автентикация на клиент и дали има dnsName mtls.prod.connectors.openai.com. Не фиксирайте отпечатъка на листовия сертификат, тъй като OpenAI може да го ротира. Можете също да филтрирате въз основа на публикуваните диапазони от IP адреси. mTLS автентикира ChatGPT; OAuth продължава да автентикира потребителя.
ChatGPT не поддържа разрешения машина-към-машина (client credentials, сервизни акаунти, JWT bearer твърдения), персонализирани API ключове или mTLS сертификати, предоставени от клиента.
Принципи за сигурност на OpenAI
- Най-малко привилегии: Искайте само обхватите, съхранението и мрежовия достъп, които са необходими.
- Изрично съгласие: Потребителите трябва да разбират кога свързват акаунт или предоставят достъп за запис; използвайте потвърждения от хоста за деструктивни действия.
- Защита в дълбочина: Приемете, че инжекции на подкани и злонамерени входове ще достигнат до вашия сървър. Валидирайте всички входове на страната на сървъра, дори тези, предоставени от модела, и поддържайте одитни логове.
Що се отнася до данните: включвайте в structuredContent само това, от което заявката се нуждае, публикувайте политика за задържане, спазвайте исканията за изтриване и маскирайте личните данни в логовете. Що се отнася до интерфейса: компонентът работи в изолиран iframe под строга Политика за сигурност на съдържанието, без достъп до window.alert, window.prompt, window.confirm или navigator.clipboard. Що се отнася до операциите: извършете преглед на сигурността преди стартиране, предупреждавайте при повторни неуспешни опити за автентикация и поддържайте зависимостите актуални.
Тестване на автентикацията
Започнете с тестов наемател, който издава токени с кратък срок на валидност, ограничете достъпа до доверени тестери, преди да го отворите, и планирайте отмяна, обновяване и промени в обхватите. Третирайте липсващ или изтекъл токен като липса на автентикация, предоставяйки полезно съобщение за грешка. Настройките Auth в MCP Inspector ви позволяват да проследявате OAuth потока стъпка по стъпка, за да видите къде се прекъсва.
Ключови изводи
- Лични данни или записи: OAuth 2.1 според спецификацията MCP, с PKCE
S256 - Сървърът публикува метаданни за защитен ресурс и отговаря с
401+WWW-Authenticate - CIMD е предпочитаният метод за регистрация; DCR и предварително дефинираните клиенти остават опции
- Интерфейс за свързване:
securitySchemesна инструмент и грешка, съдържаща_meta["mcp/www_authenticate"] - Проверявайте всеки токен при всяка заявка; mTLS идентифицира ChatGPT, OAuth идентифицира потребителя