AccessApprovalSettings

Einstellungen für ein Projekt, einen Ordner oder eine Organisation im Zusammenhang mit der Zugriffsgenehmigung.

JSON-Darstellung
{
  "name": string,
  "notificationEmails": [
    string
  ],
  "enrolledServices": [
    {
      object (EnrolledService)
    }
  ],
  "enrolledAncestor": boolean,
  "activeKeyVersion": string,
  "ancestorHasActiveKeyVersion": boolean,
  "invalidKeyVersion": boolean,
  "preferredRequestExpirationDays": integer,
  "preferNoBroadApprovalRequests": boolean
}
Felder
name

string

Der Ressourcenname der Einstellungen. Das Format ist eines der folgenden:

  • „projects/{project}/accessApprovalSettings“
  • "folders/{folder}/accessApprovalSettings"
  • "organizations/{organization}/accessApprovalSettings"
notificationEmails[]

string

Eine Liste mit E-Mail-Adressen, an die Benachrichtigungen zu Genehmigungsanfragen gesendet werden sollen. Benachrichtigungen zu einer Ressource werden an alle E-Mails in den Einstellungen der Ancestor-Ressourcen dieser Ressource gesendet. Es sind maximal 50 E-Mail-Adressen zulässig.

enrolledServices[]

object (EnrolledService)

Eine Liste der Google Cloud-Dienste, für die die angegebene Ressource die Zugriffsgenehmigung registriert hat. Zugriffsanfragen für die namentlich angegebene Ressource für einen der hier enthaltenen Dienste müssen ausdrücklich genehmigt werden. Wenn sich der Name auf eine Organisation bezieht, ist die Registrierung für einzelne Dienste möglich. Wenn sich der Name auf einen Ordner oder ein Projekt bezieht, kann die Registrierung nur für die gesamte Organisation erfolgen.

Wenn ein cloudProduct wiederholt in dieser Liste vorkommt, wird der erste Eintrag berücksichtigt und alle folgenden Einträge werden verworfen. Es werden maximal 10 registrierte Dienste erzwungen. Diese werden dann erweitert, wenn die Anzahl der unterstützten Dienste erweitert wird.

enrolledAncestor

boolean

Nur Ausgabe. Dieses Feld ist schreibgeschützt und kann nicht über die Methode „projects.updateAccessApprovalSettings“ festgelegt werden. Wenn das Feld auf „true“ gesetzt ist, bedeutet dies, dass mindestens ein Dienst für die Zugriffsgenehmigung in einem oder mehreren Ancestors des Projekts oder des Ordners registriert ist. Dieses Feld wird für die Organisation immer nicht festgelegt, da Organisationen keine Ancestors haben.

activeKeyVersion

string

Die Version des asymmetrischen kryptografischen Schlüssels zum Signieren von Genehmigungsanfragen. Wenn „activeKeyVersion“ leer ist, sollte zum Signieren ein von Google verwalteter Schlüssel verwendet werden. Dieses Attribut wird ignoriert, wenn es von einem Ancestor dieser Ressource festgelegt wurde. Es können keine neuen nicht leeren Werte festgelegt werden.

ancestorHasActiveKeyVersion

boolean

Nur Ausgabe. Dieses Feld ist schreibgeschützt und kann nicht über die Methode „projects.updateAccessApprovalSettings“ festgelegt werden. Wenn das Feld auf „true“ gesetzt ist, bedeutet dies, dass ein Ancestor dieses Projekts oder Ordners „activeKeyVersion“ festgelegt hat. Dieses Feld wird für die Organisation immer nicht festgelegt, da Organisationen keine Ancestors haben.

invalidKeyVersion

boolean

