Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Autentisering och säkerhet

Lektion 8 av 14 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. Vem behöver autentisera sig
  2. Vad specifikationen kräver
  3. Hur ChatGPT registreras som klient
  4. Det användarvänliga flödet
  5. Deklarera vilka verktyg som kräver ett konto
  6. Verifiera varje token
  7. Identifiera ChatGPT som klient
  8. OpenAIs säkerhetsprinciper
  9. Testa autentisering
  10. Viktiga punkter

Lektionen omskriven den 3 november 2026 baserat på OpenAIs dokumentation om Autentisering samt Säkerhet och integritet för plugin-program. Den tidigare versionen beskrev autentisering med API-nyckel och en auth-konfiguration i en manifestfil som inte existerar; ChatGPT kan inte presentera en anpassad API-nyckel utan följer istället auktoriseringsflödet som definieras i MCP-specifikationen (OAuth 2.1). Källor: Authentication · Security & Privacy.

Vem behöver autentisera sig

Många MCP-servrar kan köras i skrivskyddat läge anonymt. Däremot måste varje server som exponerar användarspecifik data eller utför skrivoperationer autentisera användaren. Auktoriseringsavtalet följer MCP-specifikationen, vilken är identisk i ChatGPT och Codex: ett OAuth 2.1-flöde som involverar tre aktörer.

  • Resursservern: Din MCP-server, som exponerar verktyg och verifierar åtkomsttoken vid varje begäran.
  • Auktoriseringsservern: Din identitetsleverantör, som utfärdar token och publicerar sina upptäcktsmetadata.
  • Klienten: OpenAI-värden (ChatGPT eller Codex), som agerar på användarens vägnar.

OpenAI rekommenderar starkt att du förlitar dig på en etablerad identitetsleverantör istället för att bygga autentisering från grunden; deras dokumentation pekar specifikt på Auth0 och Stytch.

Vad specifikationen kräver

Metadata för skyddad resurs. Din MCP-server måste publicera ett dokument, exempelvis på https://your-mcp.example.com/.well-known/oauth-protected-resource, som innehåller dess kanoniska identifierare (resource), dess auktoriseringsservrar (authorization_servers) och valfritt de scopes som stöds (scopes_supported). När en begäran anländer utan giltig autentisering måste servern svara med 401 Unauthorized och en header som pekar på detta dokument:

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

Metadata för auktoriseringsserver, placerat på /.well-known/oauth-authorization-server eller /.well-known/openid-configuration, måste inkludera utfärdaren (issuer), auktoriserings- och token-slutpunkter, samt code_challenge_methods_supported som innehåller S256. Utan detta stöds inte MCP-servern, eftersom PKCE är obligatoriskt.

Parametern resource från början till slut. ChatGPT lägger till resource=… i auktoriserings- och tokenbegäranden. Din auktoriseringsserver måste kopiera detta in i token (ofta som påståendet aud), och din MCP-server måste avvisa varje token som inte utfärdats specifikt för den.

Hur ChatGPT registreras som klient

Tre metoder samexisterar. Den föredragna metoden är CIMD (Client ID Metadata Documents): ChatGPT använder URL:en till ett metadata-dokument som hostas via HTTPS som client_id, vilket din auktoriseringsserver läser. Aktivera detta genom att publicera client_id_metadata_document_supported: true. ChatGPT stöder två autentiseringsmetoder vid token-slutpunkten: none (publik klient skyddad av PKCE) och private_key_jwt (signerat påstående verifierbart med den publika nyckel som publiceras av ChatGPT). Dynamisk klientregistrering (DCR) förblir möjlig om du publicerar en registration_endpoint: ChatGPT registrerar sig en gång per anslutning och återanvänder den klienten. En fördefinierad OAuth-klient är det tredje alternativet.

När det gäller omdirigeringar kopierar du exakt den URI som visas på sidan för hantering av MCP-servrar i ChatGPT till din auktoriseringsservers tillåtna lista. Denna URI beror på stöd för identifiering av utfärdare (RFC 9207, parametern iss som returneras i varje auktoriseringssvar).

Det användarvänliga flödet

  1. ChatGPT läser din servers metadata för skyddad resurs.
  2. Det identifierar sig som en OAuth-klient (via CIMD, DCR eller en fördefinierad klient).
  3. Vid det första anropet till ett skyddat verktyg initierar det flödet authorization code + PKCE: användaren loggar in och godkänner de begärda scopes.
  4. ChatGPT byter ut koden mot en token och fäster den vid efterföljande MCP-begäranden (Authorization: Bearer …).
  5. Din server verifierar token vid varje begäran innan verktyget exekveras.

