Google 알리미를 Google SecOps와 통합

이 문서에서는 Google Workspace 알림 센터를 Google Security Operations와 통합하는 방법을 설명합니다.

사용 사례

Google 알리미 센터 통합은 Google SecOps 기능을 사용하여 다음 사용 사례를 지원합니다.

  • 피싱 캠페인 대응: 조직을 대상으로 하는 잠재적인 피싱에 관한 알림 센터 알림을 수집합니다. 자동화된 워크플로를 트리거하여 이메일을 조사하고, 악성 URL을 차단하고, 영향을 받은 계정을 격리합니다.

  • 데이터 무단 반출 방지: 의심스러운 데이터 이동이 감지되면 자동 사고 대응을 트리거합니다. 영향을 받은 시스템을 격리하고 포렌식 분석을 시작합니다.

  • 자동화된 멀웨어 해결: Google Workspace 알림으로 식별된 감염된 기기를 격리하고 필수 멀웨어 검사 또는 패치 배포를 시작합니다.

  • 취약점 관리: Google Workspace 환경에 영향을 미치는 새로 발견된 취약점에 대한 알림을 자동으로 처리하여 패치 우선순위를 지정하고 관련 팀에 알립니다.

시작하기 전에

Google SecOps에서 Google 알림 센터 통합을 구성하기 전에 다음 기본 요건 단계를 완료하세요.

  1. Google Workspace Alert Center API를 사용 설정합니다.

  2. 서비스 계정을 만듭니다.

  3. JSON 키를 구성합니다.

  4. 도메인 전체 권한을 위임합니다.

  5. 명의 도용된 사용자에게 알림 센터 액세스 권한을 부여합니다.

Google Workspace Alert Center API 사용 설정하기

API를 사용 설정하면 Google SecOps가 Google Workspace 보안 데이터와 통신할 수 있습니다.

  1. Google Cloud 콘솔에서 라이브러리 페이지로 이동합니다.

    라이브러리로 이동

  2. 사용 설정을 클릭합니다.

서비스 계정 만들기

서비스 계정은 통합이 Google Workspace 데이터에 액세스할 수 있는 안전한 ID 역할을 합니다.

  1. Google Cloud 콘솔에서 IAM 및 관리자 > 서비스 계정으로 이동합니다.

    서비스 계정으로 이동

  2. add서비스 계정 만들기를 클릭합니다.

  3. 이름 (예: 'SecOps 알림 센터 통합')과 설명을 입력합니다.

  4. 만들고 계속하기를 클릭합니다.

  5. 선택사항인 IAM 역할 할당 단계를 건너뛰고 완료를 클릭합니다. 알림 센터 권한은 Google Cloud IAM의 서비스 계정이 아닌 도메인의 Google 관리 콘솔에서 가장된 Google Workspace 사용자에게 부여됩니다.

  6. 목록에서 서비스 계정을 찾아 클라이언트 ID (고유 ID) 및 이메일 주소를 복사합니다.

JSON 키 구성

이 통합은 인증에 정적 JSON 키 파일을 사용합니다.

  1. Google Cloud 콘솔에서 서비스 계정을 선택하고 키 탭으로 이동합니다.

  2. 키 추가 > 새 키 만들기를 클릭합니다.

  3. JSON을 선택하고 만들기를 클릭합니다. 키 파일이 컴퓨터에 자동으로 다운로드됩니다.

  4. 이 파일의 전체 콘텐츠를 복사하여 통합 구성 중에 Service Account JSON Secret에 붙여넣습니다.

도메인 전체 권한 위임

도메인 전체 권한을 부여하면 서비스 계정이 관리자를 가장하여 사용자의 알림에 액세스할 수 있습니다.

  1. 도메인의 Google 관리 콘솔에서 기본 메뉴 > 보안 > 액세스 및 데이터 컨트롤 > API 컨트롤로 이동합니다.

  2. 도메인 전체 위임 창에서 도메인 전체 위임 관리를 선택합니다.

  3. 새로 추가를 클릭합니다.

  4. 클라이언트 ID 필드에 서비스 계정에서 복사한 고유 ID (클라이언트 ID)를 입력합니다.

  5. OAuth 범위 필드에 다음 범위를 입력합니다.

    https://www.googleapis.com/auth/apps.alerts

  6. 승인을 클릭합니다.

명의 도용된 사용자에게 알림 센터 액세스 권한 부여

Impersonation Email Address 매개변수에 지정하는 Google Workspace 사용자는 도메인의 Google 관리 콘솔에서 알림 센터 관리자 권한이 있어야 합니다.

