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

> Kết nối KnowBe4 với Living Security Platform để nhập người dùng, thông tin ghi danh đào tạo và kết quả kiểm tra bảo mật lừa đảo qua email (phishing).

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 EgressIpSafelist = ({system}) => <Note>
    <strong>Hãy thêm cả bốn địa chỉ IP egress đồng bộ của Living Security</strong> vào danh sách cho phép trong{' '}
    {system}. Nhập từng địa chỉ dưới dạng một máy chủ đơn lẻ với <code>/32</code> nếu {system} yêu cầu ký hiệu CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Lưu lượng có thể xuất phát từ bất kỳ địa chỉ nào trong bốn địa chỉ này, vì vậy nếu chỉ đưa một số địa chỉ vào danh sách cho phép, quá trình đồng bộ sẽ thỉnh thoảng bị lỗi. Bốn địa chỉ này giống nhau ở mọi khu vực của Living Security. Xem{' '}
    <a href="/vi/integrations/managing/egress-ip-addresses">
      Cấu hình địa chỉ IP egress của Tích hợp
    </a>{' '}
    để biết danh sách đầy đủ, chính sách thay đổi và cách khắc phục sự cố.
  </Note>;

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="KnowBe4" />

## Tích hợp này đóng góp những gì

KnowBe4 có thể đóng góp các kết quả về lực lượng lao động, đào tạo và mô phỏng lừa đảo qua email (phishing). Các ví dụ đã được xem xét bao gồm:

* `training.completed` — hoàn thành khóa đào tạo bảo mật
* `training.past.due` — có khóa đào tạo quá hạn
* `phishing.simulation.clicked` — đã nhấp vào một mô phỏng mà không báo cáo

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

## Living Security cần những gì

| Thông tin xác thực | Mô tả |
| - | - |
| **Khóa API** | Mã bearer token của Reporting API được tạo tại **Account Settings → API**. Được gửi trong mọi yêu cầu ở tiêu đề `Authorization: Bearer`. |
| **Vùng máy chủ Reporting API** | Vùng mà tài khoản KnowBe4 của quý vị được cấp phát, được chọn từ một danh sách (US, EU, Canada, UK, Germany). |

**Phạm vi (Scopes):** Không cần cấu hình — token của KnowBe4 Reporting API được thiết kế chỉ để đọc và không bị giới hạn theo phạm vi. Token cấp quyền đọc đối với người dùng, thông tin ghi danh đào tạo và kết quả kiểm tra bảo mật lừa đảo qua email (phishing), đúng với những gì quá trình đồng bộ hóa đọc.

**Vai trò bắt buộc:** **Account Admin** trong KnowBe4 (chỉ quản trị viên tài khoản mới có thể truy cập **Account Settings → API**)

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

* Quý vị phải đăng nhập vào bảng điều khiển KnowBe4 với vai trò **Account Admin**. Chỉ quản trị viên tài khoản mới có thể truy cập **Account Settings → API** để bật Reporting API và tạo token.

***

## Phần A — Trong KnowBe4

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

