Add-on | AI Agents – Advanced |
Der Integration Builder unterstützt Standardautorisierungstypen, einschließlich API-Schlüssel, Inhaber-Token, Benutzername und Kennwort sowie OAuth 2.0. Je nach den Anforderungen und Workflows Ihrer Organisation reicht die Standardautorisierung jedoch möglicherweise nicht aus. Aus diesem Grund unterstützt der Integration Builder auch einen angepassten Integrationstyp, der nur die Authentifizierung ermöglicht und mit den Authentifizierungs- und Autorisierungslösungen Ihrer Organisation funktioniert.
In diesem Beitrag werden folgende Themen behandelt:
- Überblick über die angepasste Autorisierung
- Konfigurieren der angepassten Autorisierung
- Testen der angepassten Autorisierung
Überblick über die angepasste Autorisierung
Die angepasste Auth-Only-Integration stellt eine Anfrage für ein Token und dessen Ablaufzeit, die sie dann an die Daten- oder Hauptintegration zur Autorisierung weiterleitet, um anschließend die Anfrage für die Daten zu stellen.
Der Ablauf der angepassten Autorisierung sieht insgesamt wie folgt aus:
- Autorisierungsanfrage: Die konfigurierte Nur-Authentifizierungs-Integration sendet eine Anfrage an den Server und bittet um die Berechtigung zum Abrufen eines Zugriffstokens. Wenn der Server die Anfrage (von AI Agents – Advanced) authentifiziert, autorisiert er den Abruf des Zugriffstokens und, falls verfügbar, dessen Ablaufzeit.
- Handhabung des Tokens: Nachdem der Server mit dem Zugriffstoken geantwortet hat, speichert die Integration zwei wichtige Informationen: den Token-Parameter selbst und seinen expiresIn-Parameter, der bestimmt, wie lange das Token gültig ist.
- Übergeben des Tokens an die Datenintegration: Diese beiden Parameter (token und expiresIn) werden an den nächsten Schritt, d. h. die Datenintegration, übergeben. Das Token wird zur Authentifizierung nachfolgender Anfragen der Datenintegration verwendet. Das Token wird gesetzt und intern gehandhabt, ist aber zu keinem Zeitpunkt für die Sitzungs- oder Konversationsdaten sichtbar.
- Angepasste Autorisierungsanforderung für Daten: Mit dem vorhandenen Zugriffstoken ist die Datenintegration inzwischen berechtigt, die erforderlichen Daten abzurufen, die zur Anreicherung der Konversation genutzt werden.
Das folgende Flussdiagramm veranschaulicht den Ablauf der angepassten Autorisierung.
Konfigurieren der angepassten Autorisierung
Die angepasste Autorisierung wird bei der normalen Erstellung von Integrationen im Integration Builder konfiguriert.
So konfigurieren Sie die angepasste Autorisierung im Integration Builder
- Klicken Sie im Hauptmenü auf API-Integrationen.
- Klicken Sie oben rechts auf Add Integration.
- Rufen Sie das Fenster Integration hinzufügen auf.
- Geben Sie im Feld Integrationsname einen aussagekräftigen Namen ein.
- (Optional) Geben Sie im Feld Beschreibung eine Beschreibung der Integration ein, damit Sie sich besser daran erinnern können, wozu sie dient.
- Wählen Sie Als „Auth-Only“-Integration einrichtenaus.
- Klicken Sie auf Speichern.
- Setzen Sie den Mauszeiger in der linken Seitenleiste unter Szenarienauf Fehlerund wählen Sie das Optionsmenü (
) aus und klicken Sie auf Löschen. Für die angepasste Autorisierung benötigen Sie nur Erfolgsszenarien. Fallback-Szenarien können nicht gelöscht werden.
- Erstellen Sie auf der Seite Erfolgsszenarien zwei Sitzungsparameter (durch Klicken auf die Schaltfläche + ) mit den folgenden Details:
- Token
- Key: token (muss genau so geschrieben werden)
- Query: Geben Sie einen Wert ein, der das Token definiert. Beispiel: data.access_token
- expiresIn
- Key: expiresIn (muss genau so geschrieben werden)
-
Query: Geben Sie einen Wert ein, der die Gültigkeit des Tokens definiert. Beispiel: data.expires_in
Der Ablauf des Tokens ist möglicherweise nicht Teil Ihrer Datenantwort. In diesem Fall können Sie einen beliebigen Wert (in Sekunden) fest codieren. Beispiel: 3600
Wir empfehlen dringend, eine Ablauffrist für das Token festzulegen. Falls beim Testen ein Fehler auftritt, ist dies die Zeit, die Sie warten müssen, bevor ein neues Token ausgestellt wird. Das Token ist unbegrenzt gültig. Während der Fehlerbehebung kann daher kein neues Token ausgestellt werden.
- Token
- Erstellen Sie die Integration wie gewohnt. Wenn Sie Hilfe brauchen, lesen Sie den Beitrag Erklärungen zum Integration Builder.
- Wählen Sie in der linken Seitenleiste unter Umgebungeneine Umgebung aus (z. B. Production).
- Wählen Sie in der Registerkarte Autorisierung im Dropdownfeld Autorisierungstyp die Option Angepasstaus.
- Wählen Sie im Dropdownfeld API-Autorisierungsintegration die oben erstellte angepasste Auth-Only-Integration aus.
- Wählen Sie die Registerkarte Kopfzeilen aus und klicken Sie auf Kopfzeile hinzufügen.
- Füllen Sie die folgenden Felder aus:
- Schlüssel: Autorisierung
-
Wert: Bearer {{apiToken}} (muss genau so geschrieben werden)
- Klicken Sie auf Speichern.
Testen der angepassten Autorisierung
Nachdem Sie Ihre angepasste angepasste Auth-Only-Integration konfiguriert haben, sollten Sie sie testen. Weitere Hilfe finden Sie unter Test Functionality.
Fehlerbehebung-StatusCode: null
Außerdem kann beim Testen Ihrer Integration möglicherweise die Meldung „statusCode: null“ erscheinen, wie in der Abbildung unten dargestellt:
Stellen Sie zunächst sicher, dass Ihre angepasste Auth-Only-Integration gemäß den oben beschriebenen Schrittenrichtig konfiguriert wurde.
Notieren Sie sich als Nächstes, wo der Fehler auftritt. Falls das Problem in der Auth-Integration auftritt, ist möglicherweise etwas nicht korrekt konfiguriert oder die URL, an die Sie die Anfrage richten, ist nicht korrekt. In diesem Fall empfehlen wir Ihnen, sich mit Ihren Ingenieuren in Verbindung zu setzen, da diese möglicherweise mehr Informationen zur Ursache des Problems liefern können.
Wenn Sie die oben beschriebenen Schritte ausgeführt haben und dieser Fehler weiterhin auftritt, warten Sie, bis das Token abläuft, und versuchen Sie es dann erneut.
Wenn Sie alle diese Schritte zur Fehlerbehebung durchgeführt haben und die Integration immer noch nicht funktioniert, wenden Sie sich an Ihren CSM.
0 Kommentare
Anmelden, um einen Kommentar zu hinterlassen.