Slack-Spoke einrichten

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

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

    Vorbereitungen

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

    Warum und wann dieser Vorgang ausgeführt wird

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

    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 Konfigurationsbeschreibungen hierkonfigurieren.

    Prozedur

    1. Erstellen Sie einen Slack -Arbeitsbereich.
      Informationen zum Erstellen eines Arbeitsbereichs finden Sie unter Erstellen eines Slack-Arbeitsbereichs. 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.Erstellen Sie eine App in Slack.
    5. Kopieren Sie auf der Seite „Grundlegende Informationen“ der Seite „App-Anmeldeinformationen“ die Werte Client-ID, Client-Secret und Signier-Secret Ihrer Slack-App, und notieren Sie sie.Anmeldeinformationen für die Slack-App.
      Weitere Informationen finden Sie im Schritt Client-ID und Geheimnis für später abrufen.
    6. Auf der Seite „OAuth und Berechtigungen“:
      1. Geben Sie die Instanz-URL ServiceNow in Umleitungs-URLs in folgendem Format an: https://<instance-name> .service-now.com/oauth_redirect.do .
      2. Fügen Sie diese Bots 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:history
        • 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 Spoke-Setup-Verfahren erfordert nur Bot-Benutzertoken. Sie können die Aktionen „Benutzer erstellen“ und „Benutzer deaktivieren“ nicht verwenden, während Sie die Bot-Token-Bereiche verwenden. Um diese Aktionen zu verwenden, müssen Sie ein Benutzertoken von Ihrem Slack-Accountabrufen.
    7. Erstellen Sie auf der Seite Slash Commands (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.
      Verwendungshinweis Liste der Parameter, die übergeben werden können. Beispiel: [operation] [table].

      Weitere Informationen finden Sie im Befehlsschritt Schrägstrich erstellen.

    8. Auf der Seite „Interaktivität und Kurzbefehle“:
      1. Aktivieren Sie Interaktivität, und geben Sie die Instanz-URL ServiceNow in der Anforderungs-URL in folgendem 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 den Wert post_message_now für Rückruf- IDein.
        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 erforderlichen Kanälen hinzu.
      Weitere Informationen finden Sie unter Bot für Ihren Arbeitsbereich erstellen.

    Fügen Sie Slack-Verbindung in Instanz ServiceNow hinzu

    Fügen Sie die Slack-Verbindung in Flow Designer 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. eine für jeden Slack-Arbeitsbereich.
      Slack-Speichenverbindung.
    3. Klicken Sie auf der Kachel „Slack-Speiche“ 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 für die 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 Umleitungs-URL, die in Ihrer Slack-App bereitgestellt wird. 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 der Instanz ServiceNow an

    Geben Sie die App-Details und den Signaturschlüssel von [ Slack in Ihrer Instanz von [ 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 Slack -Konfiguration. Geben Sie Signiergeheimnis ein.
      Signier-Secret Signier-Secret Ihrer Slack -App.
    4. Klicken Sie auf Aktualisieren.

    Konfigurieren Sie ausgehende Konfigurationen in der Instanz ServiceNow .

    Geben Sie Events 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 „Umsetzbare Nachricht veröffentlichen“ und „Genehmigungsnachricht veröffentlichen “ 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 ausgehende Standardkonfiguration, um sie 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 veröffentlicht 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 veröffentlicht wird.
      Schaltflächen Schaltflächen für die relevanten Benutzer, um Aktionen im Kanal Slack-Spoke auszuführen. Zum Beispiel eine Anforderung genehmigen oder ablehnen. Weitere Informationen zu Schaltflächen und deren Stil finden Sie unter Schaltflächenelement.
      Hinweis:
      Benutzer müssen über die erforderlichen Berechtigungen verfügen, um die erforderlichen Aktionen ausführen zu können. Beispielsweise muss der Benutzer über die erforderlichen Berechtigungen verfügen, um eine Anforderung zu genehmigen oder abzulehnen. Diese Berechtigungen basieren auf Benutzerrollen, die Benutzern in Ihrer ServiceNow -Instanz zugewiesen sind.
      Auswahlliste Ausgehende Slack-Auswahlen, 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 ausgehenden Genehmigungsnachrichtkonfiguration in der eingehenden Genehmigungsentscheidung bereitgestellt. Dadurch wird sichergestellt, dass bei Genehmigung oder Ablehnung der Anforderung der relevante Datensatz in Ihrer ServiceNow -Instanz aktualisiert wird.
    4. Klicken Sie auf Absenden.

    Konfigurieren Sie eingehende Entscheidungen in der Instanz ServiceNow .

    Geben Sie Events in Ihrer Slack-Spoke -Anwendung an, für die Aktionen in der ServiceNow -Instanz 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, um anzugeben, ob dies die Standardantwort ist. Die Standardantwort gilt, wenn die Bedingungen nicht erfüllt sind.
      1. Klicken Sie auf das Suchsymbol ( Suchsymbol).
      2. Wählen Sie den erforderlichen Subflow aus der Dokumentliste aus.
        Hinweis:
        Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow] lautet.
      Bedingung In Ihrer Slack -Anwendung zu erfüllende Bedingungen, für die Aktionen in der ServiceNow -Instanz ausgeführt werden müssen.
      Geben Sie zum Aktualisieren des relevanten Datensatzes in Ihrer Instanz ServiceNow 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 ausgehenden Genehmigungsnachrichtkonfiguration in der eingehenden Genehmigungsentscheidung bereitgestellt. Dadurch wird sichergestellt, dass bei Genehmigung oder Ablehnung der Anforderung der relevante Datensatz in Ihrer ServiceNow -Instanz aktualisiert wird.
    4. Klicken Sie auf Absenden.
      Wenn Events 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.
      Informationen zum Anzeigen von Modalen in Slack finden Sie unter Konfigurieren Sie Slack modale Elemente in der Instanz ServiceNow..