Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Netskope

이 가이드에서는 Netskope를 Google Security Operations(Google SecOps)와 통합하는 방법을 설명합니다.

사용 사례

Netskope를 Google SecOps와 통합하면 다음과 같은 사용 사례를 해결할 수 있습니다.

피싱 URL 조사 및 차단: 피싱 URL 알림을 받으면 Google SecOps 기능을 사용하여 Netskope 클라우드 보안 플랫폼에 URL 평판 및 분류에 대한 정보를 쿼리합니다. URL이 악성으로 확인되면 Netskope는 조직 네트워크 전체에서 URL을 자동으로 차단할 수 있습니다.
멀웨어 분석 및 격리: Google SecOps 기능을 사용하여 동적 분석을 위해 Netskope에 멀웨어 샘플을 제출합니다. 분석 결과를 바탕으로 Netskope는 감염된 기기를 격리하거나 악성 명령 및 제어 서버와의 추가 통신을 차단하는 정책을 시행할 수 있습니다.
도용된 계정 해결: Google SecOps 기능을 사용하여 의심스러운 로그인 시도 또는 활동을 식별하고 비밀번호 재설정, 다중 인증 질문, 계정 정지와 같은 조치를 시행합니다.
취약점 스캔 및 패치: Google SecOps 기능을 사용하여 클라우드 애플리케이션에서 감지된 취약점에 대한 알림을 받습니다.
사고 대응 자동화: Google SecOps 기능을 사용하여 사용자 활동, 네트워크 트래픽, 데이터 액세스 로그와 같은 사고에 대한 컨텍스트 정보를 수집하고 영향을 받은 시스템 격리, 악성 트래픽 차단, 관련 이해관계자 알림과 같은 사고 대응 작업을 자동화합니다.
위협 인텔리전스 보강: Google SecOps 기능을 사용하여 Netskope 위협 인텔리전스 피드와 통합하고 추가 컨텍스트로 보안 알림을 보강합니다.

시작하기 전에

Google SecOps에서 Netskope 통합을 구성하기 전에 Netskope 테넌트에서 특정 사용자 인증 정보를 가져와야 합니다. 이 통합은 작업에서 사용하는 API 버전에 따라 두 가지 인증 방법을 지원합니다.

Netskope 플랫폼에서 이러한 설정을 찾는 방법에 대한 자세한 안내는 Netskope 기술 자료 포털을 참조하세요.

REST API V1 (기존)

이 메서드는 V1 API를 사용하는 작업에 필요합니다. 이 방법을 사용하려면 API 토큰 (API 키라고도 함)을 획득해야 합니다. 토큰 생성에 관한 안내는 Netskope REST API v1 개요를 참고하세요.

REST API V2 (OAuth 2.0)

이 메서드는 V2 API를 독점적으로 사용하는 작업 (알림 나열, 이벤트 나열, URL 목록에 항목 추가, URL 목록 변경사항 배포)과 Use V2 API 매개변수가 선택된 작업에 필요합니다.

V2 API를 사용하여 인증하려면 Netskope 테넌트(설정 > 도구 > REST API v2에서 구성되거나 RBAC v3을 사용하는 테넌트의 경우 설정 > 관리 > 관리자 및 역할에서 서비스 계정을 통해 구성됨)에서 다음 사용자 인증 정보를 가져와야 합니다.

클라이언트 ID: 새 OAuth 2.0 클라이언트 또는 서비스 계정을 만들 때 생성됩니다.
클라이언트 보안 비밀번호: 클라이언트 ID로 생성됩니다.

OAuth 2.0 클라이언트 설정 및 역할 할당에 대한 안내는 Netskope REST API V2 개요 및 관리자 RBAC V3 문서를 참조하세요.

필수 REST API V2 엔드포인트 및 범위

Netskope에서 OAuth 2.0 클라이언트 또는 RBAC v3 서비스 계정 역할을 구성할 때 실행하려는 작업에 필요한 최소 범위 (권한)를 부여합니다.

