„Verbinden“-Aktion im Slack-package

Authentifizieren Sie sich bei Slack, indem Sie eine Control Room OAuth2-Verbindung verwenden, und erstellen Sie eine wiederverwendbare Slack-Sitzung für spätere Aktionen in der Automatisierung.

Voraussetzung

Bevor Sie die Verbinden-Aktion verwenden, müssen Sie zunächst eine Slack-App erstellen und konfigurieren, das erforderliche Bot-Token generieren und eine OAuth-Verbindung im Control Room einrichten, indem Sie die folgende Voraussetzung erfüllen:

Slack-App erstellen
  • Gehen Sie zum Slack Developer Portal: https://api.slack.com/apps
  • Navigieren Sie zu Ihre Apps > Neue App erstellen
  • Wählen Sie Von Grund auf.

    App erstellen

  • Geben Sie Folgendes ein:
    • App-Name: Zum Beispiel AA Slack-Integration
    • Wählen Sie einen Arbeitsbereich aus, in dem Sie Ihre App entwickeln möchten: Wählen Sie den Slack-Arbeitsbereich aus, in dem die App verwendet wird

    Arbeitsbereich auswählen

  • Klicken Sie auf App erstellen.
OAuth und Berechtigungen konfigurieren
  • Nachdem die App erstellt wurde, navigieren Sie im linken Bereich zu OAuth und Berechtigungen.
  • Navigieren Sie zum Abschnitt Umleitungs-URLs. Geben Sie im Feld Umleitungs-URLs die Callback-URL aus den Verbindungseinstellungen von Control Room ein.
  • Navigieren Sie zum Abschnitt Bereich.

Bot-Token-Berechtigungen hinzufügen: Fügen Sie im Abschnitt Bereich die erforderlichen Berechtigungen entsprechend Ihrem Anwendungsfall hinzu. Zum Hinzufügen klicken Sie auf OAuth-Berechtigungsbereich hinzufügen.

Einige Beispiele sind unten aufgeführt:
  • chat:write → Nachrichten senden als @AA Slack-Integration
  • channels:read → Grundlegende Informationen über öffentliche Kanäle in einem Arbeitsbereich anzeigen
  • channels:history → Nachrichten und andere Inhalte in öffentlichen Kanälen anzeigen, zu denen die AA Slack-Integration hinzugefügt wurde
  • groups:read → Zeigen Sie grundlegende Informationen über private Kanäle an, zu denen die AA Slack-Integration hinzugefügt wurde
  • im:read → Zeigen Sie grundlegende Informationen über Direktnachrichten an, zu denen die AA Slack-Integration hinzugefügt wurde.
Anmerkung:
  • Achten Sie darauf, dass Sie Ihre Berechtigungen sorgfältig auswählen, da unzureichende Berechtigungen später dazu führen können, dass Aktionen fehlschlagen.
  • Derzeit wird nur die Bot-Token-Authentifizierung unterstützt.

OAuth 2.0-Verbindung konfigurieren: Weitere Informationen zur Erstellung einer benutzerdefinierten Domäne finden Sie unter Konfigurieren Sie die OAuth 2.0-Verbindung im Control Room.

Einstellungen

  • Im Feld OAuth-Verbindung klicken Sie auf Aussuchen, um aus den verfügbaren, vom Control Room verwalteten OAuth2-Anmeldeinformationen auszuwählen.
    Anmerkung: Achten Sie darauf, dass die OAuth2-Verbindung im Control Room gültig und aktiv ist.
  • Klicken Sie auf das Dropdown-Menü Providertyp, um einen verfügbaren oder benutzerdefinierten Provider auszuwählen.
  • Im Feld Verbindungsname wählen Sie das spezifische OAuth-Verbindungsobjekt aus.

    Dieses Feld ist deaktiviert, bis ein Anbietertyp ausgewählt wurde.

  • Wählen Sie im Feld Token-Typ je nach dem zur Ausführungszeit verwendeten Token eine der folgenden Optionen aus.
    • Freigegeben: für ein globales Token.

      Ein Zugriffstoken des Typs „Freigegeben“ wird erstellt, wenn eine Verbindung zum Control Room hergestellt ist. Dieses Zugriffstoken wird als Anmeldedaten gespeichert. Wenn Sie Ihre Automatisierung ausführen, wird das Zugriffstoken in der Automatisierung über den im Control Room eingerichteten Anbietertyp für Unternehmensanwendungen referenziert.

    • Benutzerspezifisch: für ein Token, das spezifisch für einen Nutzer ist.
  • Verwenden Sie im Feld Slack-Sitzung eine der folgenden Registerkarten zum Erstellen einer Sitzung:
    • Lokale Sitzung: Geben Sie einen Sitzungsnamen an, der nur vom aktuellen Bot verwendet werden kann.
    • Globale Sitzung: Geben Sie einen Sitzungsnamen an, der für mehrere Bots verwendet werden kann, wie z. B. übergeordnete Bots, untergeordnete Bots und alle anderen untergeordnete Bots des übergeordneten Bot.

      Empfehlung: Die übergeordneten und untergeordneten Bots sollten die gleiche Paket-Version haben.

    • Variable: um eine Slack-Sitzungsvariable anzugeben.

      Klicken Sie auf das Symbol rechts, um eine Variable zu erstellen, und wählen Sie dann Slack-Sitzung als Sitzungstyp im erscheinenden Fenster aus. Einzelheiten finden Sie unter Erstellen von Variablen.