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

> Kết nối NINJIO với Living Security Platform để nhập kết quả đào tạo nhận thức về bảo mật và kết quả mô phỏng phishing cho lực lượng lao động của Quý vị.

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

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

NINJIO có thể đóng góp các Kết quả về Lực lượng lao động, Đào tạo và mô phỏng phishing. Các ví dụ đã được xem xét gồm:

* `training.assigned` — được giao khóa đào tạo bảo mật
* `training.completed` — hoàn thành khóa đào tạo bảo mật
* `training.passed` — vượt qua các bài đánh giá đào tạo bảo mật
* `phishing.simulation.clicked` — nhấp vào một mô phỏng mà không báo cáo
* `phishing.simulation.reported` — báo cáo các mô phỏng phishing

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 cần

| Thông tin xác thực | Mô tả |
| - | - |
| **Khóa API** | Khóa API của NINJIO có quyền đọc đối với các điểm truy cập nhân viên, đào tạo và phishing. Living Security gửi khóa này trong mọi yêu cầu. |

**Phạm vi quyền:** NINJIO cấp phạm vi quyền cho từng khóa API theo từng *điểm truy cập*, với quyền đọc và quyền ghi riêng biệt. Living Security cần quyền **đọc** đối với ba điểm truy cập: nhân viên, đào tạo và phishing. Không cần quyền ghi và không nên cấp quyền này.

**Vai trò bắt buộc:** **Administrator** (Quản trị viên) trên tài khoản NINJIO của Quý vị. Chỉ quản trị viên mới truy cập được khu vực Integration nơi tạo khóa.

<Warning>
  **NINJIO chỉ hiển thị khóa mới một lần duy nhất, ngay tại thời điểm khóa được tạo.** Hãy sao chép khóa trực tiếp vào Living Security Platform hoặc vào kho lưu trữ mật khẩu trước khi rời khỏi trang. Khóa chưa được sao chép sẽ không thể truy xuất lại — Quý vị phải tạo một khóa thay thế.
</Warning>

### Những gì Living Security truy xuất

| Dữ liệu | Chi tiết |
| - | - |
| **Người học** | Danh bạ nhân viên NINJIO của Quý vị: tên, email, phòng ban, chức danh, người quản lý, quốc gia, chi nhánh và trạng thái đang hoạt động. |
| **Đào tạo** | Ai được giao từng khóa đào tạo và ai đã hoàn thành — kèm ngày hoàn thành, điểm bài kiểm tra và điểm mức độ tương tác. |
| **Lừa đảo** | Ai đã tương tác với email mô phỏng phishing và ai đã báo cáo email đó, kèm thời điểm xảy ra. |

<Note>
  **Số điện thoại của Người học không được lưu trữ.** NINJIO trả về số điện thoại trong hồ sơ nhân viên. Living Security loại bỏ thông tin này trước khi lưu trữ bất kỳ dữ liệu nào, vì không có tính năng nào của Living Security sử dụng đến nó.
</Note>

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

