Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Authentifizierung und Sicherheit

Lektion 8 von 14 Aktualisiert am 3. November 2026 Entwickler
Auf dieser Seite
  1. Wer muss sich authentifizieren
  2. Was die Spezifikation verlangt
  3. Wie ChatGPT als Client registriert wird
  4. Der für den Benutzer sichtbare Ablauf
  5. Deklaration der Tools, die ein Konto erfordern
  6. Verifizierung jedes Tokens
  7. Identifizierung von ChatGPT als Client
  8. Sicherheitsprinzipien von OpenAI
  9. Testen der Authentifizierung
  10. Kernaussagen

Lektion am 3. November 2026 überarbeitet basierend auf der OpenAI-Dokumentation zu Authentifizierung und Sicherheit & Datenschutz. Die vorherige Version beschrieb die API-Schlüssel-Authentifizierung und eine auth-Konfiguration in einer nicht existierenden Manifestdatei. ChatGPT kann keinen eigenen API-Schlüssel präsentieren, sondern folgt stattdessen dem im MCP-Spezifikum definierten Autorisierungsablauf (OAuth 2.1). Quellen: Authentifizierung · Sicherheit & Datenschutz.

Wer muss sich authentifizieren

Viele MCP-Server können anonym im nur-lesenden Modus betrieben werden. Jeder Server, der jedoch datenschutzrelevante Benutzerdaten ausliefert oder Schreiboperationen durchführt, muss den Benutzer authentifizieren. Der Autorisierungsvertrag folgt der MCP-Spezifikation, die in ChatGPT und Codex identisch ist: Ein OAuth 2.1-Ablauf mit drei Akteuren.

  • Der Ressourcen-Server: Ihr MCP-Server, der Tools ausliefert und den Zugriffstoken bei jeder Anfrage verifiziert.
  • Der Autorisierungs-Server: Ihr Identitätsanbieter, der Tokens ausstellt und seine Entdeckungs-Metadaten veröffentlicht.
  • Der Client: Der OpenAI-Host (ChatGPT oder Codex), der im Namen des Benutzers handelt.

OpenAI empfiehlt dringend, auf einen etablierten Identitätsanbieter zurückzugreifen, anstatt die Authentifizierung von Grund auf selbst zu entwickeln; ihre Dokumentation verweist spezifisch auf Auth0 und Stytch.

Was die Spezifikation verlangt

Geschützte Ressourcendaten. Ihr MCP-Server muss ein Dokument veröffentlichen, beispielsweise unter https://your-mcp.example.com/.well-known/oauth-protected-resource, das seine kanonische Kennung (resource), seine Autorisierungs-Server (authorization_servers) und optional die unterstützten Bereiche (scopes_supported) enthält. Wenn eine Anfrage ohne gültige Authentifizierung eingeht, muss der Server mit 401 Unauthorized antworten und einen Header auf dieses Dokument verweisen:

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

Metadaten des Autorisierungs-Server, die sich unter /.well-known/oauth-authorization-server oder /.well-known/openid-configuration befinden, müssen den Aussteller (issuer), die Autorisierungs- und Token-Endpunkte sowie code_challenge_methods_supported mit S256 enthalten. Ohne dies ist der MCP-Server nicht unterstützt, da PKCE zwingend erforderlich ist.

Der resource-Parameter von Ende zu Ende. ChatGPT fügt resource=… zu Autorisierungs- und Token-Anfragen hinzu. Ihr Autorisierungs-Server muss dies in den Token übernehmen (häufig als aud-Claim), und Ihr MCP-Server muss jeden Token ablehnen, der nicht spezifisch für ihn ausgestellt wurde.

Wie ChatGPT als Client registriert wird