Google 관리 콘솔에서 알림 센터 액세스 권한을 부여하려면 가장된 사용자에게 다음 역할 중 하나를 할당합니다.

  • 기본 제공 관리자 역할: 기본적으로 알림 센터에 대한 전체 액세스 권한이 포함된 최고 관리자 또는 서비스 관리자 역할을 할당합니다.

  • 맞춤 관리자 역할: 계정 > 관리자 역할에서 알림 센터 > 전체 액세스 권한 (알림 삭제 작업을 실행하는 데 필요) 또는 알림 센터 > 보기 액세스 권한 (읽기 전용 알림 수집에 충분)을 사용하여 맞춤 관리자 역할을 만들고 가장된 사용자에게 해당 역할을 할당합니다.

알림 센터 관리자 권한 및 맞춤 역할 구성에 대한 자세한 내용은 알림 센터에 대한 액세스 권한 부여하기를 참고하세요.

통합 매개변수

Google 알리미 센터 통합에는 다음 매개변수가 필요합니다.

매개변수 설명
Service Account JSON Secret

필수 입력란입니다.

다운로드한 서비스 계정 키 JSON 파일의 전체 콘텐츠입니다.
Impersonation Email Address

필수 입력란입니다.

Google Workspace 도메인에서 알림 센터 관리자 권한 (예: 최고 관리자 또는 서비스 관리자 역할 또는 알림 센터 권한이 있는 커스텀 관리자 역할)이 있는 Google Workspace 사용자의 이메일 주소입니다.

통합은 도메인 전체 위임을 사용하여 이 사용자를 가장하고 알림을 검색하거나 관리합니다.
Verify SSL

(선택사항)

선택하면 통합에서 Google 알림 센터 서버에 연결할 때 SSL 인증서를 검증합니다.

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

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

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

작업

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

알림 삭제

알림 삭제 작업을 사용하여 알림 센터에서 알림을 삭제합니다.

알림을 삭제한 후 30일 동안 복구할 수 있습니다. 삭제한 지 30일이 지난 알림은 복구할 수 없습니다.

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

작업 입력

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

매개변수 설명
Alert ID 필수

삭제할 알림의 ID입니다.

작업 출력

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

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

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

출력 메시지 메시지 설명

Successfully deleted alert with ID RECORD_ID in the alert center.

Alert with ID RECORD_ID doesn't exist in the alert center.

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

작업이 실패했습니다.

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

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

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

핑

Ping 작업을 사용하여 알림 센터와의 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

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

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

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

출력 메시지 메시지 설명
Successfully connected to the alert center server with the provided connection parameters! 작업이 완료되었습니다.
Failed to connect to the alert center server! Error is ERROR_REASON

작업이 실패했습니다.

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

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

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

커넥터

Google SecOps에서 커넥터를 구성하는 방법에 대한 자세한 내용은 데이터 수집 (커넥터)을 참조하세요.

Google 알리미 센터 – 알림 커넥터

Google 알리미 센터 - 알림 커넥터를 사용하여 알림 센터에서 알림에 대한 정보를 검색합니다.

동적 목록 필터는 type 매개변수와 함께 작동합니다.

커넥터 입력

Google 알리미 센터 – 알리미 커넥터에는 다음 매개변수가 필요합니다.

매개변수 설명
Product Field Name 필수

제품 이름이 저장된 필드의 이름입니다.

기본값은 source입니다.
Event Field Name 필수

이벤트 이름(하위 유형)을 결정하는 데 사용되는 필드 이름입니다.

기본값은 type입니다.
Environment Field Name 선택사항

환경 이름이 저장된 필드의 이름입니다.

환경 필드를 찾을 수 없으면 환경이 기본 환경으로 설정됩니다.

기본값은 ""입니다.
Environment Regex Pattern 선택사항

Environment Field Name 필드에 있는 값에서 실행할 정규 표현식 패턴입니다. 이 매개변수를 사용하면 정규 표현식 로직을 사용하여 환경 필드를 조작할 수 있습니다.

기본값 .*를 사용하여 필요한 원시 Environment Field Name 값을 가져옵니다.

정규 표현식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 기본 환경입니다.
PythonProcessTimeout 필수

현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도(초)입니다.

기본값은 180입니다.
Service Account JSON Secret 필수

알림 센터 인증에 사용한 서비스 계정 파일의 전체 JSON 콘텐츠입니다.
Impersonation Email Address 필수

알림 센터 관리자 권한 (예: 최고 관리자 또는 서비스 관리자 역할 또는 알림 센터 권한이 있는 맞춤 관리자 역할)이 있는 Google Workspace 사용자의 이메일 주소입니다.
Verify SSL 선택사항

선택하면 통합에서 알림 센터에 연결하는 데 사용되는 SSL 인증서가 유효한지 확인합니다.

