Voraussetzungen für den Slack-Connector im Jitterbit Integration Studio

Einführung

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

Diese Schritte umfassen folgende Anweisungen:

• Erhalten Sie ein OAuth-Token (erforderlich bei Verwendung von Token-basierter Authentifizierung in der Verbindung).
• Konfigurieren Sie 3-beinige OAuth (erforderlich bei Verwendung von Authorization Code Grant in der Verbindung).

Erstellen Sie eine Slack-App

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

1. Gehen Sie zur Slack API-Website, klicken Sie auf App erstellen und dann auf Von Grund auf neu.

2. Geben Sie einen Namen für Ihre App ein und wählen Sie einen Arbeitsbereich aus, und klicken Sie dann auf App erstellen:

   

3. Gehen Sie zur Seite Eingehende Webhooks (erreichbar über das Menü Funktionen) und aktivieren Sie die Option Eingehende Webhooks aktivieren, indem Sie sie auf Ein umschalten, und klicken Sie dann auf Neuen Webhook zum Arbeitsbereich hinzufügen:

   

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

   

   Hinweis

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

Scopes hinzufügen

Befolgen Sie diese Schritte, um Scopes zur erstellten App hinzuzufügen:

1. Gehen Sie zur Seite OAuth & Berechtigungen (erreichbar über das Menü Funktionen), gehen Sie zum Abschnitt Scopes und klicken Sie auf Einen OAuth-Scope hinzufügen im Abschnitt Bot-Token-Scopes oder Benutzer-Token-Scopes (je nach Art des verwendeten Tokens):

   

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

   Aktivität	Berechtigung
   Suchen	chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write
   Posten	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
   Unterhaltungen	conversations.connect:manage conversations.connect:read conversations.connect:write
   Benutzer	users.profile:read users:read users:read.email users:write

OAuth-Token erhalten

Wenn Sie die Verbindung mit einem Bot-Token oder Benutzer-Token authentifizieren, befolgen Sie diese Schritte:

1. Gehen Sie zur Seite OAuth & Berechtigungen, die Sie im Abschnitt Funktionen der Slack API-Website aufrufen.

2. Um ein Bot-Token zu erhalten, kopieren Sie das Bot User OAuth Token (mit xoxb vorangestellt) unter OAuth Tokens.

   Um ein Benutzer-Token zu erhalten, kopieren Sie das User OAuth Token (mit xoxp vorangestellt) unter OAuth Tokens:

   

   Hinweis

   Das User OAuth Token ist nur sichtbar, wenn User Token Scopes zur App hinzugefügt wurden.

3-beinige OAuth konfigurieren

In diesem Abschnitt werden die Schritte zur Authentifizierung der Verbindung zur Verwendung der 3-beinigen OAuth 2.0 (3LO) Authentifizierung mit einer privaten Anwendung beschrieben, die im Management Console App-Registrierungen konfiguriert ist.

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

• Client-ID und Client-Geheimnis
• Scopes
• Autorisierungs-URL
• Zugriffstoken-URL
• Refresh-Token-URL

Redirect URL

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

Instructions

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

1. Konfigurieren Sie 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 zu erhalten, gehen Sie zur Seite Basisinformationen Ihrer Slack-App. Die Werte befinden sich im Abschnitt App-Anmeldeinformationen:

   

4. Um die Scopes für die App-Registrierung zu erhalten, gehen Sie zur Seite OAuth & Berechtigungen Ihrer Slack-App, navigieren Sie zum Abschnitt Scopes und erhalten Sie die für die App verwendeten Scopes. Geben Sie in der Konfiguration der App-Registrierung jeden der Scopes der App im Codeformat ein, zum Beispiel read:me.

5. Setzen Sie die Authentifizierungs-URL der App auf https://slack.com/oauth/v2/authorize.

6. Setzen Sie die Zugriffstoken-URL der App auf https://slack.com/api/oauth.v2.access.

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

8. Gehen Sie zu Erweiterte Optionen.

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

   Hinweis

   Die Access-Token-URL ist mit dem in Schritt 6 angegebenen Wert vorausgefüllt und sollte nicht geändert werden.

9. Im Tab Refresh-Anforderungs-Tab unter Parameter geben Sie diese Schlüssel-Wert-Paare ein:

   • Für das erste Schlüssel-Wert-Paar geben Sie Accept-Encoding als Schlüssel und */* als Wert ein. Wählen Sie dann Request Header aus dem Menü Senden in.

   • Für das zweite Schlüssel-Wert-Paar geben Sie grant_type als Schlüssel und refresh_token als Wert ein. Wählen Sie dann Request URL aus dem Menü Senden in.

     Hinweis

     Die Refresh-Token-URL ist mit dem in Schritt 7 angegebenen Wert vorausgefüllt und sollte nicht geändert werden.

Sobald die 3-beinige OAuth-Anwendung auf der Seite App-Registrierungen registriert ist, steht sie im Menü OAuth-Anwendung unter Private Anwendungen in der Slack-Verbindung zur Auswahl.