Drei Methoden koexistieren. Die bevorzugte Methode ist CIMD (Client ID Metadata Documents): ChatGPT verwendet die URL eines HTTPS-hosteten Metadokuments als client_id, die Ihr Autorisierungs-Server liest. Aktivieren Sie dies, indem Sie client_id_metadata_document_supported: true veröffentlichen. ChatGPT unterstützt am Token-Endpunkt zwei Authentifizierungsmethoden: none (öffentlicher Client, geschützt durch PKCE) und private_key_jwt (signierte Aussage, verifizierbar mit dem öffentlichen Schlüssel, den ChatGPT veröffentlicht). Dynamische Client-Registrierung (DCR) bleibt möglich, wenn Sie ein registration_endpoint veröffentlichen: ChatGPT registriert sich einmal pro Verbindung und nutzt diesen Client erneut. Ein vordefiniertes OAuth-Client ist die dritte Option.

Hinsichtlich Weiterleitungen kopieren Sie die exakte URI, die auf der MCP-Server-Verwaltungsseite in ChatGPT angezeigt wird, in die Erlaubnisliste Ihres Autorisierungs-Servers. Diese URI hängt von der Unterstützung für Issuer Identification (RFC 9207, der iss-Parameter, der in jeder Autorisierungsantwort zurückgegeben wird) ab.

Der für den Benutzer sichtbare Ablauf

  1. ChatGPT liest die geschützten Ressourcendaten Ihres Servers.
  2. Es identifiziert sich als OAuth-Client (über CIMD, DCR oder einen vordefinierten Client).
  3. Bei der ersten Aufruf eines geschützten Tools initiiert es den Authorization Code + PKCE-Ablauf: Der Benutzer meldet sich an und stimmt den angeforderten Bereichen zu.
  4. ChatGPT tauscht den Code gegen einen Token aus und fügt diesen an nachfolgende MCP-Anfragen an (Authorization: Bearer …).
  5. Ihr Server verifiziert den Token bei jeder Anfrage, bevor er das Tool ausführt.

Deklaration der Tools, die ein Konto erfordern

ChatGPT zeigt nur sein Konto-Verknüpfungs-Interface an, wenn Ihr Server signalisiert, dass OAuth verfügbar oder erforderlich ist. Dies erfordert beide Seiten: Metadaten und einen Laufzeitfehler.

Zuerst die Metadaten: Jedes Tool deklariert seine Richtlinie in _meta.securitySchemes. noauth bedeutet aufrufbar anonym, während oauth2 einen Token mit den angegebenen Bereichen erfordert. Die Deklaration beider signalisiert, dass das Tool ohne Konto gestartet werden kann, aber die Verknüpfung mehr Funktionalität freischaltet. Deklarieren Sie dies pro Tool, auch wenn der gesamte Server derselben Richtlinie folgt.

server.registerTool(
  "create_doc",
  {
    title: "Dokument erstellen",
    description: "Erstellt ein neues Dokument im Benutzerkonto.",
    inputSchema: { title: z.string().min(1) },
    _meta: { securitySchemes: [{ type: "oauth2", scopes: ["docs.write"] }] },
  },
  async ({ title }, extra) => {
    const token = await verifyToken(extra); // Signatur, iss, aud, exp, Bereiche
    if (!token) {
      return {
        isError: true,
        content: [{ type: "text", text: "Anmeldung erforderlich, um ein Dokument zu erstellen." }],
        _meta: {
          "mcp/www_authenticate": [
            'Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", error="insufficient_scope", error_description="Verknüpfen Sie Ihr Konto, um fortzufahren"',
          ],
        },
      };
    }
    // … Dokument für token.sub erstellen
  }
);

Zweitens der Laufzeitfehler: Wenn der Token fehlt oder ungültig ist, muss das Tool einen Fehler zurückgeben, der _meta["mcp/www_authenticate"] mit error und error_description-Parametern enthält. Dieser Inhalt ist das, was tatsächlich das Login-Interface auslöst. verifyToken ist Ihre Verifizierungsfunktion; die Python- und TypeScript-MCP-SDKs bieten Helfer für die Erstellung.

Verifizierung jedes Tokens

Sobald der Ablauf abgeschlossen ist, fügt ChatGPT den Token unverändert jeder Anfrage hinzu. Behandeln Sie ihn als unzuverlässig und führen Sie alle Standardverifizierungen für Ressourcen-Server selbst durch: Signaturvalidierung unter Verwendung der Schlüssel, die von Ihrem Autorisierungs-Server veröffentlicht wurden (JWKS) und dem iss-Claim; Gültigkeitszeitraum (exp, nbf); Zielgruppe (aud oder resource) und erforderliche Bereiche; gefolgt von Ihren eigenen Geschäftsregeln. Bei einem Fehler: Geben Sie 401 zurück und einen WWW-Authenticate-Header, der den OAuth-Ablauf neu startet.

