> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Bot トークンを使用して Slack を Iru Compliance に接続し、ワークスペースのメタデータ、チャンネルのインベントリ、ユーザーとグループのメンバーシップ、Enterprise Grid の監査ログを収集します。

### Slack について

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

### 仕組み

Slack API は、**Authorization** ヘッダーで Bot トークンを受け取ります:

```http theme={null}
Authorization: Bearer xoxb-XXXX-XXXX-XXXX
```

**api.slack.com** でアプリを作成し、**Bot token scopes** を付与して、アプリをワークスペースにインストールした後、**Bot User OAuth Token** をコピーします。スコープを拡張するにはアプリの**再インストール**が必要で、その際に**新しい**トークンが発行されます。その場合は必ず Iru を更新してください。

| 詳細 | 値 |
| - | - |
| **カテゴリ** | コミュニケーション |
| **認証** | Bearer トークン (Bot OAuth トークン `xoxb-`) |
| **監査ログ** | **`auditlogs:read`** は **Enterprise Grid 専用**です。Grid がない場合、この API 経由で監査ログ形式のエビデンスは取得できません。 |

リファレンス: [OAuth tokens](https://docs.slack.dev/authentication/tokens/)、[Scopes](https://docs.slack.dev/scopes/)、[Audit Logs API](https://docs.slack.dev/apis/audit-logs-api/)。

### 前提条件

* アプリをインストールできる **Workspace Owner** または **Workspace Admin** 権限。
* ワークスペースで **[api.slack.com/apps](https://api.slack.com/apps)** にサインインできること。
* オプション: **`auditlogs:read`** が必要な場合は Enterprise Grid。

**ディレクトリとチャンネルのエビデンスに使用する一般的な Bot スコープ**

| スコープ | 目的 |
| - | - |
| `users:read` | メンバーのプロフィールを読み取る |
| `users:read.email` | メンバーのメールアドレスを読み取る |
| `channels:read` | パブリックチャンネルを一覧表示して読み取る |
| `groups:read` | プライベートチャンネルを一覧表示して読み取る (許可されている場合) |
| `usergroups:read` | ユーザーグループの構成を読み取る |
| `auditlogs:read` | 監査ログ (**Enterprise Grid** のみ) |

### Slack を Iru に接続する

<Tabs>
  <Tab title="Slack">
    <Note>
      Compliance でソースを接続する前に、このタブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="Slack API のアプリを開く">
        ブラウザで **[api.slack.com/apps](https://api.slack.com/apps)** に移動し、対象**ワークスペース**の**アプリを作成**できる Slack アカウント (多くの場合はワークスペース管理者) でサインインします。
      </Step>

      <Step title="新しいアプリを作成する">
        **Create New App** を選択し、**From scratch** を選択します (組織でマニフェストを標準としている場合を除きます。この記事では **From scratch** を前提としています)。
      </Step>

      <Step title="アプリに名前を付けてワークスペースを選択する">
        **Iru Compliance** などのアプリ名を入力し、Iru をインストールする **Slack ワークスペース**を選択します。
      </Step>

      <Step title="OAuth & Permissions を開く">
        アプリの左側のサイドバーで **OAuth & Permissions** を開きます。
      </Step>

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

      <Step title="アプリをワークスペースにインストールする">
        **OAuth & Permissions** から **Install to Workspace** (スコープを変更した後は **Reinstall**) を選択します。権限を確認して承認します。
      </Step>

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

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Slack**](#slack) タブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Slack をオンにする">
        **Slack** を見つけます (**カテゴリ** を **Communications** に設定するか、**名前または説明で検索** を使用します)。そのカードで**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="ウィザードに Bot トークンを貼り付ける">
        ウィザードで Bearer トークンを求められたら、**`xoxb-`** の **Bot User OAuth Token** を貼り付けて送信します。
      </Step>

      <Step title="接続を完了する">
        **Bearerトークンを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Slack** カードが **有効** であることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**設定を確認して、もう一度お試しください。
  </Accordion>

  <Accordion title="not_authed / 401">
    トークンが最新であること、**`xoxb-`** で始まること、およびアプリがまだインストールされていることを確認してください。
  </Accordion>

  <Accordion title="missing_scope">
    **OAuth & Permissions** でスコープを追加し、アプリを**再インストール**して**新しい**トークンをコピーし、Iru を更新してください。
  </Accordion>

  <Accordion title="token_revoked">
    アプリを再インストールするか認証情報をローテーションし、新しい Bot トークンで Iru を更新してください。
  </Accordion>

  <Accordion title="監査データがない">
    **`auditlogs:read`** には **Enterprise Grid** が必要です。これがない場合、監査ログ API のエビデンスは取得できません。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="Bot トークンは通常、期限切れになりません…" icon="circle-info">
    Bot トークンは、ワークスペースでローテーションが強制されていない限り、通常は**期限切れになりません**。ローテーションが有効な場合は、Slack のガイダンスに従ってください。
  </Card>

  <Card title="アプリをアンインストールすると、トークンは直ちに取り消されます。" icon="shield">
    アプリをアンインストールすると、トークンは直ちに**取り消されます**。
  </Card>

  <Card title="スコープを増やすには、必ず再インストールと新しい…" icon="server">
    スコープを増やすには、必ず**再インストール**と新しいトークンが必要です。変更はメンテナンス時間帯に計画してください。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ソース管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照および管理します。
  </Card>

  <Card title="Compliance の使用を開始する" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="アーティファクト管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースとアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>