작업	필수 REST API V2 엔드포인트	필수 범위 (권한)
Ping (V2 API 사용 시) 알림 나열	`/api/v2/events/data/alert`	`Read`
이벤트 나열	`/api/v2/events/data/page` `/api/v2/events/data/application` `/api/v2/events/data/audit` `/api/v2/events/data/infrastructure` 이 작업에서 `Type` 매개변수를 지정하지 않으면 4개 엔드포인트 모두에 `Read` 액세스 권한을 부여합니다.	`Read`
List Clients(`Use V2 API`가 사용 설정된 경우)	`/api/v2/events/datasearch/clientstatus`	`Read`
격리된 파일 나열(`Use V2 API`가 사용 설정된 경우)	`/api/v2/casbapi/incidents/quarantine`	`Read`
파일 다운로드(`Use V2 API`가 사용 설정된 경우)	`/api/v2/casbapi/incidents/quarantine` `/api/v2/casbapi/apps/{app}/instances/{instance}/files/{file_id}/content`	`Read`
파일 허용(`Use V2 API`가 사용 설정된 경우)	`/api/v2/casbapi/incidents/quarantine/{file_id}/restore`	`Read+Write`
파일 차단(`Use V2 API`가 사용 설정된 경우)	`/api/v2/casbapi/incidents/quarantine/{file_id}/block`	`Read+Write`
URL 목록에 항목 추가	`/api/v2/policy/urllist`(`Read`) `/api/v2/policy/urllist/{id}/append`(`Read+Write`) `/api/v2/policy/urllist/deploy` (`Read+Write`, `Deploy URL List Changes`가 사용 설정된 경우 필요)	`Read+Write`
URL 목록 변경사항 배포	`/api/v2/policy/urllist/deploy`	`Read+Write`

네트워크 설정

통합의 네트워크 설정을 구성하려면 다음 표를 참조하세요.

함수	기본 포트	방향	프로토콜
API	443	아웃바운드	HTTPS

Google SecOps와 Netskope 통합

Netskope 통합에는 다음 매개변수가 필요합니다.

매개변수	설명
`Api Root`	필수 입력란입니다. Netskope 인스턴스의 API 루트입니다.
`Api Key`	(선택사항) V1 API를 사용하여 작업에 대해 인증하는 데 사용되는 Netskope 콘솔에서 가져온 API 토큰 값입니다.
`Client ID`	(선택사항) V2 API (OAuth 2.0) 인증에 사용되는 클라이언트 ID입니다. 이 매개변수는 V2 API를 사용하는 작업에 필요합니다.
`Client Secret`	(선택사항) V2 API (OAuth 2.0) 인증에 사용되는 클라이언트 보안 비밀번호입니다. 이 매개변수는 V2 API를 사용하는 작업에 필요합니다.
`Verify SSL`	(선택사항) 선택하면 통합에서 Netskope 서버에 연결할 때 SSL 인증서를 검증합니다.

Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참조하세요.

필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 다중 인스턴스 지원을 참고하세요.

작업

작업에 대한 자세한 내용은 Workdesk의 대기 중인 작업에 응답 및 케이스에서 수동 작업 실행을 참고하세요.

URL 목록에 항목 추가

URL 목록에 항목 추가 작업을 사용하여 기존 Netskope URL 목록에 새 URL, 도메인 또는 IP 주소를 추가합니다.

이 작업은 다음 Google SecOps 항목에서 실행됩니다.

Domain
IP Address
URL

작업 입력

Netskope 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`URL List Name`	필수 입력란입니다. 업데이트할 기존 Netskope URL 목록의 이름입니다 (예: `Allowed URLs`).
`Entries`	(선택사항) 목록에 추가할 URL, 도메인 또는 IP 주소의 쉼표로 구분된 목록입니다. 또한 이 작업은 케이스에 연결된 `URL`, `Domain`, `IP Address` 항목을 자동으로 처리합니다.
`Deploy URL List Changes`	(선택사항) 선택하면 이 작업은 업데이트 중인 목록뿐만 아니라 테넌트의 모든 URL 목록에서 대기 중인 모든 변경사항의 전역 배포를 트리거합니다.

URL List Name

필수 입력란입니다.

업데이트할 기존 Netskope URL 목록의 이름입니다 (예: Allowed URLs).

Entries

(선택사항)

목록에 추가할 URL, 도메인 또는 IP 주소의 쉼표로 구분된 목록입니다.

또한 이 작업은 케이스에 연결된 URL, Domain, IP Address 항목을 자동으로 처리합니다.

Deploy URL List Changes

(선택사항)

선택하면 이 작업은 업데이트 중인 목록뿐만 아니라 테넌트의 모든 URL 목록에서 대기 중인 모든 변경사항의 전역 배포를 트리거합니다.

