com.google.cloud.asset.v1

Interface IamPolicyAnalysisQuery.OptionsOrBuilder

All Superinterfaces:

MessageLiteOrBuilder, MessageOrBuilder

All Known Implementing Classes:

IamPolicyAnalysisQuery.Options, IamPolicyAnalysisQuery.Options.Builder

Enclosing class:

IamPolicyAnalysisQuery

public static interface IamPolicyAnalysisQuery.OptionsOrBuilder
extends MessageOrBuilder

Method Summary

Modifier and Type	Method and Description
boolean	getAnalyzeServiceAccountImpersonation() Optional.
boolean	getExpandGroups() Optional.
boolean	getExpandResources() Optional.
boolean	getExpandRoles() Optional.
boolean	getOutputGroupEdges() Optional.
boolean	getOutputResourceEdges() Optional.

Methods inherited from interface com.google.protobuf.MessageOrBuilder

findInitializationErrors, getAllFields, getDefaultInstanceForType, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

isInitialized

Method Detail

getExpandGroups

boolean getExpandGroups()

 Optional. If true, the identities section of the result will expand any
 Google groups appearing in an IAM policy binding.
 If
 [IamPolicyAnalysisQuery.identity_selector][google.cloud.asset.v1.IamPolicyAnalysisQuery.identity_selector]
 is specified, the identity in the result will be determined by the
 selector, and this flag is not allowed to set.
 If true, the default max expansion per group is 1000 for
 AssetService.AnalyzeIamPolicy][].
 Default is false.
 

bool expand_groups = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The expandGroups.

getExpandRoles

boolean getExpandRoles()

 Optional. If true, the access section of result will expand any roles
 appearing in IAM policy bindings to include their permissions.
 If
 [IamPolicyAnalysisQuery.access_selector][google.cloud.asset.v1.IamPolicyAnalysisQuery.access_selector]
 is specified, the access section of the result will be determined by the
 selector, and this flag is not allowed to set.
 Default is false.
 

bool expand_roles = 2 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The expandRoles.

getExpandResources

boolean getExpandResources()

 Optional. If true and
 [IamPolicyAnalysisQuery.resource_selector][google.cloud.asset.v1.IamPolicyAnalysisQuery.resource_selector]
 is not specified, the resource section of the result will expand any
 resource attached to an IAM policy to include resources lower in the
 resource hierarchy.
 For example, if the request analyzes for which resources user A has
 permission P, and the results include an IAM policy with P on a GCP
 folder, the results will also include resources in that folder with
 permission P.
 If true and
 [IamPolicyAnalysisQuery.resource_selector][google.cloud.asset.v1.IamPolicyAnalysisQuery.resource_selector]
 is specified, the resource section of the result will expand the
 specified resource to include resources lower in the resource hierarchy.
 Only project or lower resources are supported. Folder and organization
 resource cannot be used together with this option.
 For example, if the request analyzes for which users have permission P on
 a GCP project with this option enabled, the results will include all
 users who have permission P on that project or any lower resource.
 If true, the default max expansion per resource is 1000 for
 AssetService.AnalyzeIamPolicy][] and 100000 for
 AssetService.AnalyzeIamPolicyLongrunning][].
 Default is false.
 

bool expand_resources = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The expandResources.

getOutputResourceEdges

boolean getOutputResourceEdges()

 Optional. If true, the result will output the relevant parent/child
 relationships between resources. Default is false.
 

bool output_resource_edges = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The outputResourceEdges.

getOutputGroupEdges

boolean getOutputGroupEdges()

 Optional. If true, the result will output the relevant membership
 relationships between groups and other groups, and between groups and
 principals. Default is false.
 

bool output_group_edges = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The outputGroupEdges.

getAnalyzeServiceAccountImpersonation

boolean getAnalyzeServiceAccountImpersonation()

 Optional. If true, the response will include access analysis from
 identities to resources via service account impersonation. This is a very
 expensive operation, because many derived queries will be executed. We
 highly recommend you use
 [AssetService.AnalyzeIamPolicyLongrunning][google.cloud.asset.v1.AssetService.AnalyzeIamPolicyLongrunning]
 rpc instead.
 For example, if the request analyzes for which resources user A has
 permission P, and there's an IAM policy states user A has
 iam.serviceAccounts.getAccessToken permission to a service account SA,
 and there's another IAM policy states service account SA has permission P
 to a GCP folder F, then user A potentially has access to the GCP folder
 F. And those advanced analysis results will be included in
 [AnalyzeIamPolicyResponse.service_account_impersonation_analysis][google.cloud.asset.v1.AnalyzeIamPolicyResponse.service_account_impersonation_analysis].
 Another example, if the request analyzes for who has
 permission P to a GCP folder F, and there's an IAM policy states user A
 has iam.serviceAccounts.actAs permission to a service account SA, and
 there's another IAM policy states service account SA has permission P to
 the GCP folder F, then user A potentially has access to the GCP folder
 F. And those advanced analysis results will be included in
 [AnalyzeIamPolicyResponse.service_account_impersonation_analysis][google.cloud.asset.v1.AnalyzeIamPolicyResponse.service_account_impersonation_analysis].
 Only the following permissions are considered in this analysis:
 * `iam.serviceAccounts.actAs`
 * `iam.serviceAccounts.signBlob`
 * `iam.serviceAccounts.signJwt`
 * `iam.serviceAccounts.getAccessToken`
 * `iam.serviceAccounts.getOpenIdToken`
 * `iam.serviceAccounts.implicitDelegation`
 Default is false.
 

bool analyze_service_account_impersonation = 6 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The analyzeServiceAccountImpersonation.