Variables
AccessState_name, AccessState_value
var (
AccessState_name = map[int32]string{
0: "ACCESS_STATE_UNSPECIFIED",
1: "GRANTED",
2: "NOT_GRANTED",
3: "UNKNOWN_CONDITIONAL",
4: "UNKNOWN_INFO_DENIED",
}
AccessState_value = map[string]int32{
"ACCESS_STATE_UNSPECIFIED": 0,
"GRANTED": 1,
"NOT_GRANTED": 2,
"UNKNOWN_CONDITIONAL": 3,
"UNKNOWN_INFO_DENIED": 4,
}
)Enum value maps for AccessState.
HeuristicRelevance_name, HeuristicRelevance_value
var (
HeuristicRelevance_name = map[int32]string{
0: "HEURISTIC_RELEVANCE_UNSPECIFIED",
1: "NORMAL",
2: "HIGH",
}
HeuristicRelevance_value = map[string]int32{
"HEURISTIC_RELEVANCE_UNSPECIFIED": 0,
"NORMAL": 1,
"HIGH": 2,
}
)Enum value maps for HeuristicRelevance.
BindingExplanation_RolePermission_name, BindingExplanation_RolePermission_value
var (
BindingExplanation_RolePermission_name = map[int32]string{
0: "ROLE_PERMISSION_UNSPECIFIED",
1: "ROLE_PERMISSION_INCLUDED",
2: "ROLE_PERMISSION_NOT_INCLUDED",
3: "ROLE_PERMISSION_UNKNOWN_INFO_DENIED",
}
BindingExplanation_RolePermission_value = map[string]int32{
"ROLE_PERMISSION_UNSPECIFIED": 0,
"ROLE_PERMISSION_INCLUDED": 1,
"ROLE_PERMISSION_NOT_INCLUDED": 2,
"ROLE_PERMISSION_UNKNOWN_INFO_DENIED": 3,
}
)Enum value maps for BindingExplanation_RolePermission.
BindingExplanation_Membership_name, BindingExplanation_Membership_value
var (
BindingExplanation_Membership_name = map[int32]string{
0: "MEMBERSHIP_UNSPECIFIED",
1: "MEMBERSHIP_INCLUDED",
2: "MEMBERSHIP_NOT_INCLUDED",
3: "MEMBERSHIP_UNKNOWN_INFO_DENIED",
4: "MEMBERSHIP_UNKNOWN_UNSUPPORTED",
}
BindingExplanation_Membership_value = map[string]int32{
"MEMBERSHIP_UNSPECIFIED": 0,
"MEMBERSHIP_INCLUDED": 1,
"MEMBERSHIP_NOT_INCLUDED": 2,
"MEMBERSHIP_UNKNOWN_INFO_DENIED": 3,
"MEMBERSHIP_UNKNOWN_UNSUPPORTED": 4,
}
)Enum value maps for BindingExplanation_Membership.
File_google_cloud_policytroubleshooter_v1_checker_proto
var File_google_cloud_policytroubleshooter_v1_checker_proto protoreflect.FileDescriptorFile_google_cloud_policytroubleshooter_v1_explanations_proto
var File_google_cloud_policytroubleshooter_v1_explanations_proto protoreflect.FileDescriptorFunctions
func RegisterIamCheckerServer
func RegisterIamCheckerServer(s *grpc.Server, srv IamCheckerServer)AccessState
type AccessState int32Whether a principal has a permission for a resource.
AccessState_ACCESS_STATE_UNSPECIFIED, AccessState_GRANTED, AccessState_NOT_GRANTED, AccessState_UNKNOWN_CONDITIONAL, AccessState_UNKNOWN_INFO_DENIED
const (
// Default value. This value is unused.
AccessState_ACCESS_STATE_UNSPECIFIED AccessState = 0
// The principal has the permission.
AccessState_GRANTED AccessState = 1
// The principal does not have the permission.
AccessState_NOT_GRANTED AccessState = 2
// The principal has the permission only if a condition expression evaluates
// to `true`.
AccessState_UNKNOWN_CONDITIONAL AccessState = 3
// The sender of the request does not have access to all of the policies that
// Policy Troubleshooter needs to evaluate.
AccessState_UNKNOWN_INFO_DENIED AccessState = 4
)func (AccessState) Descriptor
func (AccessState) Descriptor() protoreflect.EnumDescriptorfunc (AccessState) Enum
func (x AccessState) Enum() *AccessStatefunc (AccessState) EnumDescriptor
func (AccessState) EnumDescriptor() ([]byte, []int)Deprecated: Use AccessState.Descriptor instead.
func (AccessState) Number
func (x AccessState) Number() protoreflect.EnumNumberfunc (AccessState) String
func (x AccessState) String() stringfunc (AccessState) Type
func (AccessState) Type() protoreflect.EnumTypeAccessTuple
type AccessTuple struct {
// Required. The principal whose access you want to check, in the form of
// the email address that represents that principal. For example,
// `alice@example.com` or
// `my-service-account@my-project.iam.gserviceaccount.com`.
//
// The principal must be a Google Account or a service account. Other types of
// principals are not supported.
Principal string `protobuf:"bytes,1,opt,name=principal,proto3" json:"principal,omitempty"`
// Required. The full resource name that identifies the resource. For example,
// `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance`.
//
// For examples of full resource names for Google Cloud services, see
// https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
FullResourceName string `protobuf:"bytes,2,opt,name=full_resource_name,json=fullResourceName,proto3" json:"full_resource_name,omitempty"`
// Required. The IAM permission to check for the specified principal and
// resource.
//
// For a complete list of IAM permissions, see
// https://cloud.google.com/iam/help/permissions/reference.
//
// For a complete list of predefined IAM roles and the permissions in each
// role, see https://cloud.google.com/iam/help/roles/reference.
Permission string `protobuf:"bytes,3,opt,name=permission,proto3" json:"permission,omitempty"`
// contains filtered or unexported fields
}Information about the principal, resource, and permission to check.
func (*AccessTuple) Descriptor
func (*AccessTuple) Descriptor() ([]byte, []int)Deprecated: Use AccessTuple.ProtoReflect.Descriptor instead.
func (*AccessTuple) GetFullResourceName
func (x *AccessTuple) GetFullResourceName() stringfunc (*AccessTuple) GetPermission
func (x *AccessTuple) GetPermission() stringfunc (*AccessTuple) GetPrincipal
func (x *AccessTuple) GetPrincipal() stringfunc (*AccessTuple) ProtoMessage
func (*AccessTuple) ProtoMessage()func (*AccessTuple) ProtoReflect
func (x *AccessTuple) ProtoReflect() protoreflect.Messagefunc (*AccessTuple) Reset
func (x *AccessTuple) Reset()func (*AccessTuple) String
func (x *AccessTuple) String() stringBindingExplanation
type BindingExplanation struct {
Access AccessState `protobuf:"varint,1,opt,name=access,proto3,enum=google.cloud.policytroubleshooter.v1.AccessState" json:"access,omitempty"`
Role string `protobuf:"bytes,2,opt,name=role,proto3" json:"role,omitempty"`
RolePermission BindingExplanation_RolePermission "" /* 180 byte string literal not displayed */
RolePermissionRelevance HeuristicRelevance "" /* 194 byte string literal not displayed */
Memberships map[string]*BindingExplanation_AnnotatedMembership "" /* 163 byte string literal not displayed */
Relevance HeuristicRelevance "" /* 133 byte string literal not displayed */
Condition *expr.Expr `protobuf:"bytes,7,opt,name=condition,proto3" json:"condition,omitempty"`
}Details about how a binding in a policy affects a principal's ability to use a permission.
func (*BindingExplanation) Descriptor
func (*BindingExplanation) Descriptor() ([]byte, []int)Deprecated: Use BindingExplanation.ProtoReflect.Descriptor instead.
func (*BindingExplanation) GetAccess
func (x *BindingExplanation) GetAccess() AccessStatefunc (*BindingExplanation) GetCondition
func (x *BindingExplanation) GetCondition() *expr.Exprfunc (*BindingExplanation) GetMemberships
func (x *BindingExplanation) GetMemberships() map[string]*BindingExplanation_AnnotatedMembershipfunc (*BindingExplanation) GetRelevance
func (x *BindingExplanation) GetRelevance() HeuristicRelevancefunc (*BindingExplanation) GetRole
func (x *BindingExplanation) GetRole() stringfunc (*BindingExplanation) GetRolePermission
func (x *BindingExplanation) GetRolePermission() BindingExplanation_RolePermissionfunc (*BindingExplanation) GetRolePermissionRelevance
func (x *BindingExplanation) GetRolePermissionRelevance() HeuristicRelevancefunc (*BindingExplanation) ProtoMessage
func (*BindingExplanation) ProtoMessage()func (*BindingExplanation) ProtoReflect
func (x *BindingExplanation) ProtoReflect() protoreflect.Messagefunc (*BindingExplanation) Reset
func (x *BindingExplanation) Reset()func (*BindingExplanation) String
func (x *BindingExplanation) String() stringBindingExplanation_AnnotatedMembership
type BindingExplanation_AnnotatedMembership struct {
Membership BindingExplanation_Membership "" /* 146 byte string literal not displayed */
Relevance HeuristicRelevance "" /* 133 byte string literal not displayed */
}Details about whether the binding includes the principal.
func (*BindingExplanation_AnnotatedMembership) Descriptor
func (*BindingExplanation_AnnotatedMembership) Descriptor() ([]byte, []int)Deprecated: Use BindingExplanation_AnnotatedMembership.ProtoReflect.Descriptor instead.
func (*BindingExplanation_AnnotatedMembership) GetMembership
func (x *BindingExplanation_AnnotatedMembership) GetMembership() BindingExplanation_Membershipfunc (*BindingExplanation_AnnotatedMembership) GetRelevance
func (x *BindingExplanation_AnnotatedMembership) GetRelevance() HeuristicRelevancefunc (*BindingExplanation_AnnotatedMembership) ProtoMessage
func (*BindingExplanation_AnnotatedMembership) ProtoMessage()func (*BindingExplanation_AnnotatedMembership) ProtoReflect
func (x *BindingExplanation_AnnotatedMembership) ProtoReflect() protoreflect.Messagefunc (*BindingExplanation_AnnotatedMembership) Reset
func (x *BindingExplanation_AnnotatedMembership) Reset()func (*BindingExplanation_AnnotatedMembership) String
func (x *BindingExplanation_AnnotatedMembership) String() stringBindingExplanation_Membership
type BindingExplanation_Membership int32Whether the binding includes the principal.
BindingExplanation_MEMBERSHIP_UNSPECIFIED, BindingExplanation_MEMBERSHIP_INCLUDED, BindingExplanation_MEMBERSHIP_NOT_INCLUDED, BindingExplanation_MEMBERSHIP_UNKNOWN_INFO_DENIED, BindingExplanation_MEMBERSHIP_UNKNOWN_UNSUPPORTED
const (
// Default value. This value is unused.
BindingExplanation_MEMBERSHIP_UNSPECIFIED BindingExplanation_Membership = 0
// The binding includes the principal. The principal can be included
// directly or indirectly. For example:
//
// * A principal is included directly if that principal is listed in the
// binding.
// * A principal is included indirectly if that principal is in a Google
// group or Google Workspace domain that is listed in the binding.
BindingExplanation_MEMBERSHIP_INCLUDED BindingExplanation_Membership = 1
// The binding does not include the principal.
BindingExplanation_MEMBERSHIP_NOT_INCLUDED BindingExplanation_Membership = 2
// The sender of the request is not allowed to access the binding.
BindingExplanation_MEMBERSHIP_UNKNOWN_INFO_DENIED BindingExplanation_Membership = 3
// The principal is an unsupported type. Only Google Accounts and service
// accounts are supported.
BindingExplanation_MEMBERSHIP_UNKNOWN_UNSUPPORTED BindingExplanation_Membership = 4
)func (BindingExplanation_Membership) Descriptor
func (BindingExplanation_Membership) Descriptor() protoreflect.EnumDescriptorfunc (BindingExplanation_Membership) Enum
func (x BindingExplanation_Membership) Enum() *BindingExplanation_Membershipfunc (BindingExplanation_Membership) EnumDescriptor
func (BindingExplanation_Membership) EnumDescriptor() ([]byte, []int)Deprecated: Use BindingExplanation_Membership.Descriptor instead.
func (BindingExplanation_Membership) Number
func (x BindingExplanation_Membership) Number() protoreflect.EnumNumberfunc (BindingExplanation_Membership) String
func (x BindingExplanation_Membership) String() stringfunc (BindingExplanation_Membership) Type
func (BindingExplanation_Membership) Type() protoreflect.EnumTypeBindingExplanation_RolePermission
type BindingExplanation_RolePermission int32Whether a role includes a specific permission.
BindingExplanation_ROLE_PERMISSION_UNSPECIFIED, BindingExplanation_ROLE_PERMISSION_INCLUDED, BindingExplanation_ROLE_PERMISSION_NOT_INCLUDED, BindingExplanation_ROLE_PERMISSION_UNKNOWN_INFO_DENIED
const (
// Default value. This value is unused.
BindingExplanation_ROLE_PERMISSION_UNSPECIFIED BindingExplanation_RolePermission = 0
// The permission is included in the role.
BindingExplanation_ROLE_PERMISSION_INCLUDED BindingExplanation_RolePermission = 1
// The permission is not included in the role.
BindingExplanation_ROLE_PERMISSION_NOT_INCLUDED BindingExplanation_RolePermission = 2
// The sender of the request is not allowed to access the binding.
BindingExplanation_ROLE_PERMISSION_UNKNOWN_INFO_DENIED BindingExplanation_RolePermission = 3
)func (BindingExplanation_RolePermission) Descriptor
func (BindingExplanation_RolePermission) Descriptor() protoreflect.EnumDescriptorfunc (BindingExplanation_RolePermission) Enum
func (x BindingExplanation_RolePermission) Enum() *BindingExplanation_RolePermissionfunc (BindingExplanation_RolePermission) EnumDescriptor
func (BindingExplanation_RolePermission) EnumDescriptor() ([]byte, []int)Deprecated: Use BindingExplanation_RolePermission.Descriptor instead.
func (BindingExplanation_RolePermission) Number
func (x BindingExplanation_RolePermission) Number() protoreflect.EnumNumberfunc (BindingExplanation_RolePermission) String
func (x BindingExplanation_RolePermission) String() stringfunc (BindingExplanation_RolePermission) Type
func (BindingExplanation_RolePermission) Type() protoreflect.EnumTypeExplainedPolicy
type ExplainedPolicy struct {
Access AccessState `protobuf:"varint,1,opt,name=access,proto3,enum=google.cloud.policytroubleshooter.v1.AccessState" json:"access,omitempty"`
FullResourceName string `protobuf:"bytes,2,opt,name=full_resource_name,json=fullResourceName,proto3" json:"full_resource_name,omitempty"`
Policy *iampb.Policy `protobuf:"bytes,3,opt,name=policy,proto3" json:"policy,omitempty"`
BindingExplanations []*BindingExplanation `protobuf:"bytes,4,rep,name=binding_explanations,json=bindingExplanations,proto3" json:"binding_explanations,omitempty"`
Relevance HeuristicRelevance "" /* 133 byte string literal not displayed */
}Details about how a specific IAM [Policy][google.iam.v1.Policy] contributed to the access check.
func (*ExplainedPolicy) Descriptor
func (*ExplainedPolicy) Descriptor() ([]byte, []int)Deprecated: Use ExplainedPolicy.ProtoReflect.Descriptor instead.
func (*ExplainedPolicy) GetAccess
func (x *ExplainedPolicy) GetAccess() AccessStatefunc (*ExplainedPolicy) GetBindingExplanations
func (x *ExplainedPolicy) GetBindingExplanations() []*BindingExplanationfunc (*ExplainedPolicy) GetFullResourceName
func (x *ExplainedPolicy) GetFullResourceName() stringfunc (*ExplainedPolicy) GetPolicy
func (x *ExplainedPolicy) GetPolicy() *iampb.Policyfunc (*ExplainedPolicy) GetRelevance
func (x *ExplainedPolicy) GetRelevance() HeuristicRelevancefunc (*ExplainedPolicy) ProtoMessage
func (*ExplainedPolicy) ProtoMessage()func (*ExplainedPolicy) ProtoReflect
func (x *ExplainedPolicy) ProtoReflect() protoreflect.Messagefunc (*ExplainedPolicy) Reset
func (x *ExplainedPolicy) Reset()func (*ExplainedPolicy) String
func (x *ExplainedPolicy) String() stringHeuristicRelevance
type HeuristicRelevance int32The extent to which a single data point, such as the existence of a binding or whether a binding includes a specific principal, contributes to an overall determination.
HeuristicRelevance_HEURISTIC_RELEVANCE_UNSPECIFIED, HeuristicRelevance_NORMAL, HeuristicRelevance_HIGH
const (
// Default value. This value is unused.
HeuristicRelevance_HEURISTIC_RELEVANCE_UNSPECIFIED HeuristicRelevance = 0
// The data point has a limited effect on the result. Changing the data point
// is unlikely to affect the overall determination.
HeuristicRelevance_NORMAL HeuristicRelevance = 1
// The data point has a strong effect on the result. Changing the data point
// is likely to affect the overall determination.
HeuristicRelevance_HIGH HeuristicRelevance = 2
)func (HeuristicRelevance) Descriptor
func (HeuristicRelevance) Descriptor() protoreflect.EnumDescriptorfunc (HeuristicRelevance) Enum
func (x HeuristicRelevance) Enum() *HeuristicRelevancefunc (HeuristicRelevance) EnumDescriptor
func (HeuristicRelevance) EnumDescriptor() ([]byte, []int)Deprecated: Use HeuristicRelevance.Descriptor instead.
func (HeuristicRelevance) Number
func (x HeuristicRelevance) Number() protoreflect.EnumNumberfunc (HeuristicRelevance) String
func (x HeuristicRelevance) String() stringfunc (HeuristicRelevance) Type
func (HeuristicRelevance) Type() protoreflect.EnumTypeIamCheckerClient
type IamCheckerClient interface {
// Checks whether a principal has a specific permission for a specific
// resource, and explains why the principal does or does not have that
// permission.
TroubleshootIamPolicy(ctx context.Context, in *TroubleshootIamPolicyRequest, opts ...grpc.CallOption) (*TroubleshootIamPolicyResponse, error)
}IamCheckerClient is the client API for IamChecker service.
For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
func NewIamCheckerClient
func NewIamCheckerClient(cc grpc.ClientConnInterface) IamCheckerClientIamCheckerServer
type IamCheckerServer interface {
// Checks whether a principal has a specific permission for a specific
// resource, and explains why the principal does or does not have that
// permission.
TroubleshootIamPolicy(context.Context, *TroubleshootIamPolicyRequest) (*TroubleshootIamPolicyResponse, error)
}IamCheckerServer is the server API for IamChecker service.
TroubleshootIamPolicyRequest
type TroubleshootIamPolicyRequest struct {
// The information to use for checking whether a principal has a permission
// for a resource.
AccessTuple *AccessTuple `protobuf:"bytes,1,opt,name=access_tuple,json=accessTuple,proto3" json:"access_tuple,omitempty"`
// contains filtered or unexported fields
}Request for [TroubleshootIamPolicy][google.cloud.policytroubleshooter.v1.IamChecker.TroubleshootIamPolicy].
func (*TroubleshootIamPolicyRequest) Descriptor
func (*TroubleshootIamPolicyRequest) Descriptor() ([]byte, []int)Deprecated: Use TroubleshootIamPolicyRequest.ProtoReflect.Descriptor instead.
func (*TroubleshootIamPolicyRequest) GetAccessTuple
func (x *TroubleshootIamPolicyRequest) GetAccessTuple() *AccessTuplefunc (*TroubleshootIamPolicyRequest) ProtoMessage
func (*TroubleshootIamPolicyRequest) ProtoMessage()func (*TroubleshootIamPolicyRequest) ProtoReflect
func (x *TroubleshootIamPolicyRequest) ProtoReflect() protoreflect.Messagefunc (*TroubleshootIamPolicyRequest) Reset
func (x *TroubleshootIamPolicyRequest) Reset()func (*TroubleshootIamPolicyRequest) String
func (x *TroubleshootIamPolicyRequest) String() stringTroubleshootIamPolicyResponse
type TroubleshootIamPolicyResponse struct {
// Indicates whether the principal has the specified permission for the
// specified resource, based on evaluating all of the applicable IAM policies.
Access AccessState `protobuf:"varint,1,opt,name=access,proto3,enum=google.cloud.policytroubleshooter.v1.AccessState" json:"access,omitempty"`
// List of IAM policies that were evaluated to check the principal's
// permissions, with annotations to indicate how each policy contributed to
// the final result.
//
// The list of policies can include the policy for the resource itself. It can
// also include policies that are inherited from higher levels of the resource
// hierarchy, including the organization, the folder, and the project.
//
// To learn more about the resource hierarchy, see
// https://cloud.google.com/iam/help/resource-hierarchy.
ExplainedPolicies []*ExplainedPolicy `protobuf:"bytes,2,rep,name=explained_policies,json=explainedPolicies,proto3" json:"explained_policies,omitempty"`
// The general errors contained in the troubleshooting response.
Errors []*status.Status `protobuf:"bytes,3,rep,name=errors,proto3" json:"errors,omitempty"`
// contains filtered or unexported fields
}Response for [TroubleshootIamPolicy][google.cloud.policytroubleshooter.v1.IamChecker.TroubleshootIamPolicy].
func (*TroubleshootIamPolicyResponse) Descriptor
func (*TroubleshootIamPolicyResponse) Descriptor() ([]byte, []int)Deprecated: Use TroubleshootIamPolicyResponse.ProtoReflect.Descriptor instead.
func (*TroubleshootIamPolicyResponse) GetAccess
func (x *TroubleshootIamPolicyResponse) GetAccess() AccessStatefunc (*TroubleshootIamPolicyResponse) GetErrors
func (x *TroubleshootIamPolicyResponse) GetErrors() []*status.Statusfunc (*TroubleshootIamPolicyResponse) GetExplainedPolicies
func (x *TroubleshootIamPolicyResponse) GetExplainedPolicies() []*ExplainedPolicyfunc (*TroubleshootIamPolicyResponse) ProtoMessage
func (*TroubleshootIamPolicyResponse) ProtoMessage()func (*TroubleshootIamPolicyResponse) ProtoReflect
func (x *TroubleshootIamPolicyResponse) ProtoReflect() protoreflect.Messagefunc (*TroubleshootIamPolicyResponse) Reset
func (x *TroubleshootIamPolicyResponse) Reset()func (*TroubleshootIamPolicyResponse) String
func (x *TroubleshootIamPolicyResponse) String() stringUnimplementedIamCheckerServer
type UnimplementedIamCheckerServer struct {
}UnimplementedIamCheckerServer can be embedded to have forward compatible implementations.
func (*UnimplementedIamCheckerServer) TroubleshootIamPolicy
func (*UnimplementedIamCheckerServer) TroubleshootIamPolicy(context.Context, *TroubleshootIamPolicyRequest) (*TroubleshootIamPolicyResponse, error)