* Một tài khoản NINJIO có quyền truy cập API.
* Quyền truy cập quản trị viên vào [admin.goninjio.com](https://admin.goninjio.com/).
* Địa chỉ email của Người học trong NINJIO khớp với địa chỉ mà các hệ thống được kết nối khác của Quý vị sử dụng. Email là cách Living Security đối sánh một Người học NINJIO với một cá nhân.

***

## Phần A — Trong NINJIO

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

<Steps>
  <Step title="Mở khu vực Integration">
    1. Đăng nhập vào [admin.goninjio.com](https://admin.goninjio.com/) với tư cách quản trị viên.
    2. Chọn **Integration** ở góc trên bên phải màn hình.
  </Step>

  <Step title="Tạo khóa API">
    1. Chọn **New API Key**.
    2. Đặt cho khóa một tên dễ nhận biết sau này — ví dụ `Living Security`.
    3. Cấp quyền **đọc** đối với các điểm truy cập **employee**, **training** và **phishing**.
    4. Không chọn quyền ghi. Living Security chỉ đọc dữ liệu từ NINJIO.
    5. Chọn **Generate Key**.

    <Warning>
      Hãy sao chép khóa ngay bây giờ. NINJIO chỉ hiển thị khóa một lần và không thể hiển thị lại.
    </Warning>
  </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="NINJIO">
    | Trường | Giá trị |
    | - | - |
    | **Khóa API** | Khóa Quý vị đã tạo ở Phần A |
  </ConnectInPlatform>
</Steps>

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

***

## Tần suất truy xuất dữ liệu

| Dữ liệu | Lịch trình |
| - | - |
| Người học | Hằng ngày |
| Kết quả đào tạo | Mỗi 6 giờ |
| Kết quả lừa đảo | Mỗi 6 giờ |

Khi kết nối lần đầu, Living Security truy xuất dữ liệu hoàn thành đào tạo của 12 tháng gần nhất, sau đó tiếp tục cập nhật theo từng phần. Mỗi mô phỏng phishing được đọc một lần và được kiểm tra lại trong hai tuần sau khi kết thúc, nhờ đó các lượt nhấp và báo cáo muộn vẫn được ghi nhận.

<Note>
  Lần kết nối đầu tiên trên tài khoản NINJIO lớn có thể cần nhiều lượt chạy theo lịch để đọc xong toàn bộ dữ liệu. Mỗi lượt chạy đọc nhiều nhất có thể và lượt tiếp theo tiếp tục từ điểm dừng, do đó số liệu sẽ tăng dần trong một đến hai ngày đầu thay vì xuất hiện cùng một lúc.
</Note>

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Khóa API không đúng hoặc không đầy đủ. Nguyên nhân phổ biến nhất là khóa bị sao chép thiếu — NINJIO chỉ hiển thị khóa một lần, nên rất dễ dán thiếu và không thể phát hiện sau đó. Hãy tạo khóa mới trong NINJIO và kết nối lại bằng khóa đó.
  </Accordion>

  <Accordion title="403 Forbidden">
    Đây **không** phải là sự cố về thông tin xác thực. Khóa đã được xác thực, nhưng một trong các điểm truy cập cần thiết chưa được cấp quyền đọc.

    Dán lại cùng một khóa sẽ không giải quyết được vấn đề. Trong NINJIO, hãy tạo khóa có quyền **đọc** đối với cả ba điểm truy cập — employee, training và phishing — rồi kết nối lại bằng khóa đó.
  </Accordion>

  <Accordion title="Kết nối thành công nhưng không có dữ liệu đào tạo">
    Hãy kiểm tra trong NINJIO xem có ít nhất một chiến dịch đào tạo đang **hoạt động** và có gắn mô phỏng hay không. Chiến dịch không có mô phỏng sẽ không hoạt động và không cung cấp gì, nên không có kết quả để truy xuất.

    Nếu các chiến dịch đang hoạt động, hãy xác nhận rằng Người học trong các chiến dịch đó có địa chỉ email trong hồ sơ NINJIO. Người học không có địa chỉ email sẽ không thể đối sánh với một cá nhân và sẽ bị bỏ qua.
  </Accordion>

  <Accordion title="Đào tạo hiển thị là đã được giao nhưng chưa bao giờ hoàn thành">
    Đây là cách hiển thị bình thường đối với khóa đào tạo mà Người học chưa hoàn tất. Living Security ghi nhận việc giao khóa khi mô phỏng NINJIO bắt đầu, và ghi nhận việc hoàn thành riêng khi NINJIO báo cáo ngày hoàn thành.
  </Accordion>

  <Accordion title="Thiếu một số Người học">
    Living Security đối sánh một Người học NINJIO với một cá nhân theo **địa chỉ email**. Người học có email trong NINJIO khác với địa chỉ trong danh bạ của Quý vị — như địa chỉ cá nhân, tên miền cũ hoặc lỗi chính tả — sẽ không được đối sánh.

    Hãy sửa địa chỉ trong NINJIO và Người học sẽ được đối sánh ở lần truy xuất theo lịch tiếp theo.
  </Accordion>

  <Accordion title="Thiếu kết quả lừa đảo của một mô phỏng cũ">
    Living Security kiểm tra lại một mô phỏng phishing trong hai tuần sau khi kết thúc, rồi dừng. Các kết quả mà NINJIO ghi nhận sau khoảng thời gian đó sẽ không được thu thập. Hãy liên hệ bộ phận hỗ trợ nếu Quý vị cần đọc lại một mô phỏng cũ.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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