> ## 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. 在左侧边栏中，点击 **基本信息**
    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。可在 **基本信息 → 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="/zh-Hans/integrations/outbound/email">
    将电子邮件配置为发送渠道。
  </Card>

  <Card title="Teams 集成" icon="microsoft" href="/zh-Hans/integrations/outbound/teams">
    将 Microsoft Teams 配置为发送渠道。
  </Card>

  <Card title="通讯日志" icon="clock-rotate-left" href="/zh-Hans/features/communications/log">
    跟踪 Slack 的发送状态和历史记录。
  </Card>

  <Card title="如何设置新的集成" icon="plug" href="/zh-Hans/integrations/managing/setup">
    通用集成设置指南。
  </Card>
</CardGroup>


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