작업 출력

Netskope 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 가능
출력 메시지	사용 가능
스크립트 결과	사용 가능

JSON 결과

다음 예시는 Netskope 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
  "added_entities": [
    "https://aistudio.google.com/prompts",
    "https://docs.google.com/"
  ],
  "failed_entities": [
    "not_real_url",
    10500
  ],
  "url_list_name": "Allowed URL List",
  "modify_by": "SOAR_API2",
  "modify_time": "2026-02-26T15:28:07.000Z",
  "pending": 1
}

출력 메시지

Netskope 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

출력 메시지	메시지 설명
`Successfully added the following entities to the URL_LIST_NAME list in Netskope: ADDED_ENTITIES. Changes are pending deployment.` `Action wasn't able to add the following entities to the URL_LIST_NAME list in Netskope: ENTITIES.` `None of the provided entities were added to the URL List URL_LIST_NAME in Netskope.`	작업이 완료되었습니다.
`Error executing action. Reason: ERROR_REASON`	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

Successfully added the following entities to the URL_LIST_NAME list in Netskope: ADDED_ENTITIES. Changes are pending deployment.

Action wasn't able to add the following entities to the URL_LIST_NAME list in Netskope: ENTITIES.

None of the provided entities were added to the URL List URL_LIST_NAME in Netskope.

작업이 완료되었습니다.

Error executing action. Reason:
     ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

다음 표에는 Netskope 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`is_success`	`true` 또는 `false`

파일 허용

파일 허용 작업을 사용하여 격리된 파일을 허용합니다.

이 작업은 모든 Google SecOps 항목에서 실행됩니다.

작업 입력

파일 허용 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`File ID`	필수 허용할 파일의 ID입니다.
`Quarantine Profile ID`	선택사항 파일과 연결된 격리 프로필의 ID입니다. 참고: 이 매개변수는 V1 API에 필수입니다.
`Use V2 API`	선택사항 선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다. 이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다. 이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 `Client ID` 및 `Client Secret`가 구성되어 있는지 확인합니다.

File ID

필수

허용할 파일의 ID입니다.

Quarantine Profile ID

선택사항

파일과 연결된 격리 프로필의 ID입니다.

Use V2 API

선택사항

선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다.

이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다.

이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 Client ID 및 Client Secret가 구성되어 있는지 확인합니다.

작업 출력

파일 허용 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
스크립트 결과	사용 가능

스크립트 결과

다음 표에는 파일 허용 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`is_success`	`True` 또는 `False`

파일 차단

파일 차단 작업을 사용하여 격리된 파일을 차단합니다.

이 작업은 모든 Google SecOps 항목에서 실행됩니다.

작업 입력

파일 차단 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`File ID`	필수 Netskope에서 차단할 파일의 ID입니다.
`Quarantine Profile ID`	선택사항 파일과 연결된 격리 프로필의 ID입니다. 참고: 이 매개변수는 V1 API에 필수입니다.
`Use V2 API`	선택사항 선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다. 이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다. 이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 `Client ID` 및 `Client Secret`가 구성되어 있는지 확인합니다.

File ID

필수

Netskope에서 차단할 파일의 ID입니다.

Quarantine Profile ID

선택사항

파일과 연결된 격리 프로필의 ID입니다.

Use V2 API

선택사항

선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다.

이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다.

이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 Client ID 및 Client Secret가 구성되어 있는지 확인합니다.

작업 출력

파일 차단 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
스크립트 결과	사용 가능

스크립트 결과

다음 표에는 파일 차단 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`is_success`	`True` 또는 `False`

URL 목록 변경사항 배포

URL 목록 변경사항 배포 작업을 사용하여 대기 중인 구성을 활성 정책 엔진에 푸시하여 URL 목록에 스테이징된 업데이트가 적용되고 시행되도록 합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

없음

작업 출력

URL 목록 변경사항 배포 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
출력 메시지	사용 가능
스크립트 결과	사용 가능

출력 메시지

URL 목록 변경사항 배포 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

출력 메시지	메시지 설명
`Successfully deployed pending Netskope policy changes.`	작업이 완료되었습니다.
`Error executing action. Reason: ERROR_REASON`	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

Successfully deployed pending Netskope policy changes.

작업이 완료되었습니다.

Error executing action. Reason:
     ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

다음 표에는 URL 목록 변경사항 배포 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`is_success`	`true` 또는 `false`

