Wiz를 Google SecOps와 통합

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

시작하기 전에

통합을 사용하려면 API 루트, 클라이언트 ID, 클라이언트 보안 비밀번호가 필요합니다.

이 사용자 인증 정보를 생성하는 방법에 대한 자세한 내용은 서비스 계정 설정을 참고하세요.

필수 서비스 계정 권한 및 범위

Google SecOps에서 실행하려는 작업에 적합한 API 권한 범위가 Wiz 서비스 계정에 부여되어 있는지 확인합니다.

읽기 및 쿼리 작업

작업 / 목적 사용 주체 필수 권한 / 범위
연결 테스트 Ping Action read:issues
문제 세부정보 가져오기 문제 세부정보 가져오기 작업 read:issues
read:posture_issues
read:threat_issues
read:comments
리소스 취약점 발견 항목 나열 리소스 취약점 발견 항목 나열 작업 read:vulnerabilities
Get Blue Agent Analysis Get Blue Agent Analysis Action read:threat_issues

쓰기 및 수정 작업 (변형)

작업 / 목적 사용 주체 필수 권한 / 범위
문제 다시 열기 문제 다시 열기 작업 write:issue_status
update:posture_issue_status
write:threat_issue_status
문제 해결 문제 해결 작업 write:threat_issue_status
write:threat_issues
문제 무시 문제 무시 작업 update:posture_issue_ignore
write:issue_ignore
문제에 댓글 추가 문제에 댓글 추가 작업 write:issue_comments
write:threat_issue_comments
write:comments

통합 매개변수

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

매개변수 설명
API Root

필수 항목입니다.

Wiz 테넌트의 GraphQL API 엔드포인트 URL입니다.

엔드포인트는 https://api.<region>.app.wiz.io/graphql (또는 Wiz for Gov의 경우 https://api.<region>.app.wiz.us/graphql) 형식을 따라야 합니다. 여기서 <region>는 할당된 Wiz 데이터 센터 리전 (예: us1, us2, eu1 또는 eu2)을 나타냅니다.

정확한 엔드포인트 URL은 Wiz 테넌트 세부정보를 참고하세요. 일반적인 번호가 지정되지 않은 지역 URL을 사용하지 마세요.

Authentication URL

(선택사항)

OAuth 액세스 토큰을 생성하는 데 사용되는 인증 URL입니다. 상업용 환경의 경우 https://auth.app.wiz.io을 사용합니다. Wiz for Gov (FedRAMP) 환경의 경우 https://auth.app.wiz.us를 사용합니다.

기본값은 https://auth.app.wiz.io입니다.

Client ID

필수 항목입니다.

Wiz API 사용자 인증 정보와 연결된 클라이언트 ID입니다.

Client Secret

필수 항목입니다.

Wiz API 사용자 인증 정보와 연결된 클라이언트 보안 비밀번호입니다.

Verify SSL

필수 항목입니다.

선택하면 Wiz 서버에 연결할 때 통합에서 SSL 인증서를 검증합니다.

기본적으로 사용 설정됩니다.

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

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

작업

작업에 대한 자세한 내용은 내 Workdesk에서 대기 중인 작업에 응답 및 직접 조치 실행을 참고하세요.

핑

Ping 작업을 사용하여 Wiz와의 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

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

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

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

출력 메시지 메시지 설명

Successfully connected to the Wiz server with the provided connection parameters!

작업이 완료되었습니다.
Failed to connect to the Wiz server! Error is ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

문제 세부정보 가져오기

문제 세부정보 가져오기 작업을 사용하여 Wiz에서 지정된 문제에 관한 정보를 가져옵니다.

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

작업 입력

문제 세부정보 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Issue ID

필수 항목입니다.

가져오거나 조치를 취할 Wiz 문제의 고유 식별자입니다.

작업 출력

문제 세부정보 가져오기 작업은 다음 출력을 제공합니다.

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

