---
sourceDocument: Xanadu-Konversations-Schnittstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-Konversations-Schnittstellen

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Konfigurieren Sie die Nachrichtenauthentifizierung für eingehende Kommunikation

# Konfigurieren Sie die Nachrichtenauthentifizierung für eingehende Kommunikation {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

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](https://servicenow-prod.fluidtopics.net/wnWqdc~ET2lzo_z8cJvpPQ "Navigieren Sie nach der Installation der API Virtual Agent zur Ressource „Geskriptete REST-API“, um den Endpunkt zu überprüfen und die Authentifizierung einzurichten.") aus.

Erforderliche Rolle: admin

## 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 <kbd class="ph userinput">Sie token_verification.list</kbd> in das Filter ein.
     2. Klicken Sie auf Neu.
     3. Füllen Sie die Felder im Formular „Token-Verifizierungen" aus.  
        {#set-up-message-auth-va-api__table_lml_hbq_kqb__entry__2}

        | Feld | Beschreibung |
        |-|-|
        | Name | Name des Authentifizierungstokens, z. B. <kbd class="ph userinput">B2BTestAppAuthToken</kbd>. |
        | Beschreibung | Beschreibung des Authentifizierungstokens, z. B. Authentifizierungstoken für <kbd class="ph userinput">B2B-Testanwendungen</kbd>. |
        | 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. |
        [ ]

        {#set-up-message-auth-va-api__table_lml_hbq_kqb}
     4. Klicken Sie auf Absenden.
     {#set-up-message-auth-va-api__ol_m4d_kcx_v4b}
   * Hash-Token:
     1. Navigieren Sie zu Alle, und geben Sie im Filter <kbd class="ph userinput">hash_message_verification.list</kbd> ein.
     2. Klicken Sie auf Neu.
     3. Füllen Sie die Felder im Formular „Hash-Nachrichtenverifizierung" aus.  
        {#set-up-message-auth-va-api__table_zwd_nbq_kqb__entry__2}

        | Felder | Beschreibung |
        |-|-|
        | Name | Name des Authentifizierungstokens, z. B. <kbd class="ph userinput">B2BTestAppAuthToken</kbd>. |
        | Beschreibung | Beschreibung des Authentifizierungstokens, z. B. Authentifizierungstoken für <kbd class="ph userinput">B2B-Testanwendungen</kbd>. |
        | Geheimer Schlüssel | Authentifizierungstoken (zufällige Zeichenfolge). |
        [ ]

        {#set-up-message-auth-va-api__table_zwd_nbq_kqb}
     4. Klicken Sie auf Absenden.
     {#set-up-message-auth-va-api__ol_o4d_kcx_v4b}
2. Richten Sie die Anbieterauthentifizierung für die tokenbasierte Authentifizierung ein.
   1. Navigieren Sie zu Alle, und geben Sie im Filter <kbd class="ph userinput">message_auth.list</kbd> ein.
   2. Klicken Sie auf Neu.
   3. Füllen Sie die Felder im Formular „Nachrichtenauthentifizierung" aus.  
      {#set-up-message-auth-va-api__table_ujp_1dp_kqb__entry__2}

      | Feld | Beschreibung |
      |-|-|
      | Name | Name der Nachrichtenauthentifizierung, z. B. <kbd class="ph userinput">B2B-Auth-Token</kbd>. |
      | Provider | Name des Anbieters |
      | Gruppenname | Nicht erforderlich. |
      | Service Portal | 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. |
      [ ]

      {#set-up-message-auth-va-api__table_ujp_1dp_kqb}
   4. Klicken Sie auf Absenden.
   {#set-up-message-auth-va-api__substeps_pqj_dqv_4tb}
3. Legen Sie die Kanalidentität fest.
   1. Navigieren Sie zu Alle, und geben Sie im Filter <kbd class="ph userinput">sys_cs_provider_application.list</kbd> 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.
   {#set-up-message-auth-va-api__substeps_wnh_hqv_4tb}
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));

   {#set-up-message-auth-va-api__substeps_aj4_4rv_4tb}

## Nächste Maßnahme

[Konfigurieren Sie den REST-Endpunkt der Ausgabeantwort und die ausgehende Authentifizierung für die Virtual Agent -API](https://servicenow-prod.fluidtopics.net/~UpXvrc6bRCcSTcz8ma0WQ "Geben Sie die URL des ausgehenden Endpunkts an, an die die Virtual Agent -Antworten gesendet werden. Konfigurieren Sie die ausgehende Authentifizierung.")