파일 다운로드

파일 다운로드 작업을 사용하여 격리된 파일을 다운로드합니다.

이 작업은 Google SecOps IP Address 항목에서 실행됩니다.

작업 입력

파일 다운로드 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`File ID`	필수 스팸 격리 저장소에서 다운로드할 파일의 ID입니다.
`Quarantine Profile ID`	선택사항 파일과 연결된 격리 프로필의 ID입니다. 참고: 이 매개변수는 V1 API에 필수입니다.
`Use V2 API`	선택사항 선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다. 이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다. 이 매개변수를 사용 설정하면 다음과 같은 요구사항과 변경사항이 적용됩니다. 인증: OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 `Client ID` 및 `Client Secret`가 구성되어 있는지 확인합니다. 저장소 로직: 이 매개변수를 사용 설정하면 소스가 기존 저장소에서 차세대 저장소로 전환됩니다.

File ID

필수

스팸 격리 저장소에서 다운로드할 파일의 ID입니다.

Quarantine Profile ID

선택사항

파일과 연결된 격리 프로필의 ID입니다.

Use V2 API

선택사항

선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다.

이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다.

이 매개변수를 사용 설정하면 다음과 같은 요구사항과 변경사항이 적용됩니다.

인증: OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 Client ID 및 Client Secret가 구성되어 있는지 확인합니다.
저장소 로직: 이 매개변수를 사용 설정하면 소스가 기존 저장소에서 차세대 저장소로 전환됩니다.

작업 출력

파일 다운로드 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
스크립트 결과	사용 가능

스크립트 결과

다음 표에는 파일 다운로드 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`is_success`	`True` 또는 `False`

알림 나열

알림 나열 작업을 사용하여 알림을 나열합니다.

이 작업은 모든 Google SecOps 항목에서 실행됩니다.

작업 입력

알림 나열 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
`Query`	선택사항 알림 데이터베이스에서 클라우드 애플리케이션 이벤트를 필터링하는 쿼리입니다.
`Type`	선택사항 필터링할 알림 유형입니다. 가능한 값은 다음과 같습니다. `Anomaly` `Compromised Credential` `Policy` `Legal Hold` `Malsite` `Malware` `DLP` `Watchlist` `Quarantine` `Remediation`
`Time Period`	선택사항 알림을 검색하기 위해 현재 시간 이전의 기간(밀리초)입니다. 지정할 수 있는 값은 `3600`, `86400`, `604800`, `2592000`입니다.
`Start Time`	선택사항 지정된 유닉스 시간보다 큰 타임스탬프가 있는 알림을 필터링하는 시작 시간입니다. `Time Period` 파라미터를 설정하지 않은 경우에만 이 파라미터를 사용합니다.
`End Time`	선택사항 지정된 유닉스 시간보다 작은 타임스탬프가 있는 알림을 필터링하는 종료 시간입니다. `Time Period` 파라미터를 설정하지 않은 경우에만 이 파라미터를 사용합니다.
`Is Acknowledged`	선택사항 선택하면 통합에서 확인된 알림을 필터링합니다. 기본적으로 선택되지 않습니다.
`Limit`	선택사항 반환할 결과 수입니다. 기본값은 `100`입니다.

작업 출력

알림 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 가능
출력 메시지	사용 가능
스크립트 결과	사용 가능

JSON 결과

다음 예시는 알림 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