다음 예는 문제 세부정보 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
   "id": "f54e3fb9-a520-4e99-aacc-b99f6ae7f28d",
   "createdAt": "2025-07-26T11:47:43.94524Z",
   "updatedAt": "2025-07-31T07:34:54.445702Z",
   "status": "RESOLVED",
   "severity": "CRITICAL",
   "type": "TOXIC_COMBINATION",
   "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc.",
   "resolvedAt": "2025-07-31T07:34:54.445702Z",
   "entitySnapshot": {
       "cloudPlatform": "GCP",
       "id": "1971f945-3476-5b3d-a5a1-ab166c3e2eca",
       "name": "cluster-solr",
       "region": "us-central1",
       "subscriptionName": "Wiz-Labs",
       "type": "KUBERNETES_CLUSTER"
   },
   "projects": [
       {
           "id": "904cbc14-1c52-571c-a6b8-46fee263eb0f",
           "name": "GCP Lab"
       }
   ],
   "sourceRules": [
       {
           "id": "wc-id-1038",
           "name": "Container using an image infected with critical/high severity malware",
           "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc."
       }
   ]
}
출력 메시지

문제 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully returned details for the following issue using information from Wiz: ISSUE_ID

The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID

작업이 완료되었습니다.
Error executing action "Get Issue Details". Reason: ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

다음 표에는 문제 세부정보 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

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

문제 다시 열기

문제 다시 열기 작업을 사용하여 Wiz에서 지정된 문제를 다시 엽니다.

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

작업 입력

문제 다시 열기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Issue ID

필수 항목입니다.

가져오거나 업데이트할 Wiz의 문제의 고유 식별자입니다.

작업 출력

문제 다시 열기 작업은 다음 출력을 제공합니다.

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

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

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "OPEN",
    "dueAt": null,
    "resolutionReason": null
}
출력 메시지

문제 다시 열기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Wiz의 Successfully reopened issue with ID ISSUE_ID

작업이 완료되었습니다.
Error executing action "Reopen Issue". Reason: ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

문제 무시

문제 무시 작업을 사용하여 Wiz에서 지정된 문제를 무시합니다.

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

작업 입력

문제 무시 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Issue ID

필수 항목입니다.

Wiz의 문제 고유 식별자입니다.

Resolution Reason

필수 항목입니다.

문제 해결 이유입니다.

가능한 값은 다음과 같습니다.

  • False Positive
  • Exception
  • Won't Fix~

기본값은 False Positive입니다.

Resolution Note

(선택사항)

문제 해결에 관한 추가 컨텍스트를 제공하는 메모입니다.

작업 출력

문제 무시 작업을 수행하면 다음과 같은 출력이 제공됩니다.

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

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

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "REJECTED",
    "dueAt": null,
    "resolutionReason": "FALSE_POSITIVE"
}
출력 메시지

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

출력 메시지 메시지 설명

Wiz의 Successfully ignored issue with ID ISSUE_ID

작업이 완료되었습니다.
Error executing action "Ignore Issue". Reason: ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

문제 해결

문제 해결 작업을 사용하여 Wiz에서 지정된 문제를 해결합니다.

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

작업 입력

문제 해결 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Issue ID

필수 항목입니다.

Wiz의 문제 고유 식별자입니다.

Resolution Reason

필수 항목입니다.

문제 해결 이유입니다.

가능한 값은 다음과 같습니다.

  • Malicious Threat
  • Not Malicious Threat
  • Security Test Threat
  • Planned Action Threat
  • Inconclusive Threat

기본값은 Not Malicious Threat입니다.

Resolution Note

(선택사항)

해결에 관한 추가 컨텍스트를 제공하는 메모입니다.

작업 출력

문제 해결 작업은 다음 출력을 제공합니다.

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

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

{
    "id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
    "resolutionNote": "",
    "status": "RESOLVED",
    "dueAt": null,
    "resolutionReason": "NOT_MALICIOUS_THREAT"
}
출력 메시지

문제 해결 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Wiz의 Successfully resolved issue with ID ISSUE_ID

작업이 완료되었습니다.
Error executing action "Resolve Issue". Reason: ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

문제에 댓글 추가

문제에 댓글 추가 작업을 사용하여 Wiz의 지정된 문제에 댓글을 추가합니다.

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

작업 입력

문제에 댓글 추가 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Issue ID

필수 항목입니다.

Wiz의 문제 고유 식별자입니다.

Comment

필수 항목입니다.

