Skip to main content

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.

Living Security cần những gì

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

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

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 vào danh sách cho phép. Bốn địa chỉ này áp dụng giống nhau ở mọi vùng.
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ệ.
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 và xác minh rằng danh sách Allowed IP Addresses khớp với các địa chỉ này.
3

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ủ: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ị.
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.

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.
Quý vị đã được kết nối với KnowBe4.

Khắc phục sự cố

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.
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 đều nằm trong danh sách cho phép.
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.