> ## 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.

# CultureAI 集成设置

> 将 CultureAI 连接到 Living Security Platform，以导入安全行为和报告数据。

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>相关资源</h2>
    <ul>
      <li>
        <a href="/zh-Hans/signals/data-sources">了解集成数据如何转化为人员风险管理信号</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">探索 Living Security 集成</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">打开 Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">申请 Living Security 演示</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="在 Living Security Platform 中输入凭据">
    <p>
      由拥有 Living Security 访问权限的人员完成——即项目负责人；如果已受邀，也可由系统管理员完成（委派设置）。
    </p>
    <ol>
      <li>
        转到<strong>设置 → 集成 → 目录</strong>，找到{' '}
        <strong>{tile}</strong> 磁贴，然后单击<strong>连接</strong>。
      </li>
      <li>
        填写下方的字段，然后单击<strong>连接</strong>。
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>本指南适用于您的 {system} 管理员。</strong>本指南介绍如何在 {system} 中创建 API
      凭据，这需要 {system} 的管理员权限，而非 Living Security Platform 的管理员权限。
    </p>
    <p>
      如果您是 Living Security 的<strong>项目负责人</strong>，但并不管理 {system}，
      请将本页面转发给负责管理 {system} 的人员。由其完成 A 部分，然后将凭据交还给您
      （如果您已邀请其加入平台，则可由其直接输入凭据）。
      {recommendDelegated && <>
          {' '}由于设置过程会产生敏感的密钥材料，我们建议采用{' '}
          <strong>委派设置</strong>方式，这样密钥不会再发送给您。
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="CultureAI" />

## 此集成提供的内容

CultureAI 可提供网络钓鱼、培训、员工报告和数据保护方面的活动数据。已审核的示例包括：

* `phishing.real.clicked` — 点击真实网络钓鱼邮件中的链接
* `data.transfer.blocked` — 数据传输被阻止
* `phishing.safe.reported` — 报告了后来被判定为安全的邮件

这些示例展示了 Living Security 可使用的标准化活动类型。请参阅[集成数据如何转换为信号](/zh-Hans/signals/data-sources)。

## Living Security 所需的信息

| 凭据 | 说明 |
| - | - |
| **API 密钥** | 在 CultureAI 管理控制台中生成的密钥。Living Security 在每次请求时都会发送此密钥，以向 CultureAI API 进行身份验证。这是唯一需要的凭据。 |

**范围：** CultureAI API 密钥没有范围限制，只要密钥有效即可获得 API 访问权限。Living Security 仅读取报告数据；如果您的 CultureAI 控制台在创建密钥时提供范围或权限选项，请授予只读的报告访问权限。

**所需角色：** CultureAI 中的**管理员**或**所有者**（用于管理 API 访问）

### 前提条件

* 您必须使用具有管理 API 访问权限的角色登录 CultureAI 管理控制台，通常为**管理员**或**所有者**角色。如果您未看到 API 或开发者设置区域，请联系您的 CultureAI 客户代表，为贵组织启用 API 访问。

***

## 第 A 部分 — 在 CultureAI 中

*由您的 CultureAI 管理员完成以下步骤。*

<Steps>
  <Step title="生成 API 密钥">
    1. 登录您的 CultureAI 管理控制台。
    2. 打开组织或账户设置，找到 **API**（或 **API keys** / **Developer**）区域。
    3. 创建新的 API 密钥，并为其指定一个描述性名称（例如 `Living Security Platform`）。

    <Note>
      Living Security 使用此密钥对从 CultureAI 导入的报告数据进行只读访问，无需写入权限。如果 CultureAI 提示您选择范围或权限，请仅授予对报告数据的读取权限。
    </Note>

    <Warning>
      CultureAI 可能**仅在创建时显示一次** API 密钥值。请立即复制并存放在安全位置（例如密码保管库或机密管理器）。如果您在未复制的情况下离开页面，则需要重新生成新的密钥。
    </Warning>

    <Note>
      如果您找不到创建 API 密钥的位置，或不确定应授予哪些权限，请联系您的 CultureAI 客户代表。Living Security 无法代表您生成 CultureAI 凭据。
    </Note>
  </Step>
</Steps>

***

## 第 B 部分 — 在 Living Security Platform 中

*由项目所有者完成此步骤；如果使用委托设置，则由系统管理员完成。*

<Steps>
  <ConnectInPlatform tile="CultureAI">
    | 字段 | 值 |
    | - | - |
    | **API 密钥** | 第 A 部分中获得的 API 密钥 |
  </ConnectInPlatform>
</Steps>

您现在已连接到 CultureAI。

***

## 故障排除

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 密钥无效或已被撤销。请确认密钥正确，并且未在 CultureAI 中被重新生成。
  </Accordion>

  <Accordion title="403 Forbidden">
    该 API 密钥缺少对报告数据的读取权限。请在 CultureAI 中确认已为该密钥授予读取权限，或使用正确的权限生成新的密钥。
  </Accordion>

  <Accordion title="空结果（200 OK 但无数据）">
    该 API 密钥可能无权访问 Living Security 所导入的报告数据。请与您的 CultureAI 客户代表确认该密钥具有报告数据的读取权限。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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