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

# Thiết lập tích hợp CultureAI

> Kết nối CultureAI với Living Security Platform để nhập dữ liệu về hành vi bảo mật và dữ liệu báo cáo.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Tài nguyên liên quan</h2>
    <ul>
      <li>
        <a href="/vi/signals/data-sources">Tìm hiểu cách dữ liệu tích hợp trở thành các tín hiệu Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Khám phá các Tích hợp của Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Mở Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Yêu cầu bản demo của Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Nhập thông tin xác thực vào Living Security Platform">
    <p>
      Bước này do người có quyền truy cập Living Security thực hiện — chủ sở hữu chương trình, hoặc quản trị viên hệ thống nếu người đó đã được mời (thiết lập được ủy quyền).
    </p>
    <ol>
      <li>
        Truy cập <strong>Cài đặt → Tích hợp → Danh mục</strong>, tìm thẻ{' '}
        <strong>{tile}</strong>, rồi nhấp vào <strong>Kết nối</strong>.
      </li>
      <li>
        Điền các trường bên dưới, sau đó nhấp vào <strong>Kết nối</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Hướng dẫn này dành cho quản trị viên {system} của Quý vị.</strong> Hướng dẫn đề cập đến việc tạo thông tin xác thực API trong {system}, thao tác này yêu cầu quyền quản trị đối với {system} — chứ không phải đối với
      Living Security Platform.
    </p>
    <p>
      Nếu Quý vị là <strong>chủ sở hữu chương trình</strong> của Living Security và không quản trị {system},
      vui lòng gửi trang này cho người đảm nhiệm vai trò đó. Người này sẽ hoàn thành Phần A và chuyển lại thông tin xác thực cho Quý vị
      (hoặc nhập trực tiếp nếu Quý vị đã mời họ vào nền tảng).
      {recommendDelegated && <>
          {' '}Do quá trình thiết lập tạo ra tài liệu khóa nhạy cảm, chúng tôi khuyến nghị sử dụng hướng{' '}
          <strong>thiết lập ủy quyền</strong> để khóa bí mật không bao giờ được gửi lại cho Quý vị.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="CultureAI" />

## Những gì tích hợp này đóng góp

CultureAI có thể đóng góp hoạt động liên quan đến lừa đảo qua email (phishing), đào tạo, báo cáo của nhân viên và bảo vệ dữ liệu. Các ví dụ đã được rà soát bao gồm:

* `phishing.real.clicked` — nhấp vào các liên kết trong email lừa đảo thực tế
* `data.transfer.blocked` — việc truyền dữ liệu bị chặn
* `phishing.safe.reported` — báo cáo các email sau đó được đánh giá là an toàn

Các ví dụ này cho thấy những loại hoạt động đã được chuẩn hóa mà Living Security có thể sử dụng. Xem [cách dữ liệu tích hợp trở thành tín hiệu](/vi/signals/data-sources).

## Những gì Living Security yêu cầu

| Thông tin xác thực | Mô tả |
| - | - |
| **Khóa API** | Khóa được tạo từ bảng điều khiển quản trị CultureAI của quý vị. Living Security gửi khóa này trong mọi yêu cầu để xác thực với API của CultureAI. Đây là thông tin xác thực duy nhất được yêu cầu. |

**Phạm vi (scope):** Khóa API của CultureAI không bị giới hạn theo phạm vi — một khóa hợp lệ sẽ cấp quyền truy cập API. Living Security chỉ đọc dữ liệu báo cáo; nếu bảng điều khiển CultureAI của quý vị cho phép chọn phạm vi hoặc quyền khi tạo khóa, hãy cấp quyền truy cập báo cáo chỉ đọc.

**Vai trò bắt buộc:** **Quản trị viên** hoặc **Chủ sở hữu** trong CultureAI (để quản lý quyền truy cập API)

### Điều kiện tiên quyết

* Quý vị phải đăng nhập vào bảng điều khiển quản trị CultureAI với vai trò có thể quản lý quyền truy cập API — thường là vai trò **Quản trị viên** hoặc **Chủ sở hữu**. Nếu không thấy khu vực cài đặt API hoặc nhà phát triển, hãy liên hệ đại diện tài khoản CultureAI của quý vị để kích hoạt quyền truy cập API cho tổ chức.

***

## Phần A — Trong CultureAI

*Quản trị viên CultureAI của quý vị thực hiện các bước sau.*

<Steps>
  <Step title="Tạo khóa API">
    1. Đăng nhập vào bảng điều khiển quản trị CultureAI của quý vị.
    2. Mở phần cài đặt tổ chức hoặc tài khoản và tìm khu vực **API** (hoặc **API keys** / **Developer**).
    3. Tạo một khóa API mới và đặt tên mô tả cho khóa (ví dụ: `Living Security Platform`).

    <Note>
      Living Security sử dụng khóa này để truy cập chỉ đọc vào dữ liệu báo cáo mà hệ thống nhập từ CultureAI. Không cần quyền ghi. Nếu CultureAI yêu cầu chọn phạm vi hoặc quyền, chỉ cấp quyền đọc đối với dữ liệu báo cáo.
    </Note>

    <Warning>
      CultureAI có thể chỉ hiển thị giá trị khóa API **một lần duy nhất** khi khóa được tạo. Hãy sao chép ngay và lưu trữ ở nơi an toàn (ví dụ: kho mật khẩu hoặc trình quản lý bí mật). Nếu quý vị rời khỏi trang mà chưa sao chép, quý vị sẽ cần tạo khóa mới.
    </Warning>

    <Note>
      Nếu quý vị không tìm thấy nơi tạo khóa API, hoặc không chắc chắn nên cấp những quyền nào, hãy liên hệ đại diện tài khoản CultureAI của quý vị. Living Security không thể tạo thông tin xác thực CultureAI thay cho quý vị.
    </Note>
  </Step>
</Steps>

***

## Phần B — Trong Living Security Platform

*Chủ sở hữu chương trình thực hiện bước này, hoặc quản trị viên hệ thống nếu sử dụng thiết lập được ủy quyền.*

<Steps>
  <ConnectInPlatform tile="CultureAI">
    | Trường | Giá trị |
    | - | - |
    | **Khóa API** | Khóa API từ Phần A |
  </ConnectInPlatform>
</Steps>

Quý vị đã kết nối với CultureAI.

***

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Khóa API không hợp lệ hoặc đã bị thu hồi. Hãy xác minh khóa chính xác và chưa bị tạo lại trong CultureAI.
  </Accordion>

  <Accordion title="403 Forbidden">
    Khóa API không có quyền đọc dữ liệu báo cáo. Trong CultureAI, hãy xác minh khóa đã được cấp quyền đọc, hoặc tạo khóa mới với các quyền phù hợp.
  </Accordion>

  <Accordion title="Kết quả trống (200 OK nhưng không có dữ liệu)">
    Khóa API có thể không có quyền truy cập vào dữ liệu báo cáo mà Living Security nhập. Hãy xác nhận với đại diện tài khoản CultureAI của quý vị rằng khóa có quyền đọc dữ liệu báo cáo.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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