Wiz를 Google SecOps와 통합
이 문서에서는 Wiz를 Google Security Operations (Google SecOps)와 통합하는 방법을 설명합니다.
시작하기 전에
통합을 사용하려면 API 루트, 클라이언트 ID, 클라이언트 보안 비밀번호가 필요합니다.
이 사용자 인증 정보를 생성하는 방법에 대한 자세한 내용은 서비스 계정 설정을 참고하세요.
필수 서비스 계정 권한 및 범위
Google SecOps에서 실행하려는 작업에 적합한 API 권한 범위가 Wiz 서비스 계정에 부여되어 있는지 확인합니다.
읽기 및 쿼리 작업
| 작업 / 목적 | 사용 주체 | 필수 권한 / 범위 |
|---|---|---|
| 연결 테스트 | Ping Action | read:issues |
| 문제 세부정보 가져오기 | 문제 세부정보 가져오기 작업 | read:issuesread:posture_issuesread:threat_issuesread:comments |
| 리소스 취약점 발견 항목 나열 | 리소스 취약점 발견 항목 나열 작업 | read:vulnerabilities |
| Get Blue Agent Analysis | Get Blue Agent Analysis Action | 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에서 대기 중인 작업에 응답 및 직접 조치 실행을 참고하세요.
핑
Ping 작업을 사용하여 Wiz와의 연결을 테스트합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
없음
작업 출력
Ping 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 불가 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과입니다. | 사용 가능 |
출력 메시지
Ping 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
|
작업이 완료되었습니다. |
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."
}
]
}
출력 메시지
문제 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
|
작업이 완료되었습니다. |
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 결과
다음 예는 문제에 댓글 추가 작업을 사용할 때 수신되는 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 |
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의 |
작업이 완료되었습니다. |
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 |
필수 항목입니다. 케이스를 동기화할 환경의 이름입니다. 기본값은 |
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 전문가에게 문의하여 답변을 받으세요.