Konfigurieren Sie die Nachrichtenauthentifizierung für eingehende Kommunikation
Sie können die Nachrichtenauthentifizierung für konfigurieren Virtual Agent API anstelle von Standard oder OAuth. Die Nachrichtenauthentifizierung umfasst die Konfiguration von statischen Token oder Hash-Token, die Einrichtung der Anbieterauthentifizierung und die Festlegung der Kanalidentität.
Vorbereitungen
Erforderliche Rolle: Administrator
Prozedur
-
Konfigurieren Sie das Token, indem Sie je nach Tokentyp einen der folgenden Schritte ausführen:
- Statisches Token:
- Navigieren Sie zu Alle , Und geben Sie dann ein Token_Verification.list Im Filter.
- Klicken Sie auf Neu.
- Füllen Sie die Felder im Formular „Token-Verifizierungen“ aus.
Feld Beschreibung Name Name des Authentifizierungstoks, z. B. B2BTestAppAuthToken . Beschreibung Beschreibung des Authentifizierungstoks, z. B. B2B – Anwendungsauthentifizierungstoken wird getestet . Token Geben Sie ein Authentifizierungstoken ein, das Sie mit einer beliebigen allgemeinen Programmiersprache oder Skriptsprache generiert haben, oder klicken Sie auf Sicheres Token Generieren In den zugehörigen Links. - Klicken Sie auf Absenden.
- Hash-Token:
- Navigieren Sie zu Alle , Und geben Sie dann ein Hash_message_Verification.list Im Filter.
- Klicken Sie auf Neu.
- Füllen Sie die Felder im Formular „Hash-Nachrichtenverifizierung“ aus.
Felder Beschreibung Name Name des Authentifizierungstoks, z. B. B2BTestAppAuthToken . Beschreibung Beschreibung des Authentifizierungstoks, z. B. B2B – Anwendungsauthentifizierungstoken wird getestet . Geheimnis Authentifizierungstoken (zufällige Zeichenfolge). - Klicken Sie auf Absenden.
- Statisches Token:
-
Richten Sie die Anbieterauthentifizierung für die tokenbasierte Authentifizierung ein.
- Navigieren Sie zu Alle , Und geben Sie dann ein Message_auth.list Im Filter.
- Klicken Sie auf Neu.
-
Füllen Sie die Felder im Formular „Nachrichtenauthentifizierungen“ aus.
Feld Beschreibung Name Name der Nachrichtenauthentifizierung, z. B. B2B-Authentifizierungstoken . Anbieter Name des Anbieters. Gruppenname Nicht erforderlich. Serviceportal Nicht erforderlich. Verifizierung der eingehenden Nachricht Wählen Sie das statische Token oder das Hash-Nachrichten-Token aus, das Sie erstellt haben. Erstellung der ausgehenden Nachricht Dieses Feld wird derzeit in nicht unterstützt Virtual Agent API. Wählen Sie das statische Token oder das Hash-Nachrichten-Token aus, das Sie erstellt haben. Ausgehender Servicetoken Dieses Feld wird derzeit in nicht unterstützt Virtual Agent API. - Klicken Sie auf Absenden.
-
Legen Sie die Kanalidentität fest.
- Navigieren Sie zu Alle , Und geben Sie dann ein sys_cs_Provider_Application.list Im Filter.
- Wählen Sie aus VA-Bot-zu-Bot-Provider-Anwendung Datensatz zum Öffnen.
-
Suchen Sie im Formular „Identität des Anbieterkanals“ nach Nachrichtenauthentifizierung Feld und wählen Sie die Nachrichtenauthentifizierung aus, die Sie zuvor eingerichtet haben.
- Klicken Sie auf Aktualisieren.
-
Senden Sie nur für die Hash-Token-basierte Authentifizierung X-b2b-Signatur In den Anforderungsheadern.
Der Wert ist HmacSHA1Codierter Wert der Anforderungsnutzlast, der das in erstellte Token verwendet ServiceNow Instanz. Führen Sie beispielsweise in Postman die folgenden Schritte aus:
-
Legen Sie in den Kopfzeilen die fest X-b2b-Signatur Bis
{{Hashvalue}}. -
Legen Sie das Token im Bereich Vorabanforderungsskript wie folgt fest:
pm.environment.set('hashValue', CryptoJS.HmacSHA1(JSON.stringify(JSON.parse(request.data)), '<insert your token>').toString(CryptoJS.enc.Hex));
-
Legen Sie in den Kopfzeilen die fest X-b2b-Signatur Bis