Deklarera vilka verktyg som kräver ett konto

ChatGPT visar bara sitt gränssnitt för kontolänkning om din server signalerar att OAuth är tillgängligt eller krävs. Detta kräver båda delarna: metadata och ett körningsfel.

Först, metadata: varje verktyg deklarerar sin policy i _meta.securitySchemes. noauth betyder att det kan anropas anonymt, medan oauth2 kräver en token med de angivna scopes. Att deklarera båda signalerar att verktyget kan starta utan ett konto, men att länkning låser upp mer funktionalitet. Deklarera detta per verktyg, även om hela servern följer samma policy.

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

För det andra, körningsfelet: när token saknas eller är ogiltig måste verktyget returnera ett felresultat som innehåller _meta["mcp/www_authenticate"] med parametrarna error och error_description. Det är detta innehåll som faktiskt utlöser inloggningsgränssnittet. verifyToken är din verifieringsfunktion; MCP SDK:n för Python och TypeScript tillhandahåller hjälpfunktioner för att skriva den.

Verifiera varje token

När flödet är klart fäster ChatGPT token som den är vid varje begäran. Behandla den som icke-litande och utför alla standardverifieringar för resursservrar själv: signaturvalidering med nycklar som publiceras av din auktoriseringsserver (JWKS) och påståendet iss; tidsvaliditet (exp, nbf); målgrupp (aud eller resource) och erforderliga scopes; följt av dina egna affärsregler. Vid misslyckande: returnera 401 och en WWW-Authenticate-header, vilket startar om OAuth-flödet.

Identifiera ChatGPT som klient

För att verifiera att en begäran verkligen kommer från ChatGPT finns två metoder. ChatGPT presenterar ett OpenAI-hanterat klientcertifikat under TLS-anslutningen (mTLS). Verifiera att det kedjar till den mellanliggande auktoritet som publiceras av OpenAI, är giltigt för klientautentisering och har dnsName mtls.prod.connectors.openai.com. Pinn inte fingeravtrycket för lövcertifikatet, eftersom OpenAI kan rotera det. Du kan också filtrera baserat på publicerade IP-adressintervall. mTLS autentiserar ChatGPT; OAuth fortsätter att autentisera användaren.

ChatGPT stöder inte maskin-till-maskin-behörigheter (client credentials, tjänstekonton, JWT bearer-påståenden), anpassade API-nycklar eller klientlevererade mTLS-certifikat.

OpenAIs säkerhetsprinciper

  • Minsta privilegium: Begär endast de scopes, den lagring och det nätverksåtkomst som behövs.
  • Explicit samtycke: Användare måste förstå när de länkar ett konto eller beviljar skrivåtkomst; använd värd-bekräftelser för destruktiva åtgärder.
  • Försvar på djupet: Anta att prompt-injektioner och skadliga indata når din server. Validera alla indata på serversidan, även de som tillhandahålls av modellen, och för granskningsloggar.

När det gäller data: inkludera endast det som begäran behöver i structuredContent, publicera en policy för datalagring, hedra raderingsbegäranden och maskera personuppgifter i loggar. När det gäller gränssnittet: komponenten körs i en isolerad iframe under en strikt Content Security Policy, utan åtkomst till window.alert, window.prompt, window.confirm eller navigator.clipboard. När det gäller operationer: genomför en säkerhetsgranskning innan lansering, avisera vid upprepade autentiseringsfel och håll beroenden uppdaterade.

Testa autentisering

Börja med en utvecklingsmiljö (tenant) som utfärdar kortlivade token, begränsa åtkomsten till betrodda testare innan du öppnar upp, och planera för återkallelse, uppdatering och ändringar av scopes. Behandla en saknad eller utgången token som brist på autentisering och ge ett hjälpsamt felmeddelande. Inställningarna Auth i MCP Inspector låter dig spåra OAuth-flödet steg för steg för att se var det bryter.

Viktiga punkter

  • Privat data eller skrivoperationer: OAuth 2.1 enligt MCP-specifikationen, med PKCE S256
  • Servern publicerar metadata för skyddad resurs och svarar med 401 + WWW-Authenticate
  • CIMD är den föredragna registreringsmetoden; DCR och fördefinierade klienter är fortfarande alternativ
  • Gränssnitt för länkning: securitySchemes per verktyg och ett fel som innehåller _meta["mcp/www_authenticate"]
  • Verifiera varje token vid varje begäran; mTLS identifierar ChatGPT, OAuth identifierar användaren