- JSON representation
- EnrolledService
- EnrollmentLevel
- RequestScopeMaxWidthPreference
- CustomerApprovalApprovalPolicy
- JustificationBasedApprovalPolicy
Settings on a Project/Folder/Organization related to Access Approval.
JSON representation |
---|
{ "name": string, "notificationEmails": [ string ], "enrolledServices": [ { object ( |
Fields | |
---|---|
name |
The resource name of the settings. Format is one of:
|
notificationEmails[] |
A list of email addresses to which notifications relating to approval requests should be sent. Notifications relating to a resource will be sent to all emails in the settings of ancestor resources of that resource. A maximum of 50 email addresses are allowed. |
enrolledServices[] |
A list of Google Cloud Services for which the given resource has Access Approval enrolled. Access requests for the resource given by name against any of these services contained here will be required to have explicit approval. If name refers to an organization, enrollment can be done for individual services. If name refers to a folder or project, enrollment can only be done on an all or nothing basis. If a cloudProduct is repeated in this list, the first entry will be honored and all following entries will be discarded. |
enrolledAncestor |
Output only. This field is read only (not settable via projects.updateAccessApprovalSettings method). If the field is true, that indicates that at least one service is enrolled for Access Approval in one or more ancestors of the Project or Folder (this field will always be unset for the organization since organizations do not have ancestors). |
activeKeyVersion |
The asymmetric crypto key version to use for signing approval requests. Empty activeKeyVersion indicates that a Google-managed key should be used for signing. This property will be ignored if set by an ancestor of this resource, and new non-empty values may not be set. |
ancestorHasActiveKeyVersion |
Output only. This field is read only (not settable via projects.updateAccessApprovalSettings method). If the field is true, that indicates that an ancestor of this Project or Folder has set activeKeyVersion (this field will always be unset for the organization since organizations do not have ancestors). |
invalidKeyVersion |
Output only. This field is read only (not settable via projects.updateAccessApprovalSettings method). If the field is true, that indicates that there is some configuration issue with the activeKeyVersion configured at this level in the resource hierarchy (e.g. it doesn't exist or the Access Approval service account doesn't have the correct permissions on it, etc.) This key version is not necessarily the effective key version at this level, as key versions are inherited top-down. |
preferredRequestExpirationDays |
Set the default access approval request expiration time. This value is able to be set directly by the customer at the time of approval, overriding this suggested value. We recommend setting this value to 30 days. |
preferNoBroadApprovalRequests |
This field is used to set a preference for granularity of an access approval request. If true, Google personnel will be asked to send resource-level requests when possible. If false, Google personnel will be asked to send requests at the project level. |
notificationPubsubTopic |
Optional. A pubsub topic that notifications relating to access approval are published to. Notifications include pre-approved accesses. |
requireCustomerVisibleJustification |
Optional. When enabled, Google will only be able to send approval requests for access reasons with a customer accessible case ID in the reason detail. Also known as "Require customer initiated support case justification" |
requestScopeMaxWidthPreference |
Optional. A setting that indicates the maximum scope of an Access Approval request: either organization, folder, or project. Google administrators will be asked to send requests no broader than the configured scope. |
approvalPolicy |
Optional. Policy configuration for Access Approval that sets the operating mode. The available policies are Transparency, Streamlined Support, and Approval Required. |
effectiveApprovalPolicy |
Output only. Effective policy applied for Access Approval, inclusive of inheritance. |
EnrolledService
Represents the enrollment of a cloud resource into a specific service.
JSON representation |
---|
{
"cloudProduct": string,
"enrollmentLevel": enum ( |
Fields | |
---|---|
cloudProduct |
The product for which Access Approval will be enrolled. Allowed values are listed below (case-sensitive):
Note: These values are supported as input for legacy purposes, but will not be returned from the API.
Calls to projects.updateAccessApprovalSettings using 'all' or any of the XXX.googleapis.com will be translated to the associated product name ('all', 'App Engine', etc.). Note: 'all' will enroll the resource in all products supported at both 'GA' and 'Preview' levels. More information about levels of support is available at https://cloud.google.com/access-approval/docs/supported-services |
enrollmentLevel |
The enrollment level of the service. |
EnrollmentLevel
Represents the type of enrollment for a given service to Access Approval.
Enums | |
---|---|
ENROLLMENT_LEVEL_UNSPECIFIED |
Default value if not set, defaults to "BLOCK_ALL". This value is not available to be set by the user, do not use. |
BLOCK_ALL |
Service is enrolled in Access Approval for all requests |
RequestScopeMaxWidthPreference
Represents the desired maximum scope of an Access Approval request request from Google personnel. Administrators will be asked to send requests no broader than the configured scope (organization, folder, or project).
Enums | |
---|---|
REQUEST_SCOPE_MAX_WIDTH_PREFERENCE_UNSPECIFIED |
Default value, defaults to ORGANIZATION if not set. This value is not able to be configured by the user, do not use. |
ORGANIZATION |
This is the widest scope possible. It means the customer has no scope restriction when it comes to Access Approval requests. |
FOLDER |
Customer allows the scope of Access Approval requests as broad as the Folder level. |
PROJECT |
Customer allows the scope of Access Approval requests as broad as the Project level. |
CustomerApprovalApprovalPolicy
Represents all the policies that can be set for Customer Approval.
JSON representation |
---|
{
"justificationBasedApprovalPolicy": enum ( |
Fields | |
---|---|
justificationBasedApprovalPolicy |
Optional. Policy for approval based on the justification given. |
JustificationBasedApprovalPolicy
Access approval policy configured for the configured resource.
Enums | |
---|---|
JUSTIFICATION_BASED_APPROVAL_POLICY_UNSPECIFIED |
Default value, defaults to JUSTIFICATION_BASED_APPROVAL_NOT_ENABLED if not set. This value is not able to be configured by the user, do not use. |
JUSTIFICATION_BASED_APPROVAL_ENABLED_ALL |
Audit-only mode. All accesses are pre-approved instantly. |
JUSTIFICATION_BASED_APPROVAL_ENABLED_EXTERNAL_JUSTIFICATIONS |
Customer initiated support access reasons are pre-approved instantly. All other accesses require customer approval. |
JUSTIFICATION_BASED_APPROVAL_NOT_ENABLED |
All access approval requests require customer approval. This is the default value if the policy is not set. |
JUSTIFICATION_BASED_APPROVAL_INHERITED |
Defer configuration to parent settings. This is the default value if the policy is not set and the parent has a value set. |