Konfigurieren Sie die Nachrichtenauthentifizierung für eingehende Kommunikation

Anstelle von Basis- oder OAuth-Authentifizierung können Sie auch die Nachrichtenauthentifizierung für die Virtual Agent -API konfigurieren. Die Nachrichtenauthentifizierung umfasst die Konfiguration von statischen oder Hash-Token, das Einrichten der Anbieterauthentifizierung und das Festlegen der Kanalidentität.

Vorbereitungen

Führen Sie die Schritte unter Überprüfen Sie den eingehenden REST-Endpunkt, und konfigurieren Sie die eingehende Authentifizierung aus.

Erforderliche Rolle: Administrator

Prozedur

1. Konfigurieren Sie das Token, indem Sie je nach Tokentyp einen der folgenden Schritte ausführen:
   • Statisches Token:
     1. Navigieren Sie zu Alle, und geben Sie token_verification.list in das Filter ein.
     2. Klicken Sie auf Neu.
     3. Füllen Sie die Felder im Formular „Token-Verifizierungen“ aus.

        Feld	Beschreibung
        Name	Name des Authentifizierungstokens, z.  B. B2BTestAppAuthToken.
        Beschreibung	Beschreibung des Authentifizierungstokens, z. B. Authentifizierungstoken für B2B-Testanwendungen.
        Token	Geben Sie ein Authentifizierungstoken ein, das Sie mit einer beliebigen allgemeinen Programmier- oder Skriptsprache generiert haben, oder klicken Sie in den zugehörigen Links auf Sicheres Token generieren.

     4. Klicken Sie auf Absenden.
   • Hash-Token:
     1. Navigieren Sie zu Alle, und geben Sie im Filter hash_message_verification.list ein.
     2. Klicken Sie auf Neu.
     3. Füllen Sie die Felder im Formular „Hash-Nachrichtenverifizierung“ aus.

        Felder	Beschreibung
        Name	Name des Authentifizierungstokens, z.  B. B2BTestAppAuthToken.
        Beschreibung	Beschreibung des Authentifizierungstokens, z. B. Authentifizierungstoken für B2B-Testanwendungen.
        Geheimer Schlüssel	Authentifizierungstoken (zufällige Zeichenfolge).

     4. Klicken Sie auf Absenden.
2. Richten Sie die Anbieterauthentifizierung für die tokenbasierte Authentifizierung ein.
   1. Navigieren Sie zu Alle, und geben Sie im Filter message_auth.list ein.
   2. Klicken Sie auf Neu.
   3. Füllen Sie die Felder im Formular „Nachrichtenauthentifizierung“ aus.

      Feld	Beschreibung
      Name	Name der Nachrichtenauthentifizierung, z.  B. B2B-Auth-Token.
      Anbieter	Name des Anbieters
      Gruppenname	Nicht erforderlich.
      Serviceportal	Nicht erforderlich.
      Verifizierung der eingehenden Nachricht	Wählen Sie das von Ihnen erstellte statische Token oder Hash-Nachrichtentoken aus.
      Erstellung der ausgehenden Nachricht	Dieses Feld wird derzeit in der Virtual Agent API nicht unterstützt. Wählen Sie das von Ihnen erstellte statische Token oder Hash-Nachrichtentoken aus.
      Ausgehender Servicetoken	Dieses Feld wird derzeit in der Virtual Agent API nicht unterstützt.

   4. Klicken Sie auf Absenden.
3. Legen Sie die Kanalidentität fest.
   1. Navigieren Sie zu Alle, und geben Sie im Filter sys_cs_provider_application.list ein.
   2. Wählen Sie den Datensatz „VA-Bot zu Bot-Anbieter-Anwendung“ aus, um ihn zu öffnen.
   3. Suchen Sie im Formular „Identität des Anbieterkanals“ das Feld Nachrichtenauthentifizierung, und wählen Sie die zuvor eingerichtete Nachrichtenauthentifizierung aus.

      

   4. Klicken Sie auf Aktualisieren.
4. Senden Sie nur für die auf dem Hash-Token basierende Authentifizierung die x-b2b-Signatur in den Anforderungsheadern.
   Der Wert ist der HmacSHA1 -codierte Wert der Anforderungsnutzlast, der das in der Instanz ServiceNow erstellte Token verwendet. Führen Sie in Postman beispielsweise die folgenden Schritte aus:
   1. Legen Sie in den Headern die x-b2b-Signatur auf {{hashValue}}fest.

      

   2. Legen Sie im Bereich „Skript vor der Anforderung“ das Token wie folgt fest:

      pm.environment.set('hashValue', CryptoJS.HmacSHA1(JSON.stringify(JSON.parse(request.data)), '<insert your token>').toString(CryptoJS.enc.Hex));

      

Nächste Maßnahme

Konfigurieren Sie den REST-Endpunkt der Ausgabeantwort und die ausgehende Authentifizierung für die Virtual Agent -API