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

# Slack 連携

> Living Security を Slack に接続して、トレーニングの通知、セキュリティアラート、プレイブックの更新情報をワークスペースに送信します。

Slack 連携により、Living Security から Slack ワークスペースへ直接通知を送信できます。トレーニングの割り当てをユーザーに通知したり、リスクイベントについてセキュリティチームにアラートを送信したり、チームの進捗状況をマネージャーに共有したりできます。

<Note>
  ナッジおよびプレイブックの配信を設定するには、**設定 → 通信 → チャンネル** から開始し、**Slack** カードをクリックします。このページでは、基盤となる Slack アプリの構成について説明します。
</Note>

## 前提条件

Slack 連携を構成する前に、次のものを用意してください。

* Slack ワークスペースの管理者権限、またはアプリをインストールする権限
* Slack API ポータル [api.slack.com](https://api.slack.com) へのアクセス
* Living Security の管理者権限

## Slack アプリの作成

<Steps>
  <Step title="新しい Slack アプリを作成する">
    1. [api.slack.com/apps](https://api.slack.com/apps) にアクセスします
    2. **Create New App** をクリックします
    3. **From scratch** を選択します
    4. アプリ名を入力します（例: "Living Security"）
    5. ワークスペースを選択します
    6. **Create App** をクリックします

    <Check>
      作成したアプリが Slack API ダッシュボードに表示されます。
    </Check>
  </Step>

  <Step title="OAuth スコープを構成する">
    1. 左側のサイドバーで **OAuth & Permissions** をクリックします
    2. **Bot Token Scopes** までスクロールします
    3. 次のスコープを追加します。

    | スコープ | 目的 |
    | - | - |
    | `chat:write` | チャンネルにメッセージを送信する |
    | `chat:write.public` | チャンネルに参加せずにメッセージを送信する |
    | `users:read` | ユーザー情報を検索する |
    | `users:read.email` | メールアドレスでユーザーを照合する |

    <Tip>
      組織で必要なスコープのみを追加してください。スコープを少なくするほど、セキュリティが向上します。
    </Tip>
  </Step>

  <Step title="アプリをワークスペースにインストールする">
    1. **OAuth & Permissions** の先頭までスクロールします
    2. **Install to Workspace** をクリックします
    3. 権限を確認し、**Allow** をクリックします

    <Check>
      `xoxb-` で始まる **Bot User OAuth Token** が表示されます。
    </Check>
  </Step>

  <Step title="署名シークレットを取得する">
    1. 左側のサイドバーで **Basic Information** をクリックします
    2. **App Credentials** までスクロールします
    3. **Signing Secret** をコピーします

    <Warning>
      署名シークレットは非公開にしてください。公開リポジトリやログで共有しないでください。
    </Warning>
  </Step>
</Steps>

## Living Security への認証情報の追加

<Steps>
  <Step title="アウトバウンド連携に移動する">
    **設定 → 連携 → アウトバウンド** に移動し、**Slack** カードをクリックします。
  </Step>

  <Step title="認証情報を追加する">
    **Add Credential** をクリックし、次の項目を入力します。

    <ParamField body="botToken" type="string" required>
      `xoxb-` で始まる Bot User OAuth Token です。**OAuth & Permissions** で確認できます。
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      アプリの Signing Secret です。**Basic Information → App Credentials** で確認できます。
    </ParamField>

    <ParamField body="appToken" type="string">
      任意です。Socket Mode 接続を使用する場合にのみ必要です。`xapp-` で始まります。
    </ParamField>

    <ParamField body="label" type="string">
      任意です。この認証情報のわかりやすい名前です（例: "Production Slack"）。
    </ParamField>
  </Step>

  <Step title="保存して確認する">
    **保存** をクリックします。認証情報が一覧に表示され、ステータスが**アクティブ**になります。

    <Check>
      Slack 連携が接続され、通知を送信できる状態になりました。
    </Check>
  </Step>
</Steps>

## 通知の種類

接続が完了すると、Living Security は次の種類の通知を Slack に送信できます。

| 通知 | 説明 |
| - | - |
| トレーニングの割り当て | 新しいトレーニングが割り当てられたときにユーザーに通知します |
| トレーニングのリマインダー | 期限が近づいていることをユーザーに知らせます |
| 完了確認 | トレーニングが完了したときに確認を送信します |
| セキュリティアラート | リスクイベントについてセキュリティチームに通知します |
| プレイブックのサマリー | プレイブックのパフォーマンスに関する更新情報を定期的に送信します |

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

<AccordionGroup>
  <Accordion title="メッセージがチャンネルに表示されない">
    * ボットがチャンネルに招待されていることを確認してください（`/invite @YourBotName`）
    * 参加せずにパブリックチャンネルに投稿するためのスコープ `chat:write.public` が追加されていることを確認してください
    * チャンネル ID が正しいことを確認してください（チャンネル名ではなくチャンネル ID を使用します）
  </Accordion>

  <Accordion title="無効なトークンのエラー">
    * `xoxb-` で始まる完全なトークンをコピーしていることを確認してください
    * アプリがワークスペースにインストールされたままであることを確認してください
    * トークンが再生成されていないか確認してください（再生成した場合は Living Security での更新が必要です）
  </Accordion>

  <Accordion title="レート制限">
    Slack では API リクエスト数に制限があります。レート制限エラーが表示された場合は、次の対応を行ってください。

    * 通知の頻度を減らす
    * 複数の通知をダイジェストメッセージにまとめる
    * 大量の通知が必要な場合は、サポートにお問い合わせください
  </Accordion>
</AccordionGroup>

## ベストプラクティス

<Tip>
  Living Security の通知専用の Slack チャンネル（例: `#security-training`）を作成すると、アラートを整理でき、一般のチャンネルでのノイズを減らせます。
</Tip>

* 複数のワークスペースを管理する場合は、わかりやすい認証情報ラベルを使用してください
* 通知を受信しているチャンネルを定期的に監査してください
* 大量のアラートについては、個別のメッセージではなく通知ダイジェストを設定してください
* Slack アプリの権限を四半期ごとに見直し、使用していないスコープを削除してください

## 関連情報

<CardGroup cols={2}>
  <Card title="メール連携" icon="envelope" href="/ja/integrations/outbound/email">
    メールを配信チャンネルとして構成します。
  </Card>

  <Card title="Teams 連携" icon="microsoft" href="/ja/integrations/outbound/teams">
    Microsoft Teams を配信チャンネルとして構成します。
  </Card>

  <Card title="通信ログ" icon="clock-rotate-left" href="/ja/features/communications/log">
    Slack の配信ステータスと履歴を追跡します。
  </Card>

  <Card title="新しい連携のセットアップ方法" icon="plug" href="/ja/integrations/managing/setup">
    連携の一般的なセットアップガイドです。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.