Thiết lập tích hợp Netskope

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

Netskope có thể cung cấp dữ liệu hoạt động web, đám mây, xác thực, bảo vệ dữ liệu và mối đe dọa đã được chuẩn hóa. Các ví dụ đã được xem xét bao gồm:

web.ai.visited — Truy cập trang web AI
data.bulk.uploaded — tải lên dữ liệu số lượng lớn
geo.impossible — di chuyển bất khả thi giữa các lần đăng nhập

Kết nối hiện tại sử dụng REST API v2; một biến thể REST cũ có thể xuất hiện đối với các khách hàng hiện hữu. Xem cách dữ liệu tích hợp trở thành tín hiệu.

Living Security cần những gì

Thông tin xác thực	Mô tả
API token	Token REST API v2 được tạo từ bảng điều khiển quản trị Netskope
Tenant subdomain	Tên miền phụ của tenant Netskope của bạn (ví dụ: `acme` từ `acme.goskope.com`)

Quyền truy cập endpoint bắt buộc:

Endpoint	Mục đích
`/api/v2/events/data/alert`	Cảnh báo mối đe dọa, vi phạm chính sách, sự kiện DLP, phát hiện phần mềm độc hại
`/api/v2/events/data/page`	Hoạt động web — duyệt web, các trang được cho phép và bị chặn, truy cập ứng dụng đám mây

Vai trò bắt buộc: Tenant Admin hoặc vai trò tương đương có quyền truy cập Settings → Tools

Tích hợp này yêu cầu token API v2, không phải token v1. Token v1 sử dụng xác thực bằng tham số truy vấn và sẽ không hoạt động với endpoint API v2.

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

Bạn phải có quyền truy cập Tenant Admin trong Netskope để quản lý các token REST API.

Phần A — Trong Netskope

Quản trị viên Netskope của bạn thực hiện các bước này.

Điều hướng đến mục quản lý token REST API v2

Đăng nhập vào bảng điều khiển quản trị Netskope của bạn tại https://<tenant>.goskope.com.
Trong thanh điều hướng bên trái, nhấp vào Settings.
Trong mục Tools, chọn REST API v2.

Tạo token mới

Nhấp vào New Token.
Nhập một tên mô tả (ví dụ: Living Security Platform).
Trong phần quyền truy cập endpoint, bật quyền truy cập cho:

Endpoint	Quyền truy cập yêu cầu
`/api/v2/events/data/alert`	Read
`/api/v2/events/data/page`	Read

Hãy cấp quyền cho cả hai endpoint. Chúng cung cấp dữ liệu cho hai luồng riêng biệt — alerts và events — và một token chỉ được giới hạn phạm vi cho một trong hai endpoint vẫn kết nối thành công. Khi đó, luồng tương ứng với endpoint bị thiếu sẽ không trả về dữ liệu nào, và không có lỗi nào cho bạn biết lý do.

Hai endpoint này là những endpoint duy nhất mà Living Security yêu cầu. Việc không cấp thêm quyền nào ngoài hai endpoint này tuân thủ nguyên tắc đặc quyền tối thiểu.

Nhấp vào Lưu (hoặc Generate Token).

Sao chép và lưu token của bạn

Hãy sao chép token ngay lập tức và lưu trữ an toàn.

Netskope chỉ hiển thị giá trị token một lần duy nhất khi tạo. Nếu bạn rời khỏi trang mà chưa sao chép, bạn phải xóa token và tạo token mới.

Cấu hình danh sách cho phép IP (nếu áp dụng)

Nếu tenant Netskope của bạn đã bật danh sách cho phép IP, bạn phải thêm các dải IP đầu ra của Living Security.

Trong bảng điều khiển quản trị Netskope, đi tới Settings → Administration → IP Allowlist.
Nếu danh sách cho phép IP đã được bật, hãy thêm từng địa chỉ IP đầu ra của Living Security vào danh sách Custom IP.

Nếu danh sách cho phép IP được bật, hộp thoại kết nối sẽ thành công, nhưng việc đồng bộ dữ liệu sẽ thất bại với lỗi 401 Unauthorized cho đến khi các IP chính xác được thêm vào.

Xác định tenant subdomain của bạn

Tenant subdomain của bạn là phần tiền tố trong URL bảng điều khiển quản trị Netskope.Nếu URL bảng điều khiển của bạn là https://acme.goskope.com, thì subdomain của bạn là acme.Chỉ nhập subdomain thuần — không có https://, không có .goskope.com, không có dấu gạch chéo ở cuối.

Hộp thoại kết nối chấp nhận nhiều dạng nhập (subdomain thuần, tên máy chủ đầy đủ hoặc URL đầy đủ) và tự động chuẩn hóa. Tuy nhiên, nên nhập subdomain thuần.

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.

Bây giờ bạn đã được kết nối với Netskope (v2 API).

Khắc phục sự cố

401 Unauthorized

Các nguyên nhân thường gặp:

Token bị thu hồi hoặc hết hạn — hãy tạo token mới
Sử dụng token v1 — token v1 xác thực qua tham số truy vấn và sẽ không hoạt động với các endpoint v2. Hãy tạo token v2 mới từ Settings → Tools → REST API v2
Danh sách cho phép IP chặn các yêu cầu — nếu tenant của bạn đã bật danh sách cho phép IP, hãy xác minh rằng cả bốn địa chỉ IP đầu ra của Living Security đều nằm trong danh sách cho phép

403 Forbidden

Token được tạo mà không có quyền truy cập vào /api/v2/events/data/alert hoặc /api/v2/events/data/page. Quyền endpoint của token không thể thay đổi sau khi tạo — hãy tạo token mới có quyền đọc đối với cả hai và kết nối lại.

Cảnh báo được nhận nhưng thiếu hoạt động web (hoặc ngược lại)

Token thiếu một trong hai endpoint bắt buộc. Một token chỉ được giới hạn phạm vi cho /api/v2/events/data/alert hoặc chỉ cho /api/v2/events/data/page vẫn kết nối được, và luồng tương ứng với endpoint bị thiếu vẫn trống mà không có thông báo.Quyền endpoint không thể thay đổi sau khi token được tạo — hãy tạo token mới có quyền đọc đối với cả hai, sau đó kết nối lại.

Đồng bộ từng hoạt động nhưng hiện thất bại với lỗi 401

Nếu danh sách cho phép IP được bật, các địa chỉ IP đầu ra của Living Security có thể đã thay đổi. Hãy kiểm tra Cấu hình địa chỉ IP đầu ra của tích hợp và cập nhật danh sách Custom IP cho khớp.

Sử dụng token v1 thay vì v2

Token v1 và v2 sử dụng các cơ chế xác thực khác nhau:

v1: Tham số truy vấn (token=...)
v2: Header (Netskope-Api-Token: ...)

Living Security sử dụng xác thực v2. Hãy tạo token mới từ Settings → Tools → REST API v2 (không phải trang token v1 cũ).

Tích hợp