Mail Admin Quarantine API를 사용하면 Google Workspace 관리자가 Gmail에서 관리자 스팸 격리 저장소에 보관하는 이메일 메시지를 프로그래매틱 방식으로 관리할 수 있습니다. 메일이 Google 관리 콘솔에서 구성한 규정 준수, 데이터 손실 방지(DLP) 또는 보안 규칙과 일치하면 스팸 격리 저장소로 이동합니다.
API를 사용하여 다음과 같은 보안 및 규정 준수 자동화를 빌드합니다.
- 분류를 위해 격리된 메일을 SIEM 또는 SOAR 플랫폼으로 가져옵니다.
- 메일 처리 방법을 결정하기 전에 메일 헤더, 본문 스니펫, 첨부파일을 검토합니다.
- 안전한 메일은 개별적으로 또는 최대 500개 메일 단위로 일괄적으로 해제하고 안전하지 않은 메일은 거부합니다.
핵심 리소스
관리자 검역 API는 고객 아래에 다음 리소스를 노출합니다.
| 리소스 | 리소스 이름 | 설명 |
|---|---|---|
| 고객 | customers/CUSTOMER_ID |
Google Workspace 계정 자세한 내용은 고객 ID 찾기를 참고하세요. |
customers.quarantinedMessages |
customers/CUSTOMER_ID/quarantinedMessages/MESSAGE_OWNER:MESSAGE_ID |
스팸 격리 저장소에 보관된 이메일 메시지입니다. MESSAGE_OWNER은 편지함 소유자의 이메일 주소이고 MESSAGE_ID은 변경할 수 없는 Gmail 메일 ID입니다. |
customers.quarantines |
customers/CUSTOMER_ID/quarantines/QUARANTINE_ID |
관리 콘솔에서 구성한 스팸 격리 저장소입니다. |
customers.operations |
customers/CUSTOMER_ID/operations/OPERATION_ID |
일괄 출시 또는 일괄 거부 요청을 추적하는 장기 실행 작업입니다. |
QuarantinedMessage에는 다음 State 객체 중 하나가 포함됩니다.
| 주 | 설명 |
|---|---|
PENDING_TRIAGE |
메일이 스팸 격리 저장소에 보관되며 관리자의 결정을 기다립니다. |
RELEASED |
관리자가 메일을 해제하여 Gmail에서 전송했습니다. |
DENIED |
관리자가 메일을 거부하여 Gmail에서 삭제했습니다. |
메서드
모든 요청은 https://mailadminquarantine.googleapis.com/v1를 타겟팅합니다.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
customers.quarantinedMessages.list |
GET /customers/*/quarantinedMessages |
지난 30일 동안 스팸으로 분류된 메일을 나열합니다. |
customers.quarantinedMessages.search |
POST /customers/*/quarantinedMessages:search |
필터 또는 Gmail 검색어를 사용하여 스팸으로 분류된 메일을 검색합니다. |
customers.quarantinedMessages.get |
GET /customers/*/quarantinedMessages/* |
메타데이터, 파싱된 콘텐츠 또는 원시 RFC 2822 메시지를 가져옵니다. |
customers.quarantinedMessages.release |
POST /customers/*/quarantinedMessages/*:release |
전송할 단일 메시지를 해제합니다. |
customers.quarantinedMessages.deny |
POST /customers/*/quarantinedMessages/*:deny |
단일 메시지를 거부합니다. |
customers.quarantinedMessages.batchRelease |
POST /customers/*/quarantinedMessages:batchRelease |
최대 500개의 메시지를 비동기식으로 해제합니다. |
customers.quarantinedMessages.batchDeny |
POST /customers/*/quarantinedMessages:batchDeny |
최대 500개의 메시지를 비동기식으로 거부합니다. |
customers.operations.get |
GET /customers/*/operations/* |
일괄 작업의 상태와 결과를 가져옵니다. |
customers.quarantines.list |
GET /customers/*/quarantines |
고객에 대해 구성된 검역을 나열합니다. |
customers.quarantines.get |
GET /customers/*/quarantines/* |
스팸 격리 저장소의 표시 이름과 설명을 가져옵니다. |
대략적인 구현 단계
- API 설정: 개발자 프리뷰 프로그램에 참여하고, Google Cloud 프로젝트에서 API를 사용 설정하고, 고객 ID를 찾고, 필요한 관리자 권한을 부여합니다.
- 도메인 전체 위임으로 승인: 서비스 계정을 만들고, 관리자 스팸 격리 저장소 API 범위로 도메인 전체 위임을 구성하고, 관리자를 가장하는 액세스 토큰을 가져옵니다.
- 메시지 분류:
- 사용 할당량을 준수합니다.
감사 로깅
스팸 격리 저장소 메일을 읽거나 변경하는 모든 API 호출은 관리 콘솔 감사 및 조사 로그에 기록되며, 요청을 실행하는 관리자에게 귀속됩니다.
다음 단계
- Admin Quarantine API 설정하기
- 관리 콘솔 고객센터의 이메일 스팸 격리 저장소 설정 및 관리하기