Nur Ausgabe. Dieses Feld ist schreibgeschützt und kann nicht über die Methode „projects.updateAccessApprovalSettings“ festgelegt werden. Wenn das Feld auf „true“ gesetzt ist, bedeutet dies, dass es ein Konfigurationsproblem mit der ActiveKeyVersion gibt, die auf dieser Ebene in der Ressourcenhierarchie konfiguriert wurde. Diese ist z. B. nicht vorhanden oder das Access Approval-Dienstkonto hat nicht die richtigen Berechtigungen dafür usw. Diese Schlüsselversion ist nicht unbedingt die aktuelle Schlüsselversion auf dieser Ebene, da Schlüsselversionen von oben nach unten übernommen werden.

preferredRequestExpirationDays

integer

Diese Einstellung wird mit Google-Mitarbeitern geteilt, kann aber überschrieben werden, wenn das betreffende Personal dies für notwendig hält. Der Genehmiger kann die Ablaufzeit zum Zeitpunkt der Genehmigung festlegen.

preferNoBroadApprovalRequests

boolean

Diese Einstellung wird Google-Mitarbeitern beim Senden einer Genehmigungsanfrage mitgeteilt, kann aber bei Bedarf überschrieben werden.

EnrolledService

Stellt die Registrierung einer Cloud-Ressource bei einem bestimmten Dienst dar.

JSON-Darstellung
{
  "cloudProduct": string,
  "enrollmentLevel": enum (EnrollmentLevel)
}
Felder
cloudProduct

string

Das Produkt, für das Access Approval registriert wird. Die zulässigen Werte sind unten aufgeführt (Groß-/Kleinschreibung beachten):

  • alle
  • GA
  • App Engine
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Bigtable
  • Cloud Key Management Service
  • Compute Engine
  • Cloud Composer
  • Cloud Dataflow
  • Cloud Dataproc
  • Cloud DLP
  • Cloud EKM
  • Cloud Firestore
  • Cloud HSM
  • Cloud Identity and Access Management
  • Cloud Logging
  • Cloud NAT
  • Cloud Pub/Sub
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Eventarc
  • Google Kubernetes Engine
  • Dienst für Organisationsrichtlinien
  • Persistent Disk
  • Resource Manager
  • Secret Manager
  • Speaker ID

Hinweis: Diese Werte werden als Eingabe für alte Zwecke unterstützt, aber nicht von der API zurückgegeben.

  • alle
  • ga-only
  • appengine.googleapis.com
  • artifactregistry.googleapis.com
  • bigquery.googleapis.com
  • bigtable.googleapis.com
  • container.googleapis.com
  • cloudkms.googleapis.com
  • cloudresourcemanager.googleapis.com
  • cloudsql.googleapis.com
  • compute.googleapis.com
  • dataflow.googleapis.com
  • dataproc.googleapis.com
  • dlp.googleapis.com
  • iam.googleapis.com
  • logging.googleapis.com
  • orgpolicy.googleapis.com
  • pubsub.googleapis.com
  • spanner.googleapis.com
  • secretmanager.googleapis.com
  • speakerid.googleapis.com
  • storage.googleapis.com

Aufrufe von „projects.updateAccessApprovalSettings“ mit „all“ oder einer der XXX.googleapis.com werden in den zugehörigen Produktnamen („all“, „App Engine“ usw.) übersetzt.

Hinweis: Mit „alle“ wird die Ressource in allen Produkten registriert, die sowohl auf GA- als auch auf Vorschauebene unterstützt werden.

Weitere Informationen zu Supportstufen finden Sie unter https://cloud.google.com/access-approval/docs/supported-services.

enrollmentLevel

enum (EnrollmentLevel)

Die Registrierungsstufe des Dienstes.

EnrollmentLevel

Stellt die Art der Registrierung für einen bestimmten Dienst für die Zugriffsgenehmigung dar.

Enums
ENROLLMENT_LEVEL_UNSPECIFIED Standardwert für Proto, sollte nicht verwendet werden.
BLOCK_ALL Der Dienst ist für alle Anfragen für Access Approval registriert