[
    {
        "dstip": "192.0.2.1",
        "app": "Amazon Web Services",
        "profile_id": "ID",
        "device": "iPad",
        "shared_credential_user": "example@example.com",
        "app_session_id": 2961859388,
        "dst_location": "Ashburn",
        "dst_region": "Virginia",
        "policy": "Copy prohibited",
        "page_id": 380765822,
        "object_type": "File",
        "dst_latitude": 39.0481,
        "timestamp": 1548603047,
        "src_region": "California",
        "from_user": "user@example.com",
        "src_location": "San Luis Obispo",
        "traffic_type": "CloudApp",
        "appcategory": "IaaS/PaaS",
        "src_latitude": 35.2635,
        "count": 2,
        "type": "anomaly",
        "risk_level_id": 2,
        "activity": "Upload",
        "userip": "203.0.113.1",
        "src_longitude": -120.6509,
        "browser": "Safari",
        "alert_type": "anomaly",
        "event_type": "user_shared_credentials",
        "_insertion_epoch_timestamp": 1548601562,
        "site": "Amazon Web Services",
        "id": 3561,
        "category": "IaaS/PaaS",
        "orig_ty": "nspolicy",
        "dst_country": "US",
        "src_zipcode": "93401",
        "cci": 94,
        "ur_normalized": "user@example.com",
        "object": "quarterly_report.pdf",
        "organization_unit": "",
        "acked": "false",
        "dst_longitude": -77.4728,
        "alert": "yes",
        "user": "user@example.com",
        "userkey": "user@example.com",
        "srcip": "7198.51.100.1",
        "org": "example.com",
        "src_country": "US",
        "bin_timestamp": 1548633600,
        "dst_zipcode": "20149",
        "url": "http://aws.amazon.com/",
        "sv": "unknown",
        "ccl": "excellent",
        "alert_name": "user_shared_credentials",
        "risk_level": "high",
        "_mladc": ["ur"],
        "threshold_time": 86400,
        "_id": "cadee4a8488b3e139b084134",
        "os": "iOS 6"
    }
]

스크립트 결과

다음 표에는 알림 나열 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`alerts`	`ALERT_LIST`

클라이언트 나열

클라이언트 나열 작업을 사용하여 클라이언트를 나열합니다.

이 작업은 모든 Google SecOps 항목에서 실행됩니다.

작업 입력

클라이언트 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`Query`	선택사항 데이터베이스에서 검색된 클라이언트를 필터링합니다.
`Limit`	선택사항 작업에서 반환되는 클라이언트 수를 제한합니다. 기본값은 `25`입니다.
`Use V2 API`	선택사항 선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다. 이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다. 이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 `Client ID` 및 `Client Secret`가 구성되어 있는지 확인합니다.

Query

선택사항

데이터베이스에서 검색된 클라이언트를 필터링합니다.

Limit

선택사항

작업에서 반환되는 클라이언트 수를 제한합니다.

기본값은 25입니다.

Use V2 API

선택사항

선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다.

이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다.

이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 Client ID 및 Client Secret가 구성되어 있는지 확인합니다.

작업 출력

고객 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 가능
스크립트 결과	사용 가능

JSON 결과

다음 예시에서는 클라이언트 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

[
       {
         "client_install_time": 1532040251,
         "users":
        [
            {
                "heartbeat_status_since": 1532040385,
                "user_added_time": 1532040167,
                "last_event":
                {
                    "status": "Enabled",
                    "timestamp": 1548578307,
                    "event": "Tunnel Up",
                    "actor": "System"
                },
                "device_classification_status": "Not Configured",
                "username": "user@example.com",
                "user_source": "Manual",
                "userkey": "K00fuSXl8yMIqgdg",
                "_id": "ID",
                "heartbeat_status": "Active"
            }],
        "last_event":
        {
            "status": "Enabled",
            "timestamp": 1548578307,
            "event": "Tunnel Up",
            "actor": "System"
        },
        "host_info":
        {
            "device_model": "VMware Virtual Platform",
            "os": "Windows",
            "hostname": "HOSTNAME",
            "device_make": "VMware, Inc.",
            "os_version": "10.0"
        },
        "client_version": "1.1.1.1",
        "_id": "ID",
        "device_id": "DEVICE_ID"
    }
]

스크립트 결과

다음 표에는 클라이언트 나열 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`clients`	`CLIENT_LIST`

이벤트 나열

이벤트 나열 작업을 사용하여 이벤트를 나열합니다.

이 작업은 모든 Google SecOps 항목에서 실행됩니다.

작업 입력

이벤트 나열 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
`Query`	선택사항 이벤트 데이터베이스에서 클라우드 애플리케이션 이벤트를 필터링하는 쿼리입니다.
`Type`	선택사항 필터링할 알림 유형입니다. 가능한 값은 다음과 같습니다. `page` `application` `audit` `infrastructure`
`Time Period`	선택사항 이벤트를 검색할 현재 이전의 기간(밀리초)입니다. 가능한 값은 `3600`, `86400`, `604800`, `2592000`입니다.
`Start Time`	선택사항 지정된 유닉스 시간보다 큰 타임스탬프가 있는 이벤트를 필터링하는 시작 시간입니다. `Time Period` 파라미터를 설정하지 않은 경우에만 이 파라미터를 사용합니다.
`End Time`	선택사항 지정된 유닉스 시간보다 작은 타임스탬프가 있는 이벤트를 필터링하는 종료 시간입니다. `Time Period` 파라미터를 설정하지 않은 경우에만 이 파라미터를 사용합니다.
`Limit`	선택사항 반환할 결과 수입니다. 기본값은 `100`입니다.

