Wenn Ihre KI-Agenten sich mit ihrer eigenen Berechtigung bei externen Tools wie ServiceNow oder Salesforce authentifizieren sollen, konfigurieren Sie die ausgehende Authentifizierung mit 2-legged OAuth-Authentifizierungsanbietern (Clientanmeldedaten) im Authentifizierungsmanager für KI-Agentenidentitäten.
2-legged OAuth-Authentifizierungsanbieter verwalten Anmeldedaten und Tokens für Sie. So müssen Sie keinen benutzerdefinierten Code schreiben, um Authentifizierungsabläufe zu verarbeiten.
2-legged OAuth-Workflow
2-legged OAuth-Authentifizierungsanbieter verwenden die Identität des KI-Agenten und erfordern keine Nutzereinwilligung. Google verwaltet die Speicherung der Clientanmeldedaten. Wenn Sie das Agent Development Kit (ADK) verwenden, werden die resultierenden Zugriffstokens automatisch abgerufen und in die Header für den Toolaufruf eingefügt.
Hinweis
- Prüfen Sie, ob Sie die richtige Authentifizierungsmethode ausgewählt haben.
Aktivieren Sie die Agent Identity Connector API.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen.Rufen Sie die Client-ID und den Clientschlüssel der Drittanbieteranwendung ab, mit der Sie eine Verbindung herstellen möchten.
Prüfen Sie, ob Sie die erforderlichen Rollen haben, um diese Aufgabe auszuführen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwenden eines 2-legged OAuth-Authentifizierungsanbieters für KI-Agentenidentitäten benötigen:
-
Zum Erstellen von Authentifizierungsanbietern:
- IAM Connector-Administrator (
roles/iamconnectors.admin) - IAM Connector-Bearbeiter (
roles/iamconnectors.editor)
- IAM Connector-Administrator (
-
Zum Verwenden von Authentifizierungsanbietern:
- IAM Connector-Nutzer (
roles/iamconnectors.user) - Standardzugriff für KI-Agenten (
roles/aiplatform.agentDefaultAccess) - Kontextbearbeiter für KI-Agenten (
roles/aiplatform.agentContextEditor) - Vertex AI-Nutzer (
roles/aiplatform.user) - Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer)
- IAM Connector-Nutzer (
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen und Verwenden eines 2-legged OAuth-Authentifizierungsanbieters für KI-Agentenidentitäten erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen , um die notwendigen Berechtigungen anzuzeigen, die erforderlich sind:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Erstellen und Verwenden eines 2-legged OAuth-Authentifizierungsanbieters für KI-Agentenidentitäten erforderlich:
-
Zum Erstellen von Authentifizierungsanbietern:
iamconnectors.connectors.create -
Zum Verwenden von Authentifizierungsanbietern:
-
iamconnectors.connectors.retrieveCredentials -
aiplatform.endpoints.predict -
aiplatform.sessions.create
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
2-legged OAuth-Authentifizierungsanbieter erstellen
Erstellen Sie einen Authentifizierungsanbieter, um die Konfiguration und Anmeldedaten für Drittanbieteranwendungen zu definieren.
Verwenden Sie die Google Cloud Console oder die Google Cloud CLI, um einen 2-legged Auth-Bereitsteller zu erstellen.