필수 연락처 감사 로깅

필수 연락처의 Cloud 감사 로그를 사용하면 리소스에 대한 관리 및 데이터 액세스 작업을 추적하여 액세스 및 구성 변경사항을 모니터링할 수 있습니다. 로그 탐색기에서 이러한 로그를 쿼리하고 Cloud 감사 로그를 생성하는 Essential Contacts API 메서드를 확인할 수 있습니다.

Cloud 감사 로그에 대한 자세한 내용은 다음 문서를 참조하세요.

서비스 이름

필수 연락처 감사 로그를 보려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

  2. 다음 쿼리를 복사하여 로그 탐색기의 쿼리 필드에 붙여넣은 후 쿼리 실행을 클릭합니다.

        protoPayload.serviceName="essentialcontacts.googleapis.com"

권한 유형별 메서드

각 IAM 권한에는 type 속성이 포함되며 그 값은 네 가지 값(ADMIN_READ, ADMIN_WRITE, DATA_READ, DATA_WRITE) 중 하나일 수 있는 열거형입니다. 메서드를 호출하면 필수 연락처에서 메서드를 수행하는 데 필요한 권한의 type 속성에 따라 카테고리가 달라지는 감사 로그를 생성합니다. DATA_READ, DATA_WRITE, ADMIN_READ의 type 속성 값을 가진 IAM 권한이 필요한 메서드는 데이터 액세스 감사 로그를 생성합니다. type 속성 값이 ADMIN_WRITE인 IAM 권한이 필요한 메서드는 관리자 활동 감사 로그를 생성합니다.

다음 목록에서 (LRO)로 표시된 API 메서드는 장기 실행 작업(LRO)입니다. 이러한 메서드는 일반적으로 감사 로그 항목을 작업이 시작될 때 하나, 작업이 종료될 때 하나 등 2개를 생성됩니다. 자세한 내용은 장기 실행 작업 감사 로그에서 확인하세요.
권한 유형 메서드
DATA_READ google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
DATA_WRITE google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact

API 인터페이스 감사 로그

메서드별 평가 방법과 평가 대상 권한에 대한 자세한 내용은 필수 연락처의 Identity and Access Management 문서를 참조하세요.

google.cloud.essentialcontacts.v1.EssentialContactsService

다음 감사 로그는 google.cloud.essentialcontacts.v1.EssentialContactsService에 속하는 메서드와 연결되어 있습니다.

ComputeContacts

  • 메서드: google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts"

CreateContact

  • 메서드: google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.create - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact"

DeleteContact

  • 메서드: google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.delete - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact"

GetContact

  • 메서드: google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.get - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact"

ListContacts

  • 메서드: google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.list - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts"

SendTestMessage

  • 메서드: google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.send - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage"

UpdateContact

  • 메서드: google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.update - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1alpha1.EssentialContactsService

다음 감사 로그는 google.cloud.essentialcontacts.v1alpha1.EssentialContactsService에 속하는 메서드와 연결되어 있습니다.

ComputeContacts

  • 메서드: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.list - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts"

CreateContact

  • 메서드: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.create - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact"

DeleteContact

  • 메서드: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.delete - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact"

GetContact

  • 메서드: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.get - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact"

ListContacts

  • 메서드: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.list - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts"

SendTestMessage

  • 메서드: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.send - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage"

UpdateContact

  • 메서드: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.update - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1beta1.EssentialContactsService

다음 감사 로그는 google.cloud.essentialcontacts.v1beta1.EssentialContactsService에 속하는 메서드와 연결되어 있습니다.

ComputeContacts

  • 메서드: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts"

CreateContact

  • 메서드: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.create - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact"

DeleteContact

  • 메서드: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.delete - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact"

GetContact

  • 메서드: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.get - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact"

ListContacts

  • 메서드: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.list - DATA_READ
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts"

SendTestMessage

  • 메서드: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.send - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage"

UpdateContact

  • 메서드: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact
  • 감사 로그 유형: 데이터 액세스
  • 권한:
    • essentialcontacts.contacts.update - DATA_WRITE
  • 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  • 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact"

감사 로그를 생성하지 않는 메서드

메서드는 다음 중 하나 이상의 이유로 인해 감사 로그를 생성하지 않을 수 있습니다.

  • 상당한 로그 생성 및 스토리지 비용이 발생하는 대용량 메서드입니다.
  • 감사 값이 낮습니다.
  • 또 다른 감사 또는 플랫폼 로그에서 이미 메서드 범위를 제공하는 경우

다음 메서드는 감사 로그를 생성하지 않습니다.

  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ResendVerification
  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.VerifyContact

쓰기 작업에 대한 관리자 활동 감사 로그

데이터 액세스 감사 로그(DATA_WRITE) 외에도 다음 google.cloud.essentialcontacts.v1.EssentialContactsService 쓰기 메서드는 관리자 활동 감사 로그(ADMIN_WRITE)를 생성합니다.

  • google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage

관리자 활동 감사 로그는 기본적으로 사용 설정되며 Cloud Logging 수집 요금이 발생하지 않습니다.

필수 연락처에 대해 데이터 액세스 감사 로그(DATA_WRITE)도 사용 설정하는 경우 이 네 가지 메서드를 호출하면 관리자 활동 감사 로그 항목(cloudaudit.googleapis.com/activity)과 데이터 액세스 감사 로그 항목(cloudaudit.googleapis.com/data_access)이 모두 생성됩니다. 감사 로그를 내보내기 싱크로 라우팅하거나 로그 기반 알림을 구성하는 경우 로그 이름으로 필터링하거나 두 로그 항목을 모두 고려하여 중복 알림이나 예기치 않은 내보내기 볼륨을 방지합니다.

샘플 쿼리

로그 탐색기에서 다음 샘플 쿼리를 실행하여 필수 연락처 쓰기 작업에 대한 관리자 활동 감사 로그를 볼 수 있습니다.

쿼리 설명 표현식
필수 연락처 쓰기 작업의 관리자 활동 감사 로그 
log_id("cloudaudit.googleapis.com/activity")
protoPayload.serviceName="essentialcontacts.googleapis.com"