<Steps>
  <Step title="Bật Reporting API và tạo token">
    1. Đăng nhập vào bảng điều khiển KnowBe4 của quý vị.
    2. Nhấp vào tên tài khoản của quý vị ở góc trên bên phải và chọn **Account Settings**.
    3. Trong thanh điều hướng bên trái, chọn **API**.
    4. Bật **Reporting API** nếu chưa được bật, sau đó tạo một API token mới.

    Hãy đặt mục đích mô tả cho token (ví dụ: `Living Security Platform`) nếu bảng điều khiển của quý vị yêu cầu.

    <Warning>
      KnowBe4 chỉ hiển thị giá trị API token **một lần duy nhất** khi token đượ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ị phải tạo một token mới.
    </Warning>

    <Note>
      Reporting API chỉ có quyền đọc. API này cung cấp người dùng, thông tin ghi danh đào tạo và kết quả kiểm tra bảo mật lừa đảo qua email (phishing) — dữ liệu mà Living Security tiếp nhận để chấm điểm và báo cáo. Không cần quyền ghi.
    </Note>
  </Step>

  <Step title="Thêm các IP egress của Living Security vào danh sách Allowed IP Addresses">
    KnowBe4 cho phép quý vị giới hạn quyền truy cập Reporting API đối với một tập hợp địa chỉ IP nguồn cụ thể. Thiết lập này nằm cùng vị trí với token:

    1. Trong bảng điều khiển KnowBe4 của quý vị, đi tới **Account Settings → API → Allowed IP Addresses**.
    2. Thêm từng [địa chỉ IP egress của Living Security](/vi/integrations/managing/egress-ip-addresses) vào danh sách cho phép. Bốn địa chỉ này áp dụng giống nhau ở mọi vùng.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Nếu danh sách Allowed IP Addresses được cấu hình, danh sách này sẽ được áp dụng ở tầng mạng.** Hộp thoại kết nối sẽ thành công ở bước xác thực, nhưng việc đồng bộ dữ liệu sẽ thất bại (bị chặn ở tầng mạng, thường biểu hiện dưới dạng `403`) cho đến khi các IP egress của Living Security được thêm vào danh sách cho phép. Nếu quý vị thêm bất kỳ địa chỉ nào vào danh sách này, quý vị cũng phải thêm các dải địa chỉ của Living Security, nếu không các yêu cầu của chúng tôi sẽ bị từ chối dù token của quý vị hợp lệ.
    </Warning>

    <Note>
      Các địa chỉ IP egress của Living Security có thể thay đổi khi hạ tầng được cập nhật, dù chúng tôi hiếm khi thực hiện những thay đổi như vậy. Nếu việc đồng bộ dữ liệu bắt đầu thất bại sau khi trước đó hoạt động bình thường, hãy xem [Cấu hình địa chỉ IP egress cho tích hợp](/vi/integrations/managing/egress-ip-addresses) và xác minh rằng danh sách Allowed IP Addresses khớp với các địa chỉ này.
    </Note>
  </Step>

  <Step title="Xác định vùng máy chủ KnowBe4 của quý vị">
    KnowBe4 cung cấp Reporting API từ một máy chủ theo từng vùng. Quý vị chọn vùng trong hộp thoại kết nối thay vì nhập tên máy chủ:

    | Vùng | Máy chủ Reporting API |
    | - | - |
    | Hoa Kỳ | `us.api.knowbe4.com` |
    | Châu Âu | `eu.api.knowbe4.com` |
    | Canada | `ca.api.knowbe4.com` |
    | Vương quốc Anh | `uk.api.knowbe4.com` |
    | Đức | `de.api.knowbe4.com` |

    Nếu quý vị không chắc tài khoản của mình sử dụng vùng nào, hãy kiểm tra tên miền trong URL bảng điều khiển KnowBe4 của quý vị hoặc liên hệ với quản trị viên KnowBe4 của quý vị.

    <Note>
      Năm vùng này là những vùng mà Living Security có thể truy cập. Nếu tài khoản KnowBe4 của quý vị nằm trên một máy chủ khác (ví dụ: một phiên bản dành cho Chính phủ Hoa Kỳ), hãy liên hệ bộ phận hỗ trợ của Living Security trước khi bắt đầu kết nối.
    </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="KnowBe4">
    | Trường | Giá trị |
    | - | - |
    | **Khóa API** | Token của Reporting API từ Phần A, Bước 1 |
    | **Vùng máy chủ Reporting API** | Vùng từ Phần A, Bước 3 (ví dụ: Hoa Kỳ) |
  </ConnectInPlatform>
</Steps>

Quý vị đã được kết nối với KnowBe4.

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API token không hợp lệ hoặc đã hết hạn. Hãy xác minh token là chính xác và chưa bị tạo lại trong **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Token không có quyền truy cập Reporting API, hoặc IP của yêu cầu không nằm trong danh sách Allowed IP Addresses. Hãy xác minh Reporting API đã được bật và cả bốn [địa chỉ IP egress của Living Security](/vi/integrations/managing/egress-ip-addresses) đều nằm trong danh sách cho phép.
  </Accordion>

  <Accordion title="Kết quả trống (200 OK nhưng không có dữ liệu)">
    Reporting API có thể chưa có dữ liệu để trả về, hoặc tài khoản của token không có quyền xem đối với người dùng và các chiến dịch mà Living Security tiếp nhận. Hãy xác minh token được tạo bởi một Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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