문제에 추가할 댓글의 텍스트입니다.

작업 출력

문제에 댓글 추가 작업은 다음 출력을 제공합니다.

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

다음 예는 문제에 댓글 추가 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
  "createdAt": "2025-08-01T11:59:00.843434941Z", "id":
  "6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}
출력 메시지

문제에 댓글 추가 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Wiz의 Successfully added a comment to the issue with ID ISSUE_ID

작업이 완료되었습니다.
Error executing action "Add Comment To Issue". Reason: ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

Blue Agent 분석 받기

Get Blue Agent Analysis 작업을 사용하여 지정된 위협에 대한 Wiz Blue Agent의 분석 세부정보를 가져옵니다.

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

작업 입력

Get Blue Agent Analysis 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Threat ID

필수 항목입니다.

Wiz 위협 ID의 고유 식별자입니다.

작업 출력

Get Blue Agent Analysis 작업은 다음 출력을 제공합니다.

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

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

{
  "id": "threat-12345",
  "threatType": "MALWARE_DETECTION",
  "status": "COMPLETED",
  "analysis": {
    "summary": "Blue Agent analysis details",
    "riskScore": "HIGH"
  }
}
출력 메시지

Get Blue Agent Analysis 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Wiz의 Successfully retrieved blue agent analysis for threat ID THREAT_ID

작업이 완료되었습니다.
Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

작업

작업에 대한 자세한 내용은 새 작업 구성 및 고급 예약을 참고하세요.

Wiz 및 Google SecOps 양방향 동기화 작업

Wiz 및 Google SecOps 양방향 동기화 작업을 사용하여 Wiz 위협과 Google SecOps 케이스 간의 지속적인 동기화를 유지합니다.

작업 매개변수

Wiz 및 Google SecOps 양방향 동기화 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Environment Name

필수 항목입니다.

케이스를 동기화할 환경의 이름입니다.

기본값은 Default Environment입니다.

Wiz API Root

필수 항목입니다.

테넌트의 Wiz GraphQL API 엔드포인트입니다.

엔드포인트는 https://api.<region>.app.wiz.io/graphql (또는 Wiz for Gov의 경우 https://api.<region>.app.wiz.us/graphql) 형식을 따라야 합니다. 여기서 <region>는 할당된 Wiz 데이터 센터 리전 (예: us1, us2, eu1 또는 eu2)을 나타냅니다.

정확한 엔드포인트 URL은 Wiz 테넌트 세부정보를 참고하세요. 일반적인 번호가 지정되지 않은 지역 URL을 사용하지 마세요.

기본 자리표시자 값은 https://api.<region>.app.wiz.io/graphql입니다. <region>을 할당된 Wiz 데이터 센터 리전으로 바꿉니다.

Wiz Authentication URL

(선택사항)

OAuth 액세스 토큰을 생성하는 데 사용되는 인증 URL입니다. 상업용 환경의 경우 https://auth.app.wiz.io을 사용합니다. Gov (FedRAMP) 환경용 Wiz의 경우 https://auth.app.wiz.us를 사용합니다.

기본값은 https://auth.app.wiz.io입니다.

Wiz Client ID

필수 항목입니다.

Wiz API 서비스 계정의 클라이언트 ID입니다.

Wiz Client Secret

필수 항목입니다.

Wiz API 서비스 계정의 클라이언트 보안 비밀번호입니다.

Max Hours Backwards

(선택사항)

업데이트된 케이스를 가져올 초기 작업 반복 전 시간입니다 (범위: 1~720, 기본값: 24). 이 매개변수는 첫 번째 작업 실행에 적용되거나 마지막 실행 타임스탬프가 재설정된 경우 대체로 적용됩니다.

Verify SSL

필수 항목입니다.

선택하면 Wiz 서버에 연결할 때 통합에서 SSL 인증서를 검증합니다.

기본적으로 선택되어 있습니다.

Fields to sync

필수 항목입니다.

동기화할 필드를 결정하는 쉼표로 구분된 목록입니다. 여기에 명시적으로 나열된 필드만 동기화됩니다. 가능한 값은 Status, Comments, Product Link, Severity입니다.

기본값은 Status, Comments, Product Link, Severity입니다.

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