Slack-Spoke einrichten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer

    • Integrieren Sie die Instanz ServiceNow und Ihren Slack-Account, indem Sie in Slack eine anwenderdefinierte OAuth-Anwendung erstellen, um ServiceNow -Anforderungen zu authentifizieren.

    Vorbereitungen

    • Fordern Sie ein IntegrationHub-Abonnement an.
    • Aktivieren Sie Slack-Spoke.
    • Slack-Account.
    • Fügen Sie der Tabelle „Benutzer“ [sys_user] Ihrer Instanz ServiceNow Slack-Anwender hinzu, wobei „E- Mail “ der eindeutige Bezeichner ist.
    • Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Das hier beschriebene Verfahren zum Einrichten der Spoke erfordert nur Bot-Benutzertoken. Sie können die Aktionen „Anwender erstellen“ und „Anwender deaktivieren“ nicht verwenden, während Sie die Bot-Token-Bereiche verwenden. Um diese Aktionen verwenden zu können, müssen Sie ein Benutzertoken von Ihrem Slack-Kontoabrufen.

    Konfigurieren Sie die App Slack

    Erstellen Sie eine benutzerdefinierte OAuth-Anwendung für Ihren Slack-Arbeitsbereich, um die OAuth 2.0-Authentifizierung mit der Slack-Spoke zu aktivieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte in Ihrem Slack-Account durch. Sie können eine App erstellen oder eine vorhandene App gemäß den hierbeschriebenen Konfigurationen konfigurieren.

    Prozedur

    1. Erstellen Sie einen Slack -Arbeitsbereich.
      Informationen zum Erstellen eines Arbeitsbereichs finden Sie unter Slack-Arbeitsbereich erstellen.Die folgende Abbildung zeigt einen typischen Slack-Arbeitsbereich.Slack-Arbeitsbereich
    2. Navigieren Sie zur Slack API- Konsole.
    3. Klicken Sie auf App erstellen.
    4. Wählen Sie im Fenster „App erstellen“ die am besten geeignete Methode zum Erstellen der App aus.Erstellt eine App in Slack.
    5. Kopieren Sie auf der Seite „App-Anmeldeinformationen“ auf der Seite „Basisinformationen“ die Werte „Client-ID“, „Client-Geheimnis“ und „Signier-Geheimnis“ Ihrer Slack-App, und notieren Sie sie.Anmeldeinformationen für die Slack-App.
      Weitere Informationen finden Sie im Schritt Client-ID und Geheimschlüssel für später abrufen.
    6. Auf der Seite „OAuth und Berechtigungen“:
      1. Geben Sie die URL der Instanz ServiceNow unter Umleitungs-URLs in diesem Format an: https://.<instance-name> .service-now.com/oauth_redirect.do
      2. Fügen Sie diese Bot- Tokenbereichehinzu:
        • Kanäle:Verlauf
        • Kanäle:verwalten
        • Kanäle:lesen
        • chat:write
        • chat:write.customize
        • Gruppen:lesen
        • im:read
        • mpim:read
        • Gruppen:Verlauf
        • groups:write
        • im:verlauf
        • im:write
        • mpim:history
        • mpim:write
        • users:read
        • users:read.email
        • Dateien:lesen

        Weitere Informationen finden Sie unter Bereiche und Berechtigungen.

        Hinweis:
        Das hier beschriebene Verfahren zum Einrichten der Spoke erfordert nur Bot-Benutzertoken. Sie können die Aktionen „Anwender erstellen“ und „Anwender deaktivieren“ nicht verwenden, während Sie die Bot-Token-Bereiche verwenden. Um diese Aktionen verwenden zu können, müssen Sie ein Benutzertoken von Ihrem Slack-Kontoabrufen.
    7. Erstellen Sie auf der Seite „Schrägstrichbefehle“ einen Befehl, und geben Sie diese Werte an:
      Feld Wert
      Befehl /now
      Anforderungs-URL https://<instance-name> .service-now.com/api/sn_slack_ah_v2/command_service/<slack-app-name>
      Kurzbeschreibung Beschreibung des Befehls.
      Nutzungshinweis Liste der Parameter, die übergeben werden können. Beispiel: [operation] [table].

      Weitere Informationen hierzu finden Sie im Befehlsschritt „Schrägstrich erstellen“.

    8. Auf der Seite „Interaktivität und Verknüpfungen“:
      1. Aktivieren Sie Interaktivität, und geben Sie die Instanz-URL ServiceNow unter Anforderungs-URL in diesem Format an: https://. <instance-name> .service-now.com/api/sn_slack_ah_v2/slack/<slack-app-name>/interactivepayload
        Weitere Informationen finden Sie im Abschnitt „ App für Benutzerinteraktionen vorbereiten “.
      2. Erstellen Sie eine Verknüpfung, die in Nachrichten angezeigt wird, und geben Sie für Rückruf- ID den Wert post_message_nowein.
        Weitere Informationen finden Sie im Abschnitt „ Verknüpfungen erstellen“.
    9. Erstellen Sie einen Slack-Bot, und fügen Sie ihn Ihrer Slack-App und den gewünschten Kanälen hinzu.
      Weitere Informationen finden Sie unter Bots für Ihren Arbeitsbereich erstellen.

    Fügen Sie die Slack-Verbindung in der Instanz ServiceNow hinzu

    Fügen Sie die Slack-Verbindung in Workflow-Studio hinzu, um die Slack-Spoke zu konfigurieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Verbindungen.
      Hinweis:
      Sie können mehrere Verbindungen für Ihre Slack-Spoke hinzufügen. Einer pro Slack-Arbeitsbereich
      Slack-Spoke-Verbindung.
    3. Klicken Sie auf der Slack-Spoke-Kachel auf Details anzeigen.
    4. Klicken Sie auf der Seite „Verbindungen“ auf Konfigurieren.
      Im Popup-Fenster wird ein leeres Formular „Verbindung konfigurieren“ angezeigt.
    5. Füllen Sie diese Werte im Formular aus.
      Tabelle : 1. Formular „Verbindung konfigurieren“.
      Feld Beschreibung
      Verbindungs-URL URL zum Herstellen einer Verbindung mit Slack. Geben Sie https://slack.com ein.
      Anmeldeinformationsname Name zur Identifizierung des Anmeldeinformationsdatensatzes. Beispiel: Slack-Anmeldeinformationen
      OAuth-Name Name zur Identifizierung des OAuth-Datensatzes. Beispiel: Slack OAuth.
      OAuth-Client-ID Client-ID Ihrer Slack-App.
      Geheimer OAuth-Schlüssel Geheimer Clientschlüssel Ihrer Slack-App.
      OAuth-Umleitungs-URL In Ihrer Slack-App bereitgestellte Umleitungs-URL. Dieser Wert wird automatisch ausgefüllt.
    6. Klicken Sie auf Configure and Get OAuth Token (Konfigurieren und OAuth-Token abrufen).
    7. Klicken Sie im Popup-Fenster auf Zulassen.
      Das OAuth-Zugriffstoken wird für die Slack-Spoke generiert.

    Geben Sie den Signaturschlüssel in Instanz ServiceNow an

    Geben Sie die Details der App Slack und den Signaturschlüssel in Ihrer Instanz ServiceNow an, um Anforderungen von ServiceNowzu authentifizieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Slack > Slack-Konfigurationen.
    2. Öffnen Sie den Standarddatensatz.
      Sie können auch einen neuen Datensatz erstellen, um andere Signaturschlüssel bereitzustellen.
    3. Füllen Sie diese Werte im Formular aus.
      Tabelle : 2. Formular „Slack-Konfiguration“.
      Feld Beschreibung
      Slack App Name Ihrer Slack -App.
      Hinweis:
      Dieser Name muss mit dem App-Namen übereinstimmen, der beim Erstellen der App Slack angegeben wurde.
      Verbindungsalias Verbindungsalias, der der ausgewählten App auf der Registerkarte „ Verbindungen “ zugeordnet ist.
      Eigenschaftsname Name der Konfiguration Slack. Geben Sie das Signier-Secret ein.
      Signier-Secret Signier-Secret Ihrer App Slack.
    4. Klicken Sie auf Aktualisieren.

    Konfigurieren Sie ausgehende Konfigurationen in der Instanz ServiceNow .

    Geben Sie Ereignisse in der Instanz ServiceNow an, für die Aktionen in Ihrer Anwendung Slack-Spoke ausgeführt werden müssen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Die ausgehenden Konfigurationen stellen eine Vorlage für die Aktionen „Nachricht umsetzbare Nachricht“ und „Nachricht nach Genehmigung “ und Subflowsbereit. Sie können die standardmäßigen ausgehenden Konfigurationen anpassen oder eine ausgehende Konfiguration gemäß Ihren Anforderungen erstellen.

    Prozedur

    1. Navigieren zu Alle > Slack > Ausgehende Konfigurationen.
    2. Klicken Sie auf Neu, um eine ausgehende Konfigurationsvorlage zu erstellen, oder klicken Sie auf die standardmäßige ausgehende Konfiguration, um diese zu konfigurieren.
    3. Füllen Sie diese Werte im Formular „Ausgehende Konfiguration“ aus.
      Tabelle : 3. Formular „Ausgehende Konfiguration“.
      Feld Beschreibung
      Name Name zur Identifizierung des ausgehenden Konfigurationsdatensatzes.
      Nachrichtentitel Titel der Nachricht, die im Kanal Slack-Spoke gepostet wird. Beispiel: Ausstehende Genehmigungen für {0}.
      Zieltabelle ServiceNow Tabelle, aus der die Datensatzdetails abgerufen werden.
      Felder Felder aus der Tabelle ServiceNow, deren Werte in der Nachricht angezeigt werden müssen, die im Kanal Slack-Spoke gepostet wird.
      Schaltflächen Schaltflächen für die relevanten Anwender zum Ausführen von Aktionen im Kanal Slack-Spoke Beispiel: Genehmigen Sie oder Ablehnen Sie eine Anforderung. Weitere Informationen zu Schaltflächen und ihrer Gestaltungfinden Sie unter Schaltflächenelement .
      Hinweis:
      Benutzer müssen über die erforderlichen Berechtigungen verfügen, um die erforderlichen Aktionen auszuführen. Beispielsweise muss der Benutzer über die erforderlichen Berechtigungen verfügen, um eine Anforderung zu genehmigen oder abzulehnen. Diese Berechtigungen basieren auf Anwenderrollen, die Benutzern in Ihrer Instanz ServiceNow zugewiesen sind.
      Auswahlliste Ausgehende Auswahlmöglichkeiten in Slack, z. B. Ablehnen. Diese Optionen werden als Liste im Slack-Kanal angezeigt.
      Aktions-ID Eindeutiger Bezeichner der ausgehenden Konfiguration.
      Hinweis:
      Aktions-ID der ausgehenden Konfiguration muss in der relevanten eingehenden Entscheidung verwendet werden, um den Flow abzuschließen. Beispielsweise wird die Aktions-ID der Konfiguration der ausgehenden Genehmigungsnachricht in der eingehenden Genehmigungsentscheidung angegeben. Dadurch wird sichergestellt, dass bei Genehmigung oder Ablehnung einer Anforderung eine Aktualisierung des entsprechenden Datensatzes in Ihrer Instanz ServiceNow vorgenommen wird.
    4. Klicken Sie auf Absenden.

    Konfigurieren Sie eingehende Entscheidungen in der Instanz ServiceNow .

    Geben Sie Ereignisse in Ihrer Anwendung Slack-Spoke an, für die Aktionen in der Instanz ServiceNow ausgeführt werden müssen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Slack > Eingehende Entscheidungen.
    2. Klicken Sie auf Neu.
    3. Füllen Sie diese Werte im Formular „Entscheidung“ aus.
      Tabelle : 4. Formular „Entscheidung“
      Feld Beschreibung
      Bezeichnung Name zur Identifizierung der eingehenden Entscheidung.
      Antwort Subflow, der ausgelöst werden muss, wenn die angegebenen Bedingungen erfüllt sind.
      Standardantwort Option zum Angeben, ob dies die Standardantwort ist. Die Standardantwort ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
      1. Klicken Sie auf das Suchsymbol ( Suchsymbol).
      2. Wählen Sie den gewünschten Subflow aus der Dokumentliste aus.
        Hinweis:
        Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow] lautet.
      Bedingung Bedingungen, die in Ihrer Anwendung Slack erfüllt werden müssen und für die Aktionen in der Instanz ServiceNow ausgeführt werden müssen.
      Um den relevanten Datensatz in Ihrer Instanz ServiceNow zu aktualisieren, geben Sie den Aktions-ID -Wert an, den Sie beim Konfigurieren ausgehender Konfigurationen in der Bedingung angegeben haben.
      Hinweis:
      Aktions-ID der ausgehenden Konfiguration muss in der relevanten eingehenden Entscheidung verwendet werden, um den Flow abzuschließen. Beispielsweise wird die Aktions-ID der Konfiguration der ausgehenden Genehmigungsnachricht in der eingehenden Genehmigungsentscheidung angegeben. Dadurch wird sichergestellt, dass bei Genehmigung oder Ablehnung einer Anforderung eine Aktualisierung des entsprechenden Datensatzes in Ihrer Instanz ServiceNow vorgenommen wird.
    4. Klicken Sie auf Absenden.
      Wenn Ereignisse die in der Richtlinie angegebenen Bedingungen erfüllen, wird der zugehörige Subflow ausgelöst.
      Hinweis:
      Diese eingehenden Entscheidungen werden in den Entscheidungstabellen gespeichert. Benutzer werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.
      Wenn Sie modale Elemente in Slack anzeigen möchten, lesen Sie Modale ServiceNow in Instanz Slack konfigurieren.