작업 출력

이벤트 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
스크립트 결과	사용 가능

JSON 결과

다음 예시는 이벤트 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.


    {
        "dstip": "192.0.2.64",
        "browser_session_id": 1066949788113471080,
        "srcip": "198.51.100.36",
        "app_session_id": 4502249472406092569,
        "os_version": "WindowsServer2016",
        "dst_region": "Virginia",
        "numbytes": 37480,
        "req_cnt": 18,
        "server_bytes": 8994,
        "page_id": 0,
        "page_duration": 867,
        "page_endtime": 1548577530,
        "dst_latitude": 39.0481,
        "timestamp": 1548576663,
        "src_region": "Oregon",
        "src_location": "Boardman",
        "ur_normalized": "user@example.com",
        "appcategory": "",
        "src_latitude": 45.8491,
        "count": 1,
        "bypass_traffic": "no",
        "type": "page",
        "userip": "203.0.113.253",
        "src_longitude": -119.7143,
        "page": "WebBackground",
        "browser": "",
        "domain": "WebBackground",
        "dst_location": "Ashburn",
        "_insertion_epoch_timestamp": 1548577621,
        "site": "WebBackground",
        "access_method": "Client",
        "browser_version": "",
        "category": "",
        "client_bytes": 28486,
        "user_generated": "no",
        "hostname": "IP-C0A84AC",
        "dst_country": "US",
        "resp_cnt": 18,
        "src_zipcode": "97818",
        "traffic_type": "Web",
        "http_transaction_count": 18,
        "organization_unit": "example.com/Users",
        "page_starttime": 1548576663,
        "dst_longitude": -77.4728,
        "user": "user@example.com",
        "userkey": "user@example.com",
        "device": "WindowsDevice",
        "src_country": "US",
        "dst_zipcode": "20149",
        "url": "WebBackground",
        "sv": "",
        "ccl": "unknown",
        "useragent": "RestSharp/192.0.2.0",
        "_id": "ID",
        "os": "WindowsServer2016"
    }
]

스크립트 결과

다음 표에는 이벤트 나열 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`events`	`EVENT_LIST`

격리된 파일 나열

격리된 파일 나열 작업을 사용하여 격리된 파일을 나열합니다.

이 작업은 모든 Google SecOps 항목에서 실행됩니다.

작업 입력

격리된 파일 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`Start Time`	선택사항 Unix 형식의 이 매개변수 값보다 큰 타임스탬프가 있는 이벤트를 제한하는 시작 시간입니다.
`End Time`	선택사항 이 매개변수 값보다 작은 타임스탬프가 있는 이벤트를 Unix 형식으로 제한하는 종료 시간입니다.
`Use V2 API`	선택사항 선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다. 이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다. 이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 `Client ID` 및 `Client Secret`가 구성되어 있는지 확인합니다.

Start Time

선택사항

Unix 형식의 이 매개변수 값보다 큰 타임스탬프가 있는 이벤트를 제한하는 시작 시간입니다.

End Time

선택사항

이 매개변수 값보다 작은 타임스탬프가 있는 이벤트를 Unix 형식으로 제한하는 종료 시간입니다.

Use V2 API

선택사항

선택하면 작업에서 V1 대신 Netskope V2 API 엔드포인트를 사용합니다.

이를 위해서는 유효한 V2 API 사용자 인증 정보가 필요합니다.

이 매개변수에는 OAuth 2.0 지원이 필요합니다. 통합 설정에 유효한 Client ID 및 Client Secret가 구성되어 있는지 확인합니다.

작업 출력

격리된 파일 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
스크립트 결과	사용 가능

스크립트 결과

다음 표에는 격리된 파일 나열 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`files`	`FILE_LIST`

핑

핑 작업을 사용하여 Netskope에 대한 연결을 테스트합니다.

이 작업은 모든 Google SecOps 항목에서 실행됩니다.

작업 입력

없음

작업 출력

핑 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
스크립트 결과	사용 가능

스크립트 결과

다음 표에는 핑 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름	값
`is_success`	`True` 또는 `False`

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.