Identifizierung von ChatGPT als Client

Um zu verifizieren, dass eine Anfrage tatsächlich von ChatGPT stammt, gibt es zwei Methoden. ChatGPT präsentiert ein von OpenAI verwaltetes Client-Zertifikat während der TLS-Verbindung (mTLS). Verifizieren Sie, dass es zur von OpenAI veröffentlichten Zwischenautorität gehört, für die Client-Authentifizierung gültig ist und den dnsName mtls.prod.connectors.openai.com aufweist. Pinnen Sie nicht den Fingerabdruck des Blattzertifikats, da OpenAI es rotieren kann. Sie können auch nach veröffentlichten IP-Bereichen filtern. mTLS authentifiziert ChatGPT; OAuth authentifiziert weiterhin den Benutzer.

ChatGPT unterstützt keine Maschine-zu-Machine-Berechtigungen (client credentials, Service-Accounts, JWT bearer-Aussagen), benutzerdefinierte API-Schlüssel oder Client-bereitgestellte mTLS-Zertifikate.

Sicherheitsprinzipien von OpenAI

  • Prinzip der geringsten Rechte: Fordern Sie nur die Bereiche, Speicher und Netzwerkkontakten, die notwendig sind.
  • Explizite Zustimmung: Benutzer müssen verstehen, wann sie ein Konto verknüpfen oder Schreibzugriff gewähren; verwenden Sie Host-Bestätigungen für destruktive Aktionen.
  • Verteidigung in der Tiefe: Gehen Sie davon aus, dass Prompt-Injektionen und bösartige Eingaben Ihren Server erreichen. Validieren Sie alle Eingaben serverseitig, auch solche, die vom Modell bereitgestellt werden, und führen Sie Audit-Logs.

Hinsichtlich Daten: Fügen Sie nur das hinzu, was die Anfrage benötigt, in structuredContent, veröffentlichen Sie eine Aufbewahrungsrichtlinie, honorieren Sie Löschanfragen und maskieren Sie personenbezogene Daten in Logs. Hinsichtlich der Schnittstelle: Das Komponente läuft in einem isolierten iframe unter einer strengen Content Security Policy, ohne Zugriff auf window.alert, window.prompt, window.confirm oder navigator.clipboard. Hinsichtlich Operationen: Führen Sie eine Sicherheitsprüfung durch, bevor Sie starten, alarmieren Sie bei wiederholten Authentifizierungsfehlern und halten Sie Abhängigkeiten aktuell.

Testen der Authentifizierung

Beginnen Sie mit einem Entwicklungsmieter, der kurzlebige Tokens ausstellt, beschränken Sie den Zugriff auf vertrauenswürdige Tester, bevor Sie ihn öffnen, und planen Sie für Widerruf, Aktualisierung und Bereichsänderungen. Behandeln Sie einen fehlenden oder abgelaufenen Token als fehlende Authentifizierung und geben Sie eine hilfreiche Fehlermeldung aus. Die Auth-Einstellungen in MCP Inspector ermöglichen es Ihnen, den OAuth-Ablauf Schritt für Schritt zu verfolgen, um zu sehen, wo er abbricht.

Kernaussagen

  • Private Daten oder Schreibvorgänge: OAuth 2.1 gemäß der MCP-Spezifikation, mit PKCE S256
  • Der Server veröffentlicht geschützte Ressourcendaten und antwortet mit 401 + WWW-Authenticate
  • CIMD ist die bevorzugte Registrierungsmethode; DCR und vordefinierte Clients bleiben Optionen
  • Verknüpfungs-Interface: securitySchemes pro Tool und ein Fehler, der _meta["mcp/www_authenticate"] enthält
  • Verifizieren Sie jeden Token bei jeder Anfrage; mTLS identifiziert ChatGPT, OAuth identifiziert den Benutzer