Slack Voraussetzungen

Einführung

Dies sind die Voraussetzungen für die Nutzung des Slack Connectors. Zuerst erstellen Sie eine Slack-App im ausgewählten Arbeitsbereich und dann Bereiche hinzufügen zur erstellten App.

Diese Schritte umfassen diese Anweisungen:

• Ein OAuth-Token erhalten (erforderlich bei Verwendung der Token-basierten Authentifizierung in der Verbindung).
• 3-beiniges OAuth konfigurieren (erforderlich bei Verwendung von Authorization Code Grant in der Verbindung).

Erstellen einer Slack App

Befolgen Sie diese Schritte, um im ausgewählten Arbeitsbereich eine Slack-App zu erstellen:

1. Auf der Slack API Website, klicken Sie auf App erstellen und dann auf Von Grund auf neu.

2. Geben Sie Ihrer App einen Namen, wählen Sie einen Arbeitsbereich aus und klicken Sie dann auf App erstellen:

   

3. Gehen Sie zur Seite Eingehende Webhooks (Zugriff über das Menü Funktionen) und schalten Sie die Option Eingehende Webhooks aktivieren auf Ein. Klicken Sie dann auf Neuen Webhook zum Arbeitsbereich hinzufügen:

   

4. Wählen Sie im Menü den Slack-Kanal aus, in dem Sie Nachrichten posten möchten, und klicken Sie auf Zulassen:

   

   Hinweis

   Möglicherweise ist die Genehmigung von jemandem erforderlich, der Apps in Ihrem Arbeitsbereich verwaltet. Verwenden Sie die Schaltfläche Anfrage zum Hinzufügen eines neuen Webhooks, um eine Genehmigungsanfrage zu senden.

Bereiche hinzufügen

Befolgen Sie diese Schritte, um der erstellten App Bereiche hinzuzufügen:

1. Gehen Sie auf der Seite OAuth und Berechtigungen (Zugriff über das Menü Funktionen) zum Abschnitt Bereiche und klicken Sie unter Bot-Token-Bereiche oder Benutzer-Token-Bereiche (je nach verwendetem Token-Typ) auf OAuth-Bereich hinzufügen:

   

2. Fügen Sie diese Bereiche je nach den zu verwendenden Aktivitäten hinzu:

   Aktivität	Bereich
   Suchen	chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write
   Beitrag	calls:read calls:write chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write dnd:read files:read files:write remote_files:read remote_files:share remote_files:write pins:read pins:write reactions:read reactions:write reminders:read reminders:write usergroups:read usergroups:write users.profile:read users:read users:read.email users:write
   Chat	conversations.connect:manage conversations.connect:read
   Holen	calls:read calls:write chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write dnd:read files:read files:write remote_files:read remote_files:share remote_files:write pins:read pins:write reactions:read reactions:write reminders:read reminders:write usergroups:read usergroups:write users.profile:read users:read users:read.email users:write team.billing:read team.preferences:read team:read workflow.steps:execute
   Dateien	files:read files:write remote_files:read remote_files:share remote_files:write
   Gespräche	conversations.connect:manage conversations.connect:read conversations.connect:write
   Benutzer	users.profile:read users:read users:read.email users:write

Abrufen eines OAuth-Tokens

Wenn Sie die Verbindung authentifizieren mit einem Bot-Token oder Benutzertoken führen Sie die folgenden Schritte aus:

1. Gehen Sie zur Seite OAuth & Berechtigungen, die Sie über die Slack API Website erreichen Abschnitt Funktionen.

2. Um ein Bot-Token zu erhalten, kopieren Sie das Bot User OAuth Token (mit dem Präfix xoxb) unter OAuth-Token.

   Um ein Benutzertoken zu erhalten, kopieren Sie das User OAuth Token (mit dem Präfix xoxp) unter OAuth-Token:

   

   Hinweis

   Das Benutzer-OAuth-Token ist nur sichtbar, wenn der App Benutzer-Token-Bereiche hinzugefügt wurden.

3-beiniges OAuth konfigurieren

Dieser Abschnitt behandelt die Schritte zur Authentifizierung der Verbindung um die 3-legged OAuth 2.0 (3LO)-Authentifizierung mit einer privaten Anwendung zu verwenden, die in der Management Console konfiguriert ist App-Registrierungen Seite.

Private Anwendungen sind Anwendungen, die Sie für die Slack Instanz konfigurieren (beschrieben in Eine Slack App erstellen) und registrieren Sie sich dann in der Management Console App-Registrierungen Seite mit diesen Werten aus der Slack-App:

• Client-ID und Client-Geheimnis
• Zielfernrohre
• Autorisierungs URL
• Zugriffstoken-URL
• Token-URL aktualisieren

Umleitungs URL

Beim Konfigurieren Ihrer Anwendung in Slack, stellen Sie sicher, dass die Umleitungs URL auf eine der folgenden URLs eingestellt ist (abhängig von der Region Ihrer Organisation):

Anweisungen

Dies sind die Anweisungen zum Abrufen der erforderlichen Werte für die App-Registrierung:

1. Konfigurieren eine OAuth-Anwendung für die Slack Instanz.

2. Navigieren Sie zu Ihrer Anwendung auf der Slack API -Website.

3. Um die Client-ID und das Client-Geheimnis für die App-Registrierung abzurufen, gehen Sie auf die Seite Grundlegende Informationen Ihrer Slack App. Die Werte finden Sie im Abschnitt App-Anmeldeinformationen:

   

4. Um die Bereiche für die App-Registrierung abzurufen, gehen Sie zur Seite OAuth & Berechtigungen Ihrer Slack-App, navigieren Sie zum Abschnitt Bereiche und rufen Sie die für die App verwendeten Bereiche ab. Geben Sie in der Konfiguration der App-Registrierung jeden Bereich der App in seinem Codeformat ein, zum Beispiel: read:me.

5. Legen Sie die Authentifizierungs-URL der App fest als https://slack.com/oauth/v2/authorize.

6. Legen Sie die Access Token URL der App fest als https://slack.com/api/oauth.v2.access.

7. Setzen Sie die Refresh-Token-URL der App auf https://slack.com/api/oauth.v2.access.

8. Gehen Sie zu Erweiterte Optionen.

   Im Tab Token-Anforderung unter Parameter geben Sie ein Accept-Encoding als Schlüssel und */* als Wert. Wählen Sie dann Anforderungsheader aus dem Menü Senden in.

   Notiz

   Die Zugriffstoken-URL ist mit dem in Schritt 6 angegebenen Wert vorbelegt und sollte nicht geändert werden.

9. Klicken Sie auf der Tab Anforderung aktualisieren geben Sie unter Parameter diese Key-Value Paare ein:

   • Geben Sie für das erste Key-Value Paar ein Accept-Encoding als Schlüssel und geben Sie ein */* als Wert. Wählen Sie dann Anforderungsheader aus dem Menü Senden in.

   • Geben Sie für das zweite Key-Value Paar ein grant_type als Schlüssel und geben Sie ein refresh_token als Wert. Wählen Sie dann Anforderungs URL aus dem Menü Senden.

     Notiz

     Die URL des Aktualisierungstokens ist mit dem in Schritt 7 angegebenen Wert vorbelegt und sollte nicht geändert werden.

Sobald die 3-beinige OAuth-Anwendung bei App-Registrierungen registriert ist Seite ist es verfügbar und kann im Menü OAuth-Anwendung unter Private Anwendungen in der Slack-Verbindung ausgewählt werden.