OAuth-Verbindungen verstehen

OAuth ist ein unterstütztes Authentifizierungsmuster, aber jeder Zustimmungsfluss muss für das genaue Ziel konfiguriert und getestet werden. Ein erfolgreicher API-Schlüsseltest stellt keine OAuth-Bereitschaft für einen bestimmten AI-Client her.

Identifizieren Sie die beiden Einwilligungsbeziehungen#

Ein KI-Client kann sich mithilfe eines unterstützten Erstanbieter-Anmeldeablaufs bei einer Installation oder ihrem Gateway authentifizieren. Unabhängig davon benötigt ein Server möglicherweise OAuth-Anmeldeinformationen, um einen Upstream-Dienst im Namen eines Geschäftskontos aufzurufen.

Diese sind nicht austauschbar. Ein vorgelagerter OAuth-Broker benötigt möglicherweise Anbieterautorisierung und Token-Endpunkte, Client-Registrierungsdetails und -Bereiche. Stellen Sie eine bestehende API-Schlüsselverbindung nicht auf OAuth um, nur weil der Client eine OAuth-Schaltfläche anbietet.

Befolgen Sie den vereinbarten Verbindungsablauf#

Verwenden Sie bei der Übergabe die genaue Server- oder Gateway-Adresse. Wenn ein Browser-Zustimmungsbildschirm geöffnet wird, überprüfen Sie die Domäne, das Konto und den angeforderten Zugriff. Autorisieren Sie mithilfe des normalen Prozesses des Anbieters nur die vorgesehene Zielgruppe und den vorgesehenen Umfang.

Senden Sie keine Rückruf-URL mit einem Autorisierungscode zur Unterstützung oder fügen Sie sie nicht in eine KI-Konversation ein. Behalten Sie Token und Client-Geheimnisse in der unterstützten verschlüsselten Konfigurationsroute.

Nach Zustimmung überprüfen#

Bestätigen Sie, dass der KI-Client in einen verbundenen Zustand zurückkehrt, nur die vorgesehenen Tools erkennt und die vereinbarte schreibgeschützte Aktion im richtigen Konto ausführt. Wenn die Aktualisierung Teil des konfigurierten Ablaufs ist, überprüfen Sie dies, anstatt davon auszugehen, dass die anfängliche Verbindung auf unbestimmte Zeit bestehen bleibt.

Wenn die Einwilligung scheitert#

Notieren Sie die Phase und den korrigierten Fehler. Eine nicht übereinstimmende Weiterleitungsadresse, ein nicht unterstützter Registrierungsablauf, ein falsches Konto, ein fehlender Bereich oder eine abgelaufene Upstream-Genehmigung können unterschiedliche Korrekturen erfordern. Deaktivieren Sie nicht die Authentifizierung, akzeptieren Sie keine Zertifikatwarnung und verwenden Sie als Workaround nicht das Token einer anderen Person erneut.