Google SecOps와 Wiz 통합
이 문서에서는 Wiz를 Google Security Operations (Google SecOps)와 통합하는 방법을 설명합니다.
시작하기 전에
통합을 사용하려면 API 루트, 클라이언트 ID, 클라이언트 보안 비밀번호가 필요합니다.
이러한 사용자 인증 정보를 생성하는 방법에 대한 자세한 내용은 서비스 계정 설정을 참조하세요.
필수 서비스 계정 권한 및 범위
Wiz 서비스 계정에 Google SecOps에서 실행하려는 작업에 적합한 API 권한 범위가 부여되었는지 확인합니다.
읽기 및 쿼리 작업
| 작업/목적 | 사용 주체 | 필수 권한/범위 |
|---|---|---|
| 연결 테스트 | 핑 작업 | read:issues |
| 문제 세부정보 가져오기 | 문제 세부정보 가져오기 작업 | read:issuesread:posture_issuesread:threat_issuesread:comments |
| 리소스 취약점 발견 항목 나열 | 리소스 취약점 발견 항목 나열 작업 | read:vulnerabilities |
| 블루 에이전트 분석 가져오기 | 파란색 에이전트 분석 작업 가져오기 | read:threat_issues |
쓰기 및 수정 작업 (변형)
| 작업/목적 | 사용 주체 | 필수 권한/범위 |
|---|---|---|
| 문제 다시 열기 | 문제 다시 열기 작업 | write:issue_statusupdate:posture_issue_statuswrite:threat_issue_status |
| 문제 해결 | 문제 해결 작업 | write:threat_issue_statuswrite:threat_issues |
| 문제 무시 | 문제 무시 작업 | update:posture_issue_ignorewrite:issue_ignore |
| 문제에 댓글 추가 | 문제 작업에 댓글 추가 | write:issue_commentswrite:threat_issue_commentswrite:comments |
통합 매개변수
Wiz 통합에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
API Root |
필수 입력란입니다. Wiz 테넌트의 GraphQL API 엔드포인트 URL입니다. 엔드포인트는 정확한 엔드포인트 URL을 가져오려면 Wiz 테넌트 세부정보를 참조하세요. 번호가 지정되지 않은 일반적인 리전 URL을 사용하지 마세요. |
Authentication URL |
(선택사항) OAuth 액세스 토큰을 생성하는 데 사용되는 인증 URL입니다. 상업용 환경의 경우 기본값은 |
Client ID |
필수 입력란입니다. Wiz API 사용자 인증 정보와 연결된 클라이언트 ID입니다. |
Client Secret |
필수 입력란입니다. Wiz API 사용자 인증 정보와 연결된 클라이언트 보안 비밀번호입니다. |
Verify SSL |
필수 입력란입니다. 선택하면 통합에서 Wiz 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다. |
Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참조하세요.
필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 다중 인스턴스 지원을 참고하세요.
작업
작업에 대한 자세한 내용은 Workdesk의 대기 중인 작업에 응답 및 케이스에서 수동 작업 실행을 참고하세요.
핑
핑 작업을 사용하여 Wiz에 대한 연결을 테스트합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
없음
작업 출력
핑 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 불가 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과입니다. | 사용 가능 |
출력 메시지
Ping 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
|
작업이 완료되었습니다. |
Failed to connect to the Wiz server!
Error is ERROR_REASON |
작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요. |
스크립트 결과
다음 표에는 핑 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
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."
}
]
}
출력 메시지
문제 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
|
작업이 완료되었습니다. |
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의 |
작업이 완료되었습니다. |
Error executing action "Reopen Issue". Reason: ERROR_REASON |
작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요. |
스크립트 결과
다음 표에는 문제 다시 열기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
True 또는 False |
문제 무시
문제 무시 작업을 사용하여 Wiz에서 지정된 문제를 무시합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
문제 무시 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Issue ID |
필수 입력란입니다. Wiz에서 문제의 고유 식별자입니다. |
Resolution Reason |
필수 입력란입니다. 문제 해결 이유입니다. 가능한 값은 다음과 같습니다.
기본값은 |
Resolution Note |
(선택사항) 문제 해결에 대한 추가 컨텍스트를 제공하는 메모입니다. |
작업 출력
문제 무시 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시는 문제 무시 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
"note": "",
"status": "REJECTED",
"dueAt": null,
"resolutionReason": "FALSE_POSITIVE"
}
출력 메시지
문제 무시 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Wiz의 |
작업이 완료되었습니다. |
Error executing action "Ignore Issue". Reason: ERROR_REASON |
작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요. |
스크립트 결과
다음 표에는 문제 무시 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
True 또는 False |
문제 해결
문제 해결 작업을 사용하여 Wiz에서 지정된 문제를 해결합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
문제 해결 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Issue ID |
필수 입력란입니다. Wiz에서 문제의 고유 식별자입니다. |
Resolution Reason |
필수 입력란입니다. 문제 해결 이유입니다. 가능한 값은 다음과 같습니다.
기본값은 |
Resolution Note |
(선택사항) 해결 방법에 관한 추가 컨텍스트를 제공하는 메모입니다. |
작업 출력
문제 해결 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시는 문제 해결 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
"resolutionNote": "",
"status": "RESOLVED",
"dueAt": null,
"resolutionReason": "NOT_MALICIOUS_THREAT"
}
출력 메시지
문제 해결 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Wiz의 |
작업이 완료되었습니다. |
Error executing action "Resolve Issue". Reason: ERROR_REASON |
작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요. |
스크립트 결과
다음 표에는 문제 해결 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
True 또는 False |
문제에 댓글 추가
문제에 댓글 추가 작업을 사용하여 Wiz의 지정된 문제에 댓글을 추가합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
문제에 댓글 추가 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Issue ID |
필수 입력란입니다. Wiz에서 문제의 고유 식별자입니다. |
Comment |
필수 입력란입니다. 문제에 추가할 댓글의 텍스트입니다. |
작업 출력
문제에 댓글 추가 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 Add Comment To Issue 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"createdAt": "2025-08-01T11:59:00.843434941Z", "id":
"6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}
출력 메시지
문제에 댓글 추가 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Wiz의 |
작업이 완료되었습니다. |
Error executing action "Add Comment To Issue". Reason: ERROR_REASON |
작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요. |
스크립트 결과
다음 표에는 문제에 댓글 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
True 또는 False |
블루 에이전트 분석 받기
Get Blue Agent Analysis 작업을 사용하여 지정된 위협에 대한 Wiz Blue Agent의 분석 세부정보를 가져옵니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
Get Blue Agent Analysis 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Threat ID |
필수 입력란입니다. Wiz 위협 ID의 고유 식별자입니다. |
작업 출력
Get Blue Agent Analysis 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시는 블루 에이전트 분석 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"id": "threat-12345",
"threatType": "MALWARE_DETECTION",
"status": "COMPLETED",
"analysis": {
"summary": "Blue Agent analysis details",
"riskScore": "HIGH"
}
}
출력 메시지
Get Blue Agent Analysis 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Wiz의 |
작업이 완료되었습니다. |
Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON |
작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요. |
스크립트 결과
다음 표에는 블루 에이전트 분석 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
True 또는 False |
작업
작업에 대한 자세한 내용은 새 작업 구성 및 고급 예약을 참조하세요.
Wiz 및 Google SecOps 양방향 동기화 작업
Wiz 및 Google SecOps 양방향 동기화 작업을 사용하여 Wiz 위협과 Google SecOps 케이스 간의 지속적인 동기화를 유지합니다.
작업 매개변수
Wiz 및 Google SecOps 양방향 동기화 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Environment Name |
필수 입력란입니다. 케이스를 동기화할 환경의 이름입니다. 기본값은 |
Wiz API Root |
필수 입력란입니다. 테넌트의 Wiz GraphQL API 엔드포인트입니다. 엔드포인트는 정확한 엔드포인트 URL을 가져오려면 Wiz 테넌트 세부정보를 참조하세요. 번호가 지정되지 않은 일반적인 리전 URL을 사용하지 마세요. 기본 플레이스홀더 값은 |
Wiz Authentication URL |
(선택사항) OAuth 액세스 토큰을 생성하는 데 사용되는 인증 URL입니다. 상업용 환경의 경우 기본값은 |
Wiz Client ID |
필수 입력란입니다. Wiz API 서비스 계정의 클라이언트 ID입니다. |
Wiz Client Secret |
필수 입력란입니다. Wiz API 서비스 계정의 클라이언트 보안 비밀번호입니다. |
Max Hours Backwards |
(선택사항) 업데이트된 케이스를 가져올 초기 작업 반복 전 시간입니다 (범위: 1~720, 기본값: 24). 이 매개변수는 첫 번째 작업 실행에 적용되거나 마지막 실행 타임스탬프가 재설정된 경우 대체로 적용됩니다. |
Verify SSL |
필수 입력란입니다. 선택하면 통합에서 Wiz 서버에 연결할 때 SSL 인증서를 검증합니다. 이 설정은 기본적으로 선택됩니다. |
Fields to sync |
필수 입력란입니다. 동기화할 필드를 결정하는 쉼표로 구분된 목록입니다. 여기에 명시적으로 나열된 필드만 동기화됩니다. 가능한 값은 기본값은 |
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.