IAP(Identity-Aware Proxy) 감사 로깅

중요:

2024년 2월 14일 Cloud Audit Logging(CAL) 유형이 의도치 않게 DATA_ACCESS에서 ADMIN_ACTIVITY로 변경되었습니다. 이 변경으로 인해 UpdateIapSettings 및 ValidateIapAttributeExpression 메서드의 로그 이름과 로그 버킷 위치가 변경됩니다.

CAL 유형이 다시 DATA_ACCESS로 변경되었습니다.

이 문서에서는 감사 로그를 생성하는 메서드, 각 메서드에서 생성하는 감사 로그에 대한 세부정보, 감사 로그를 생성하지 않는 메서드(있는 경우)를 포함하여 IAP(Identity-Aware Proxy)의 감사 로깅을 설명합니다. Google Cloud는 Google Cloud 리소스 내의 관리 및 액세스 활동을 기록하는 감사 로그를 생성합니다. 자세한 내용은 Cloud 감사 로그 개요를 참조하세요. 이 페이지에는 감사 로그 보는 방법, 저장 및 라우팅 방법 등에 대한 정보가 포함되어 있습니다.

참고

필드 섹션은 감사 로그의 일부 필드에 대한 중요한 세부정보를 설명합니다.

서비스 이름

IAP(Identity-Aware Proxy) 감사 로그는 서비스 이름 iap.googleapis.com을 사용합니다. 이 서비스에 대한 필터는 다음과 같습니다.

    protoPayload.serviceName="iap.googleapis.com"
  

권한 유형별 메서드

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

권한 유형	메서드
ADMIN_READ	google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
ADMIN_WRITE	google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
DATA_READ	google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
DATA_WRITE	google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression

API 인터페이스 감사 로그

각 메서드에 대한 평가 방법 및 평가 대상 권한에 대한 자세한 내용은 IAP(Identity-Aware Proxy)의 Identity and Access Management 문서를 참조하세요.

google.cloud.iap.v1.IdentityAwareProxyAdminService

다음 섹션에는 google.cloud.iap.v1.IdentityAwareProxyAdminService에 속하는 메서드와 연결된 감사 로그에 대한 세부정보가 포함되어 있습니다.

CreateTunnelDestGroup

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

DeleteTunnelDestGroup

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

GetIamPolicy

• 메서드: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
  
• 감사 로그 유형: 데이터 액세스
  
• 권한: 권한은 IAM 문서를 참조하세요.
• 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  
• 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy"
  

GetIapSettings

• 메서드: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
  
• 감사 로그 유형: 데이터 액세스
  
• 권한:
  • iap.projects.getSettings - ADMIN_READ
  • iap.web.getSettings - ADMIN_READ
  • iap.webServiceVersions.getSettings - ADMIN_READ
  • iap.webServices.getSettings - ADMIN_READ
  • iap.webTypes.getSettings - ADMIN_READ
• 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  
• 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings"
  

GetTunnelDestGroup

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

ListTunnelDestGroups

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

SetIamPolicy

• 메서드: google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
  
• 감사 로그 유형: 관리자 활동
  
• 권한: 권한은 IAM 문서를 참조하세요.
• 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  
• 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"
  

UpdateIapSettings

• 메서드: google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  
• 감사 로그 유형: 데이터 액세스
  
• 권한: 권한은 IAM 문서를 참조하세요.
• 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  
• 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings"
  

UpdateTunnelDestGroup

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

ValidateIapAttributeExpression

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

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

다음 섹션에는 google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1에 속하는 메서드와 연결된 감사 로그에 대한 세부정보가 포함되어 있습니다.

GetIamPolicy

• 메서드: google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
  
• 감사 로그 유형: 데이터 액세스
  
• 권한:
  • iap.web.getIamPolicy - ADMIN_READ
  • iap.webServiceVersions.getIamPolicy - ADMIN_READ
  • iap.webServices.getIamPolicy - ADMIN_READ
  • iap.webTypes.getIamPolicy - ADMIN_READ
• 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  
• 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy"
  

SetIamPolicy

• 메서드: google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
  
• 감사 로그 유형: 관리자 활동
  
• 권한: 권한은 IAM 문서를 참조하세요.
• 메서드가 장기 실행 또는 스트리밍 작업인지 여부: 아니요.
  
• 이 메서드에 대한 필터:: protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy"
  

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

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

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

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

• google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateBrand
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.DeleteIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetBrand
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListBrands
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListIdentityAwareProxyClients
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ResetIdentityAwareProxyClientSecret
• google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.TestIamPermissions

필드

로그에는 사용자가 충족한 액세스 수준에 대한 정보만 포함됩니다. 승인되지 않은 요청을 차단한 액세스 수준은 로그 항목에 나열되지 않습니다. 주어진 리소스를 성공적으로 요청하기 위해 필요한 조건을 확인하려면 리소스의 액세스 수준을 확인합니다.

다음은 로그의 일부 필드에 대한 중요한 세부정보입니다.

필드	값
authenticationInfo	principalEmail로 리소스에 액세스하려고 시도한 사용자의 이메일입니다. 인증되지 않은 요청의 로그에는 이 정보가 없습니다.
requestMetadata.callerIp	요청이 시작된 IP 주소입니다.
requestMetadata.requestAttributes	요청 메소드 및 URL입니다.
authorizationInfo.resource	액세스 중인 리소스입니다.
authorizationInfo.granted	IAP가 요청된 액세스를 허용했는지 여부를 나타내는 부울입니다.