이 설정은 기본적으로 선택됩니다.
Max Hours Backwards 선택사항

첫 번째 커넥터 반복에서 응답을 가져오기 전의 시간입니다. 이 매개변수는 커넥터를 처음 사용 설정한 후의 초기 커넥터 반복 또는 만료된 커넥터 타임스탬프의 대체 값에 적용됩니다.

기본값은 1시간입니다.
Max Alerts To Fetch 선택사항

커넥터 반복마다 검색할 최대 알림 수입니다.

최대 개수는 100개입니다.
Lowest Severity To Fetch 선택사항

검색할 알림의 가장 낮은 심각도입니다.
Use whitelist as a blacklist 선택사항

선택하면 커넥터가 동적 목록을 차단 목록으로 사용합니다.

기본적으로 선택되지 않습니다.
Proxy Server Address 선택사항

사용할 프록시 서버의 주소입니다.
Proxy Username 선택사항

인증할 프록시 사용자 이름입니다.
Proxy Password 선택사항

인증할 프록시 비밀번호입니다.

커넥터 규칙

다음 규칙은 커넥터의 운영 로직, 데이터 처리 동작, 안전 메커니즘을 정의합니다.

  • 프록시: 커넥터는 프록시를 지원합니다.

  • 이벤트 생성: 알림에 data/messages 키 (JSON 객체 목록)가 포함된 경우 커넥터는 목록의 각 객체에 대해 별도의 이벤트를 만듭니다.

  • 안전 제한 시간: 커넥터가 실행 제한 시간(PythonProcessTimeout 기준)의 90% 에 도달하면 중지되고 부분 데이터 수집을 방지하기 위해 해당 반복에 대한 새 알림을 만들지 않습니다.

  • 워터마크 관리: 커넥터는 alertId를 사용하여 처리된 알림을 추적합니다. ids.json에 최대 1,000개의 ID를 저장합니다. 한도를 초과하면 가장 오래된 ID 100개가 삭제됩니다.

샘플 이벤트 JSON

다음 JSON 샘플은 Google Alert Center API의 일반적인 응답 구조를 나타내며, 수집에 사용할 수 있는 특정 데이터 필드를 보여줍니다.

{
    "customerId": "038judqw",
    "alertId": "e37415f1-7c39-44a5-b43c-4f8159638a2a",
    "createTime": "2020-07-22T11:50:08.353Z",
    "startTime": "2020-07-22T10:54:54.059475Z",
    "endTime": "2020-07-22T11:46:51.020063Z",
    "type": "User reported phishing",
    "source": "Gmail phishing",
    "data": {
        "@type": "[type.googleapis.com/google.apps.alertcenter.type.MailPhishing](https://type.googleapis.com/google.apps.alertcenter.type.MailPhishing)",
        "domainId": {
            "customerPrimaryDomain": "smplylab.com"
        },
        "maliciousEntity": {
            "fromHeader": "crazywiz7@abv.bg"
        },
        "messages": [
            {
                "messageId": "1753474999.350456.1595412914645@nm22.abv.bg",
                "messageBodySnippet": " eicar com http malware wicar org data ms14_064_ole_not_xp html",
                "md5HashSubject": "c93d4454877e844fdfcb4401472204f2",
                "subjectText": "Re: App Store - Support.      17/07/2020 12:50:36",
                "attachmentsSha256Hash": [
                    "77c2aed70c3b20c50dbf071f8688580e02463c213e7a65ccab1acc2f8a9769a3",
                    "f5e1b1bf12b71c54f68a719e0c45df5806a8b8d57bf3967d9bd4a071cfc5abbe"
                ],
                "recipient": "lab3@smplylab.com",
                "date": "2020-07-22T10:54:54.059475Z"
            }
        ]
    },
    "securityInvestigationToolLink": "[admin.google.com/ac/ac/investigate?alert=CiRlMzc0MTVmMS03YzM5LTQ0YTUtYjQzYy00ZjgxNTk2MzhhMmE](https://admin.google.com/ac/ac/investigate?alert=CiRlMzc0MTVmMS03YzM5LTQ0YTUtYjQzYy00ZjgxNTk2MzhhMmE)",
    "metadata": {
        "customerId": "038judqw",
        "alertId": "e37415f1-7c39-44a5-b43c-4f8159638a2a",
        "status": "NOT_STARTED",
        "updateTime": "2020-07-22T11:50:08.353Z",
        "severity": "HIGH",
        "etag": "rrXycg7VpUA="
    },
    "updateTime": "2020-07-22T11:50:08.353Z",
    "etag": "rrXycg7VpUA="
}

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