Skip to main content

​
이 연동이 제공하는 데이터

Netskope는 정규화된 웹, 클라우드, 인증, 데이터 보호 및 위협 활동을 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.
  • web.ai.visited — AI 웹사이트 방문
  • data.bulk.uploaded — 대량 데이터 업로드
  • geo.impossible — 로그인 간 불가능한 이동(impossible travel)
현재 연결은 REST API v2를 사용하며, 기존 고객에게는 레거시 REST 방식이 표시될 수 있습니다. 연동 데이터가 신호가 되는 방식을 참조하십시오.

​
Living Security에 필요한 정보

필요한 엔드포인트 액세스: 필요한 역할: Tenant Admin 또는 Settings → Tools에 액세스할 수 있는 동등한 역할
이 연동에는 v1 토큰이 아닌 v2 API 토큰이 필요합니다. v1 토큰은 쿼리 매개변수 인증을 사용하므로 v2 API 엔드포인트에서 작동하지 않습니다.

​
사전 요구 사항

  • REST API 토큰을 관리하려면 Netskope에서 Tenant Admin 권한이 있어야 합니다.

​
A부 — Netskope에서

Netskope 관리자가 다음 단계를 완료합니다.
1

REST API v2 토큰 관리로 이동

  1. https://<tenant>.goskope.com에서 Netskope 관리자 콘솔에 로그인합니다.
  2. 왼쪽 탐색 메뉴에서 Settings를 클릭합니다.
  3. Tools 아래에서 REST API v2를 선택합니다.
2

새 토큰 생성

  1. New Token을 클릭합니다.
  2. 식별하기 쉬운 이름을 입력합니다(예: Living Security Platform).
  3. 엔드포인트 액세스에서 다음에 대한 액세스를 활성화합니다.
두 엔드포인트를 모두 허용하십시오. 두 엔드포인트는 alerts 및 events이라는 별개의 두 스트림에 데이터를 공급하며, 둘 중 하나로만 범위가 지정된 토큰도 연결에는 성공합니다. 그러나 누락된 엔드포인트에 연결된 스트림은 오류 없이 아무 데이터도 반환하지 않으므로 원인을 알 수 없습니다.
이 두 엔드포인트만 Living Security에 필요합니다. 그 외의 권한을 부여하지 않는 것이 최소 권한 원칙에 부합합니다.
  1. Save(또는 Generate Token)를 클릭합니다.
3

토큰 복사 및 저장

토큰을 즉시 복사하여 안전하게 보관하십시오.
Netskope는 토큰 값을 생성 시 한 번만 표시합니다. 복사하지 않고 페이지를 벗어난 경우 토큰을 삭제하고 새로 만들어야 합니다.
4

IP 허용 목록 구성(해당하는 경우)

Netskope 테넌트에서 IP 허용 목록이 활성화되어 있다면 Living Security의 송신(egress) IP 대역을 추가해야 합니다.
  1. Netskope 관리자 콘솔에서 Settings → Administration → IP Allowlist로 이동합니다.
  2. IP 허용 목록이 활성화되어 있다면 각 Living Security 송신 IP 주소를 Custom IP 목록에 추가합니다.
IP 허용 목록이 활성화된 경우 연결 대화 상자에서는 성공하더라도, 올바른 IP가 추가될 때까지 데이터 동기화는 401 Unauthorized 오류와 함께 실패합니다.
5

테넌트 서브도메인 확인

테넌트 서브도메인은 Netskope 관리자 콘솔 URL의 접두사입니다.콘솔 URL이 https://acme.goskope.com인 경우 서브도메인은 acme입니다.서브도메인만 입력하십시오. https://, .goskope.com, 후행 슬래시는 포함하지 않습니다.
연결 대화 상자는 여러 입력 형식(서브도메인만, 전체 호스트 이름 또는 전체 URL)을 허용하며 자동으로 정규화합니다. 그래도 서브도메인만 입력하는 것을 권장합니다.

​
B부 — Living Security Platform에서

프로그램 담당자가 이 단계를 완료하며, 위임 설정을 사용하는 경우에는 시스템 관리자가 완료합니다.
이제 Netskope(v2 API)에 연결되었습니다.

​
문제 해결

일반적인 원인은 다음과 같습니다.
  1. 토큰이 취소되었거나 만료됨 — 새 토큰을 생성합니다.
  2. v1 토큰 사용 — v1 토큰은 쿼리 매개변수로 인증하므로 v2 엔드포인트에서 작동하지 않습니다. Settings → Tools → REST API v2에서 새 v2 토큰을 생성합니다.
  3. IP 허용 목록이 요청을 차단함 — 테넌트에서 IP 허용 목록이 활성화되어 있다면 Living Security 송신 IP 주소 네 개가 모두 허용 목록에 있는지 확인합니다.
토큰이 /api/v2/events/data/alert 또는 /api/v2/events/data/page에 대한 액세스 권한 없이 생성되었습니다. 토큰의 엔드포인트 권한은 생성 후 변경할 수 없으므로, 두 엔드포인트 모두에 읽기 권한이 있는 새 토큰을 생성한 후 다시 연결하십시오.
토큰에 필요한 두 엔드포인트 중 하나가 누락되어 있습니다. /api/v2/events/data/alert 또는 /api/v2/events/data/page 중 하나로만 범위가 지정된 토큰도 연결은 되지만, 누락된 엔드포인트에 연결된 스트림은 아무 알림 없이 계속 비어 있게 됩니다.엔드포인트 권한은 토큰 생성 후 변경할 수 없습니다. 두 엔드포인트 모두에 읽기 권한이 있는 새 토큰을 생성한 후 다시 연결하십시오.
IP 허용 목록이 활성화된 경우 Living Security의 송신 IP 주소가 변경되었을 수 있습니다. 연동 송신 IP 주소 구성을 확인하고 Custom IP 목록을 그에 맞게 업데이트하십시오.
v1 토큰과 v2 토큰은 서로 다른 인증 방식을 사용합니다.
  • v1: 쿼리 매개변수(token=...)
  • v2: 헤더(Netskope-Api-Token: ...)
Living Security는 v2 인증을 사용합니다. Settings → Tools → REST API v2(레거시 v1 토큰 페이지가 아님)에서 새 토큰을 생성하십시오.