com.google.cloud.audit.audit_log

Members list

Concise view

Type members

Classlikes

final case class AuditLog(serviceName: String, methodName: String, resourceName: String, resourceLocation: Option[ResourceLocation], resourceOriginalState: Option[Struct], numResponseItems: Long, status: Option[Status], authenticationInfo: Option[AuthenticationInfo], authorizationInfo: Seq[AuthorizationInfo], policyViolationInfo: Option[PolicyViolationInfo], requestMetadata: Option[RequestMetadata], request: Option[Struct], response: Option[Struct], metadata: Option[Struct], serviceData: Option[Any], unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[AuditLog]

Common audit log format for Google Cloud Platform API operations.

Common audit log format for Google Cloud Platform API operations.

Attributes

authenticationInfo

Authentication information.

authorizationInfo

Authorization information. If there are multiple resources or permissions involved, then there is one AuthorizationInfo element for each {resource, permission} tuple.

metadata

Other service-specific data about the request, response, and other information associated with the current audited event.

methodName

The name of the service method or operation. For API calls, this should be the name of the API method. For example, "google.cloud.bigquery.v2.TableService.InsertTable" "google.logging.v2.ConfigServiceV2.CreateSink"

numResponseItems

The number of items returned from a List or Query API method, if applicable.

policyViolationInfo

Indicates the policy violations for this request. If the request is denied by the policy, violation information will be logged here.

request

The operation request. This may not include all request parameters, such as those that are too large, privacy-sensitive, or duplicated elsewhere in the log record. It should never include user-generated data, such as file contents. When the JSON object represented here has a proto equivalent, the proto name will be indicated in the @type property.

requestMetadata

Metadata about the operation.

resourceLocation

The resource location information.

resourceName

The resource or collection that is the target of the operation. The name is a scheme-less URI, not including the API service name. For example: "projects/PROJECT_ID/zones/us-central1-a/instances" "projects/PROJECT_ID/datasets/DATASET_ID"

resourceOriginalState

The resource's original state before mutation. Present only for operations which have successfully modified the targeted resource(s). In general, this field should contain all changed fields, except those that are already been included in request, response, metadata or service_data fields. When the JSON object represented here has a proto equivalent, the proto name will be indicated in the @type property.

response

The operation response. This may not include all response elements, such as those that are too large, privacy-sensitive, or duplicated elsewhere in the log record. It should never include user-generated data, such as file contents. When the JSON object represented here has a proto equivalent, the proto name will be indicated in the @type property.

serviceData

Deprecated. Use the metadata field instead. Other service-specific data about the request, response, and other activities.

serviceName

The name of the API service performing the operation. For example, "compute.googleapis.com".

status

The status of the overall operation.

Companion:
object
Source:
AuditLog.scala
Graph
Supertypes
trait Updatable[AuditLog]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object AuditLog extends GeneratedMessageCompanion[AuditLog]

Attributes

Companion:
class
Source:
AuditLog.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[AuditLog]
trait Serializable
class Object
trait Matchable
class Any
Self type
object AuditLogProto extends GeneratedFileObject

Attributes

Source:
AuditLogProto.scala
Graph
Supertypes
class GeneratedFileObject
class Object
trait Matchable
class Any
Self type
final case class AuthenticationInfo(principalEmail: String, authoritySelector: String, thirdPartyPrincipal: Option[Struct], serviceAccountKeyName: String, serviceAccountDelegationInfo: Seq[ServiceAccountDelegationInfo], principalSubject: String, unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[AuthenticationInfo]

Authentication information for the operation.

Authentication information for the operation.

Attributes

authoritySelector

The authority selector specified by the requestor, if any. It is not guaranteed that the principal was allowed to use this authority.

principalEmail

The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the principal_subject field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see Caller identities in audit logs.

principalSubject

String representation of identity of requesting party. Populated for both first and third party identities.

serviceAccountDelegationInfo

Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.

serviceAccountKeyName

The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"

thirdPartyPrincipal

The third party identification (if any) of the authenticated user making the request. When the JSON object represented here has a proto equivalent, the proto name will be indicated in the @type property.

Companion:
object
Source:
AuthenticationInfo.scala
Graph
Supertypes
trait Updatable[AuthenticationInfo]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object AuthenticationInfo extends GeneratedMessageCompanion[AuthenticationInfo]

Attributes

Companion:
class
Source:
AuthenticationInfo.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[AuthenticationInfo]
trait Serializable
class Object
trait Matchable
class Any
Self type
final case class AuthorizationInfo(resource: String, permission: String, granted: Boolean, resourceAttributes: Option[Resource], unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[AuthorizationInfo]

Authorization information for the operation.

Authorization information for the operation.

Attributes

granted

Whether or not authorization for resource and permission was granted.

permission

The required IAM permission.

resource

The resource being accessed, as a REST-style or cloud resource string. For example: bigquery.googleapis.com/projects/PROJECTID/datasets/DATASETID or projects/PROJECTID/datasets/DATASETID

resourceAttributes

Resource attributes used in IAM condition evaluation. This field contains resource attributes like resource type and resource name. To get the whole view of the attributes used in IAM condition evaluation, the user must also look into AuditLog.request_metadata.request_attributes.

Companion:
object
Source:
AuthorizationInfo.scala
Graph
Supertypes
trait Updatable[AuthorizationInfo]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object AuthorizationInfo extends GeneratedMessageCompanion[AuthorizationInfo]

Attributes

Companion:
class
Source:
AuthorizationInfo.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[AuthorizationInfo]
trait Serializable
class Object
trait Matchable
class Any
Self type
final case class OrgPolicyViolationInfo(payload: Option[Struct], resourceType: String, resourceTags: Map[String, String], violationInfo: Seq[ViolationInfo], unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[OrgPolicyViolationInfo]

Represents OrgPolicy Violation information.

Represents OrgPolicy Violation information.

Attributes

payload

Optional. Resource payload that is currently in scope and is subjected to orgpolicy conditions. This payload may be the subset of the actual Resource that may come in the request. This payload should not contain any core content.

resourceTags

Optional. Tags referenced on the resource at the time of evaluation. These also include the federated tags, if they are supplied in the CheckOrgPolicy or CheckCustomConstraints Requests. Optional field as of now. These tags are the Cloud tags that are available on the resource during the policy evaluation and will be available as part of the OrgPolicy check response for logging purposes.

resourceType

Optional. Resource type that the orgpolicy is checked against. Example: compute.googleapis.com/Instance, store.googleapis.com/bucket

violationInfo

Optional. Policy violations

Companion:
object
Source:
OrgPolicyViolationInfo.scala
Graph
Supertypes
trait Updatable[OrgPolicyViolationInfo]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object OrgPolicyViolationInfo extends GeneratedMessageCompanion[OrgPolicyViolationInfo]

Attributes

Companion:
class
Source:
OrgPolicyViolationInfo.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[OrgPolicyViolationInfo]
trait Serializable
class Object
trait Matchable
class Any
Self type
final case class PolicyViolationInfo(orgPolicyViolationInfo: Option[OrgPolicyViolationInfo], unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[PolicyViolationInfo]

Information related to policy violations for this request.

Information related to policy violations for this request.

Attributes

orgPolicyViolationInfo

Indicates the orgpolicy violations for this resource.

Companion:
object
Source:
PolicyViolationInfo.scala
Graph
Supertypes
trait Updatable[PolicyViolationInfo]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object PolicyViolationInfo extends GeneratedMessageCompanion[PolicyViolationInfo]

Attributes

Companion:
class
Source:
PolicyViolationInfo.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[PolicyViolationInfo]
trait Serializable
class Object
trait Matchable
class Any
Self type
final case class RequestMetadata(callerIp: String, callerSuppliedUserAgent: String, callerNetwork: String, requestAttributes: Option[Request], destinationAttributes: Option[Peer], unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[RequestMetadata]

Metadata about the request.

Metadata about the request.

Attributes

callerIp

The IP address of the caller. For a caller from the internet, this will be the public IPv4 or IPv6 address. For calls made from inside Google's internal production network from one GCP service to another, caller_ip will be redacted to "private". For a caller from a Compute Engine VM with a external IP address, caller_ip will be the VM's external IP address. For a caller from a Compute Engine VM without a external IP address, if the VM is in the same organization (or project) as the accessed resource, caller_ip will be the VM's internal IPv4 address, otherwise caller_ip will be redacted to "gce-internal-ip". See https://cloud.google.com/compute/docs/vpc/ for more information.

callerNetwork

The network of the caller. Set only if the network host project is part of the same GCP organization (or project) as the accessed resource. See https://cloud.google.com/compute/docs/vpc/ for more information. This is a scheme-less URI full resource name. For example: "//compute.googleapis.com/projects/PROJECT_ID/global/networks/NETWORK_ID"

callerSuppliedUserAgent

The user agent of the caller. This information is not authenticated and should be treated accordingly. For example:

  • google-api-python-client/1.4.0: The request was made by the Google API client for Python.
  • Cloud SDK Command Line Tool apitools-client/1.0 gcloud/0.9.62: The request was made by the Google Cloud SDK CLI (gcloud).
  • AppEngine-Google; (+http://code.google.com/appengine; appid: s~my-project: The request was made from the my-project App Engine app.
destinationAttributes

The destination of a network activity, such as accepting a TCP connection. In a multi hop network activity, the destination represents the receiver of the last hop. Only two fields are used in this message, Peer.port and Peer.ip. These fields are optionally populated by those services utilizing the IAM condition feature.

requestAttributes

Request attributes used in IAM condition evaluation. This field contains request attributes like request time and access levels associated with the request. To get the whole view of the attributes used in IAM condition evaluation, the user must also look into AuditLog.authentication_info.resource_attributes.

Companion:
object
Source:
RequestMetadata.scala
Graph
Supertypes
trait Updatable[RequestMetadata]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object RequestMetadata extends GeneratedMessageCompanion[RequestMetadata]

Attributes

Companion:
class
Source:
RequestMetadata.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[RequestMetadata]
trait Serializable
class Object
trait Matchable
class Any
Self type
final case class ResourceLocation(currentLocations: Seq[String], originalLocations: Seq[String], unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[ResourceLocation]

Location information about a resource.

Location information about a resource.

Attributes

currentLocations

The locations of a resource after the execution of the operation. Requests to create or delete a location based resource must populate the 'current_locations' field and not the 'original_locations' field. For example: "europe-west1-a" "us-east1" "nam3"

originalLocations

The locations of a resource prior to the execution of the operation. Requests that mutate the resource's location must populate both the 'original_locations' as well as the 'current_locations' fields. For example: "europe-west1-a" "us-east1" "nam3"

Companion:
object
Source:
ResourceLocation.scala
Graph
Supertypes
trait Updatable[ResourceLocation]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object ResourceLocation extends GeneratedMessageCompanion[ResourceLocation]

Attributes

Companion:
class
Source:
ResourceLocation.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[ResourceLocation]
trait Serializable
class Object
trait Matchable
class Any
Self type
final case class ServiceAccountDelegationInfo(principalSubject: String, authority: Authority, unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[ServiceAccountDelegationInfo]

Identity delegation history of an authenticated service account.

Identity delegation history of an authenticated service account.

Attributes

principalSubject

A string representing the principal_subject associated with the identity. For most identities, the format will be principal://iam.googleapis.com/{identity pool name}/subject/{subject) except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format serviceAccount:{identity pool name}[{subject}]

Companion:
object
Source:
ServiceAccountDelegationInfo.scala
Graph
Supertypes
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object ServiceAccountDelegationInfo extends GeneratedMessageCompanion[ServiceAccountDelegationInfo]

Attributes

Companion:
class
Source:
ServiceAccountDelegationInfo.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[ServiceAccountDelegationInfo]
trait Serializable
class Object
trait Matchable
class Any
Self type
final case class ViolationInfo(constraint: String, errorMessage: String, checkedValue: String, policyType: PolicyType, unknownFields: UnknownFieldSet) extends GeneratedMessage with Updatable[ViolationInfo]

Provides information about the Policy violation info for this request.

Provides information about the Policy violation info for this request.

Attributes

checkedValue

Optional. Value that is being checked for the policy. This could be in encrypted form (if pii sensitive). This field will only be emitted in LIST_POLICY types

constraint

Optional. Constraint name

errorMessage

Optional. Error message that policy is indicating.

policyType

Optional. Indicates the type of the policy.

Companion:
object
Source:
ViolationInfo.scala
Graph
Supertypes
trait Updatable[ViolationInfo]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
object ViolationInfo extends GeneratedMessageCompanion[ViolationInfo]

Attributes

Companion:
class
Source:
ViolationInfo.scala
Graph
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[ViolationInfo]
trait Serializable
class Object
trait Matchable
class Any
Self type