Skip to main content

​
Slack について

Slack コネクタは、ワークスペースのメンバーシップ、チャンネル構成、ユーザーグループを読み取ります。Enterprise Grid では、監査ログイベントも読み取ります。これらの情報は、Iru Compliance でアーティファクトとして表示されます。Iru は、Slack アプリをワークスペースにインストールして取得した Bot OAuth トークン (xoxb-) で認証します。アクセスはコンプライアンスエビデンス向けの読み取り中心であり、ここで説明するスコープを通じてメッセージを送信したり、ワークスペースの設定を変更したりすることはありません。

​
仕組み

Slack API は、Authorization ヘッダーで Bot トークンを受け取ります:
api.slack.com でアプリを作成し、Bot token scopes を付与して、アプリをワークスペースにインストールした後、Bot User OAuth Token をコピーします。スコープを拡張するにはアプリの再インストールが必要で、その際に新しいトークンが発行されます。その場合は必ず Iru を更新してください。 リファレンス: OAuth tokens、Scopes、Audit Logs API。

​
前提条件

  • アプリをインストールできる Workspace Owner または Workspace Admin 権限。
  • ワークスペースで api.slack.com/apps にサインインできること。
  • オプション: auditlogs:read が必要な場合は Enterprise Grid。
ディレクトリとチャンネルのエビデンスに使用する一般的な Bot スコープ

​
Slack を Iru に接続する

Compliance でソースを接続する前に、このタブの手順を完了してください。
1

Slack API のアプリを開く

ブラウザで api.slack.com/apps に移動し、対象ワークスペースのアプリを作成できる Slack アカウント (多くの場合はワークスペース管理者) でサインインします。
2

新しいアプリを作成する

Create New App を選択し、From scratch を選択します (組織でマニフェストを標準としている場合を除きます。この記事では From scratch を前提としています)。
3

アプリに名前を付けてワークスペースを選択する

Iru Compliance などのアプリ名を入力し、Iru をインストールする Slack ワークスペースを選択します。
4

OAuth & Permissions を開く

アプリの左側のサイドバーで OAuth & Permissions を開きます。
5

Bot Token のスコープを追加する

Bot Token Scopes で、コントロールに必要な前提条件のスコープをそれぞれ追加します。auditlogs:read は、Enterprise Grid を使用していて監査エビデンスが必要な場合にのみ追加してください。
6

アプリをワークスペースにインストールする

OAuth & Permissions から Install to Workspace (スコープを変更した後は Reinstall) を選択します。権限を確認して承認します。
7

Bot User OAuth Token をコピーする

Bot User OAuth Token (xoxb- で始まる) をコピーします。後でスコープを変更した場合は、再インストールして新しいトークンを取得してください。Iru Compliance でプロンプトが表示されたら、現在のトークンを Iru のコネクタウィザードに貼り付けます。
Iru Compliance タブに進みます。

​
トラブルシューティング

Iru サイトのポップアップブロッカー設定を確認して、もう一度お試しください。
トークンが最新であること、xoxb- で始まること、およびアプリがまだインストールされていることを確認してください。
OAuth & Permissions でスコープを追加し、アプリを再インストールして新しいトークンをコピーし、Iru を更新してください。
アプリを再インストールするか認証情報をローテーションし、新しい Bot トークンで Iru を更新してください。
auditlogs:read には Enterprise Grid が必要です。これがない場合、監査ログ API のエビデンスは取得できません。

​
考慮事項

Bot トークンは通常、期限切れになりません…

Bot トークンは、ワークスペースでローテーションが強制されていない限り、通常は期限切れになりません。ローテーションが有効な場合は、Slack のガイダンスに従ってください。

アプリをアンインストールすると、トークンは直ちに取り消されます。

アプリをアンインストールすると、トークンは直ちに取り消されます。

スコープを増やすには、必ず再インストールと新しい…

スコープを増やすには、必ず再インストールと新しいトークンが必要です。変更はメンテナンス時間帯に計画してください。

​
関連記事

ソース管理

すべての Compliance ソースを参照および管理します。

Compliance の使用を開始する

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

アーティファクト管理

ソースとアクションから得たエビデンスをアップロード、確認、整理します。