Wenn Ihr Identitätsanbieter (IdP) das System for Cross-domain Identity Management (SCIM) unterstützt, können Sie es so konfigurieren, dass Nutzer und Gruppen in Google Cloudbereitgestellt und verwaltet werden.
Leistungsspektrum
Die SCIM-Unterstützung für die Mitarbeiteridentitätsföderation bietet die folgenden Funktionen:
- Identitätssynchronisierung: Synchronisiert Nutzer und Gruppen von Ihrem externen IdP mit Google Cloud , um eine ganzheitliche Ansicht der Workforce-Identitäten zu erhalten.
- Primäre Quelle für Anforderungen: Wenn SCIM für einen Workforce-Anbieter aktiviert ist, verwendet Google Cloud die synchronisierten SCIM-Nutzer und -Gruppen als „Source of Truth“ für Nutzerattribute und Gruppenmitgliedschaften für die IAM-Richtlinienbewertung.
- Automatische Vervollständigung von Identitäten: Aktiviert die automatische Vervollständigung von Nutzern und Gruppen, wenn in Gemini Enterprise Zugriff gewährt und Ressourcen (z. B. Notebooks und Agents) freigegeben werden.
Hinweise
Wenn Sie die SCIM-Unterstützung der Mitarbeiteridentitätsföderation verwenden, gilt Folgendes:
- Sie müssen einen Workforce Identity-Pool und einen Anbieter einrichten, bevor Sie einen SCIM-Mandanten konfigurieren.
- Jeder Workforce Identity-Pool unterstützt nur einen SCIM-Mandanten, der mit einem einzelnen Anbieter verknüpft ist.
Sie können die SCIM-Nutzung (
--scim-usage) für keinen anderen Anbieter im selben Pool aktivieren. Wenn Sie einen neuen SCIM-Mandanten im selben Workforce Identity-Pool konfigurieren möchten, müssen Sie zuerst den vorhandenen löschen. Verwenden Sie eine der folgenden Methoden, um einen SCIM-Mandanten zu löschen:- Vorläufiges Löschen (Standardeinstellung): Wenn Sie einen SCIM-Mandanten löschen, wird ein 30-tägiger Zeitraum für das vorläufige Löschen gestartet. Während dieser Zeit ist der Mandant ausgeblendet und kann nicht verwendet werden. Außerdem können Sie im selben Workforce Identity-Pool keinen neuen SCIM-Mandanten erstellen.
- Endgültiges Löschen: Wenn Sie einen SCIM-Mandanten dauerhaft und sofort löschen möchten, verwenden Sie das Flag
--hard-deletemit dem Befehl „delete“. Diese Aktion kann nicht rückgängig gemacht werden. Sie können sofort einen neuen SCIM-Mandanten im selben Workforce Identity-Pool erstellen, ohne die 30-tägige Aufbewahrungsfrist abwarten zu müssen. Alternativ können Sie einen neuen Workforce Identity-Pool und einen neuen SCIM-Mandanten erstellen oder einen Workforce Identity-Pool verwenden, der noch nicht mit einem SCIM-Mandanten konfiguriert wurde.
- SCIM-Nutzungsmodi (
--scim-usage):enabled-for-groups(Gemini Enterprise): Verwendet SCIM-synchronisierte Gruppen für die IAM-Autorisierung und Richtlinienbewertung. Nutzerattribute werden weiterhin aus Anmeldetokens bezogen. Es werden nurgoogle.subject- undgoogle.group-Zuordnungen ausgewertet.enabled-for-users-groups(Gemini Enterprise und Looker): Verwendet über SCIM synchronisierte Nutzer- und Gruppendaten als Quelle für Anforderungen für die IAM-Autorisierung in Web- und OAuth-Anmeldeworkflows. Wertetgoogle.subject,google.groupund alle konfigurierten Nutzeransprüche aus (z. B.google.display_name,google.profile_photo,google.email,google.posix_usernameund benutzerdefinierteattribute.<var>KEY</var>).
- Gegenseitiger Ausschluss: Die Einstellung
--scim-usage=enabled-for-users-groupsschließt sich gegenseitig mit zusätzlichen Attributen (extra_attributes_oauth2_client) und erweiterten Attributen (extended_attributes_oauth2_client) aus. - Wenn Sie SCIM verwenden, ordnen Sie Attribute sowohl im Workforce Identity-Poolanbieter als auch im SCIM-Mandanten zu. Das Attribut
google.subjectmuss eindeutig auf dieselben Identitäten verweisen. Sie gebengoogle.subjectim Anbieter des Workforce Identity-Pools mit dem Flag--attribute-mappingund im SCIM-Mandanten mit dem Flag--claim-mappingan. Wenn Sie nicht eindeutige Identitätswerte zuordnen, kann es passieren, dass Google Cloud verschiedene IdP-Identitäten als dieselbe Identität behandelt. Daher kann der Zugriff, der einem Nutzer oder einer Gruppenidentität gewährt wird, auf andere ausgeweitet werden. Wenn Sie jedoch den Zugriff für einen Nutzer oder eine Gruppe widerrufen, wird er möglicherweise nicht für alle entfernt. - Wenn Sie die SCIM-Nutzung für einen Anbieter ohne angehängten SCIM-Mandanten aktivieren, schlagen Anmeldeversuche fehl, da Google Cloud keinen SCIM-Mandanten für diesen Anbieter finden kann.
- Erzwingung der Eindeutigkeit: Google Cloud validiert und erzwingt die Eindeutigkeit von Attributen, die in einem SCIM-Mandanten
google.subject(Nutzern) undgoogle.group(Gruppen) zugeordnet sind. Wenn die von Ihrem IdP bereitgestellten zugeordneten Attribute während der Synchronisierung zu doppelten Werten fürgoogle.subjectodergoogle.groupführen, schlägt die Bereitstellung mit einem HTTP-Fehler409 Conflictfehl. Wenn ein zugeordnetes Attribut als null oder leer ausgewertet wird, schlägt die Bereitstellung mit dem HTTP-Fehler400 Bad Requestfehl. - Größenbeschränkungen für Attribute: Die maximale Größe für serialisierte zugeordnete Nutzerattribute (ohne
google.group) beträgt 16 kB. Wenn zugeordnete Attribute dieses Limit überschreiten, schlagen Anmeldeversuche fehl. - SCIM-Tokenlimit: Jeder SCIM-Mandant unterstützt maximal zwei SCIM-Tokens (z. B. zur Unterstützung der Tokenrotation ohne Ausfallzeiten). Wenn Sie zwei Tokens haben, löschen Sie ein vorhandenes Token, bevor Sie ein neues erstellen.
- Für die SCIM API (
iamscim.googleapis.com) gelten Ratenkontingente, die sich von den Standardkontingenten für IAM-Ressourcen-APIs unterscheiden. Standardmäßig sind Schreib- und Leseanfragen auf 3.000 Anfragen pro SCIM-Mandant pro Organisation pro Minute begrenzt. Weitere Informationen finden Sie unter Kontingente und Limits.
Claim-Mapping
Wenn Sie SCIM konfigurieren, definieren Sie im SCIM-Mandanten Claim-Mappings (--claim-mapping), um SCIM-Nutzer- und Gruppenattribute Google-Attributen zuzuordnen.
Unterstützte Google Cloud -Attribute für das Claim-Mapping
In der folgenden Tabelle sind die Google Cloud -Attribute aufgeführt, die Sie in Ihrem SCIM-Mandanten (--claim-mapping) mit der Common Expression Language (CEL) zuordnen können:
| AttributGoogle Cloud | Anforderung | Beschreibung | Unterstützte Ausdrücke und Limits |
|---|---|---|---|
google.subject |
Erforderlich |
Eindeutige Kennung für den authentifizierenden Nutzer. Das zugrunde liegende IdP-Attribut, das zum Ausfüllen von |
Beschränkt auf die folgenden Basis-Ausdrücke (oder mit .lowerAscii()):
Maximale Länge: 127 Byte. Hinweis: Diese Zuordnung kann nach dem Erstellen des SCIM-Mandanten nicht mehr geändert werden. Wenn Sie sie aktualisieren möchten, müssen Sie den SCIM-Mandanten endgültig löschen und neu erstellen. |
google.group |
Obligatorisch für SCIM-Gruppen | Eindeutige Kennung für die Gruppenmitgliedschaft, die über SCIM synchronisiert wird. | Beschränkt auf die folgenden Basis-Ausdrücke (oder mit .lowerAscii()):
Hinweis: Diese Zuordnung kann nach dem Erstellen des SCIM-Mandanten nicht mehr geändert werden. Wenn Sie sie aktualisieren möchten, müssen Sie den SCIM-Mandanten endgültig löschen und neu erstellen. |
google.display_name |
Optional | Ein Attribut, mit dem der Name des angemeldeten Nutzers in der Google Cloud Console festgelegt wird. Es kann nicht in IAM-Zulassungsrichtlinien verwendet werden. | Wird einem Stringattribut zugeordnet (z. B. user.displayName oder user.name.formatted). Maximale Länge: 100 Byte. |
google.profile_photo |
Optional | Eine URL des Miniaturansichtsfotos des Nutzers, das in der Google Cloud Console als Profilbild angezeigt wird. Es kann nicht in IAM-Zulassungsrichtlinien verwendet werden. | Muss zu einem gültigen URL-String ausgewertet werden (z. B. user.photos.filter(p, p.type == 'thumbnail')[0].value oder user.photos[0].value). |
google.email |
Optional | Ein Attribut, mit dem E-Mail-Adressen vom IdP Produkten zugeordnet werden, die über die OAuth-Clientintegration der Mitarbeiteridentitätsföderation eingebunden sind. Es kann nicht in IAM-Zulassungsrichtlinien verwendet werden. | Wird einem E-Mail-Attribut zugeordnet (z. B. user.emails.filter(e, e.type == 'work')[0].value oder user.emails[0].value). |
google.posix_username |
Optional | Ein eindeutiger POSIX-konformer Nutzernamensstring, der für SSH im Browser und OS Login mit der Mitarbeiteridentitätsföderation verwendet wird. Dieses Attribut kann nicht in IAM-Zulassungsrichtlinien verwendet werden. | Die maximale Länge beträgt 32 Zeichen. |
attribute.KEY |
Optional |
Benutzerdefinierte Attribute von Ihrem IdP, mit denen Sie Ihre Autorisierungsstrategie in einer IAM-Zulassungsrichtlinie definieren können. Ersetzen Sie KEY durch den gewünschten Attributnamen. Sie können beispielsweise ein benutzerdefiniertes Attribut wie |
Bis zu 50 benutzerdefinierte Attributzuordnungsregeln. Maximale Größe pro Regel: 256 Zeichen. |
Verhalten basierend auf der SCIM-Nutzung des Anbieters (--scim-usage)
Die Auswertung von SCIM-Anforderungszuordnungen hängt vom --scim-usage-Modus ab, der für den Workforce Identity-Poolanbieter konfiguriert ist:
enabled-for-groups(Gemini Enterprise): Es werden nurgoogle.subject- undgoogle.group-Zuordnungen ausgewertet. Alle zusätzlichen Nutzeranspruchszuordnungen in--claim-mappingwerden ignoriert.enabled-for-users-groups(Gemini Enterprise und Looker): Wertetgoogle.subject,google.groupund alle konfigurierten Nutzeransprüche aus (z. B.google.display_name,google.profile_photo,google.email,google.posix_usernameund benutzerdefinierteattribute.<var>KEY</var>). Google Cloud verwendet SCIM-Ansprüche in den folgenden Anmelde-Workflows:- Webanmeldung: Wenn sich Nutzer bei Gemini Enterprise anmelden, verwendet Google Cloud die über SCIM synchronisierten Nutzer- und Gruppenansprüche. Wenn sich Nutzer in anderen Produkten wie der Google Cloud Console anmelden, verwendet Google Cloud die Attribute, die vom IdP-Token durch das Flag
--attribute-mappingdes Anbieters zugeordnet wurden. - OAuth-Anmeldung: Wenn sich Nutzer in Gemini Enterprise- und Looker-Anwendungen anmelden, die den OAuth-Ablauf der Mitarbeiteridentitätsföderation verwenden, verwendet Google Cloud die über SCIM synchronisierten Nutzer- und Gruppenansprüche. Wenn sich Nutzer in anderen Anwendungen anmelden, verwendet Google Cloud die Attribute, die vom IdP-Token durch das Flag
--attribute-mappingdes Anbieters zugeordnet wurden.
- Webanmeldung: Wenn sich Nutzer bei Gemini Enterprise anmelden, verwendet Google Cloud die über SCIM synchronisierten Nutzer- und Gruppenansprüche. Wenn sich Nutzer in anderen Produkten wie der Google Cloud Console anmelden, verwendet Google Cloud die Attribute, die vom IdP-Token durch das Flag
Beispielzuordnungen für die Konsistenz des Subjekts
Wie unter Unterstützte Attribute für das Claim-Mapping beschrieben, muss das zugrunde liegende IdP-Attribut, das zum Ausfüllen von google.subject verwendet wird, sowohl in der Anbieterzuordnung (--attribute-mapping) als auch im SCIM-Mandanten (--claim-mapping) identisch sein. Die folgende Tabelle enthält Referenzbeispiele:
| Google-Attribut | Anbieterzuordnung für Mitarbeiteridentitätspool | SCIM-Mandantenzuordnung (SCIM) |
|---|---|---|
google.subject |
assertion.oid (Entra ID) |
user.externalId |
google.subject |
assertion.sub (Okta) |
user.externalId |
google.subject |
assertion.preferred_username |
user.userName |
google.subject |
assertion.preferred_username.lowerAscii() |
user.userName.lowerAscii() |
google.subject |
assertion.email |
user.emails[0].value |
google.subject |
assertion.email.lowerAscii() |
user.emails[0].value.lowerAscii() |
Unterstützte und nicht unterstützte Endpunkte
Der IAM-SCIM-Dienst (iamscim.googleapis.com) implementiert das SCIM 2.0-Protokoll (RFC 7644) und verarbeitet Anfragen an den baseUri Ihres SCIM-Mandanten:
https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID
In diesem URI ist SCIM_TENANT_UID die eindeutige Kennung Ihres SCIM-Mandanten.
Der IAM-SCIM-Dienst unterstützt die folgenden Standard-SCIM-Protokollendpunkte relativ zum Mandanten baseUri:
/Users: Nutzerressourcen verwalten. Unterstützte Vorgänge:Create,Get,Update,Delete,PatchundPut./Groups: Gruppenressourcen verwalten. Unterstützte Vorgänge:Create,Get,Update,DeleteundPatch. Die MethodePUTwird für Gruppen nicht unterstützt./Schemas: Schemainformationen abrufen./ServiceProviderConfig: Ruft die Dienstanbieterkonfiguration ab.
Die folgenden SCIM-Protokollendpunkte werden nicht unterstützt:
/Me/Bulk/Search/ResourceTypes
Beschränkungen
In den folgenden Abschnitten werden die Einschränkungen und Abweichungen der SCIM-Implementierung der Mitarbeiteridentitätsföderation von den SCIM-Spezifikationen (RFC 7643 und 7644) beschrieben.
Einschränkungen der Protokollfunktion
Filterunterstützung: Wenn Sie Nutzer oder Gruppen mit den Endpunkten
/Usersoder/Groupsauflisten, unterstützen Filterausdrücke nur den Operatoreq(gleich). Sie können mehrereeq-Filter mitandkombinieren. Andere SCIM-Filteroperatoren wieco(enthält) odersw(beginnt mit) werden nicht unterstützt.Paginierung: Die IAM SCIM API unterstützt keine Standardpaginierung für das Auflisten von Nutzern oder Gruppen.
startIndex: Dieser Parameter ist immer1. Die API gibt bis zu 100 Ergebnisse zurück, unabhängig davon, welchen Wert Sie fürstartIndexangeben.itemsPerPage: Die maximale Anzahl von Ressourcen, die in einer einzelnen Antwort zurückgegeben werden, beträgt 100.totalResults: Die API gibt nicht die tatsächliche Gesamtzahl der übereinstimmenden Ressourcen zurück. Das FeldtotalResultsin der Antwort entspricht immer der Anzahl der Elemente, die in dieser Antwort zurückgegeben werden, maximal 100.
Gruppe abrufen und Gruppen ohne Filter auflisten: Die APIs
GetGroupundListGroupsgeben eine leere Mitgliederliste zurück. Verwenden Sie dieListGroupsAPI mit einem Mitgliederfilter, um Mitglieder für eine bestimmte Gruppe abzurufen.Nicht konforme JSON-Antwort mit ungültigen Tokens: Anfragen, die ein ungültiges API-Token enthalten, geben den Statuscode
HTTP 401von Google Cloudzurück. Die Antwort ist kein gültiges JSON-Format, wie es die SCIM-Spezifikation erfordert.
Einschränkungen des SCIM-Verhaltens
Unveränderliche Kennungen: Die Werte von SCIM-Attributen, die
google.subjectodergoogle.groupzugeordnet sind, werden in Google Cloudals unveränderliche Kennungen behandelt. Wenn Sie diese Werte ändern müssen, müssen Sie den Nutzer oder die Gruppe dauerhaft aus Ihrem IdP löschen und dann mit dem neuen Wert neu erstellen.Eindeutige und nicht leere Kennungen: Google Cloud erzwingt die Eindeutigkeit von Werten, die
google.subjectundgoogle.groupin einem SCIM-Mandanten zugeordnet sind. Die Synchronisierung zugeordneter Attribute, die zu doppelten Werten fürgoogle.subjectodergoogle.groupführt, schlägt mit einem HTTP-Fehler409 Conflictfehl. Zugeordnete Attribute, die als „null“ oder leer ausgewertet werden, schlagen mit dem HTTP-Fehler400 Bad Requestfehl.Anforderung für einzelne E-Mail-Adresse: Für eine erfolgreiche SCIM-Synchronisierung muss jeder Nutzer genau eine E-Mail-Adresse vom Typ
workhaben. Die Bereitstellung oder Aktualisierung schlägt fehl, wenn Ihr IdP mehrere E-Mails sendet oder wenn die angegebene einzelne E-Mail nicht vom Typworkist.Transformationen ohne Berücksichtigung der Groß-/Kleinschreibung: Für SCIM-Anforderungszuordnungen werden eingeschränkte CEL-Transformationen (Common Expression Language) unterstützt. Für Vergleiche ohne Berücksichtigung der Groß-/Kleinschreibung für
user.userNameunduser.emails[0].valuewird nur.lowerAscii()unterstützt.
Einschränkungen für Attribute
In den folgenden Abschnitten wird die Attributunterstützung für Nutzer, Gruppen und die Schemaerweiterung für Unternehmensnutzer beschrieben.
Nutzerattribute
In der folgenden Tabelle sind Nutzerattribute und ihre Verfügbarkeit in Anforderungen der Mitarbeiteridentitätsföderation aufgeführt:
| Attribut | Unterattribute | Unterstützt bei der SCIM-Bereitstellung | Beschränkungen | Unterstützt in --claim-mapping |
|---|---|---|---|---|
userName |
– | Ja | – | Ja |
name |
formatted, familyName, givenName, middleName, honorificPrefix, honorificSuffix |
Ja | – | Ja |
displayName |
– | Ja | – | Ja |
nickName |
– | Ja | – | Ja |
profileUrl |
– | Ja | – | Ja |
title |
– | Ja | – | Ja |
userType |
– | Ja | – | Ja |
preferredLanguage |
– | Ja | – | Ja |
locale |
– | Ja | – | Ja |
timezone |
– | Ja | – | Ja |
active |
– | Ja | – | Ja |
password |
– | Nein | – | Nein |
emails |
display, type, value, primary |
Ja | Nur der E-Mail-Typ work wird unterstützt. |
Ja |
phoneNumbers |
display, type, value, primary |
Ja | – | Ja |
ims |
display, type, value |
Ja | – | Ja |
photos |
display, type, value |
Ja | – | Ja |
addresses |
formatted, streetAddress, locality, region, postalCode, country |
Ja | – | Ja |
groups |
– | Nein | – | Nein |
entitlements |
display, type, value |
Ja | – | Ja |
roles |
type, value |
Ja | display wird nicht unterstützt |
Ja |
x509Certificates |
type, value |
Ja | display wird nicht unterstützt |
Nein |
Gruppenattribute
In der folgenden Tabelle sind Gruppenattribute und ihre Verfügbarkeit in Anforderungen der Mitarbeiteridentitätsföderation aufgeführt:
| Attribut | Unterstützte Unterattribute | Unterstützt in --claim-mapping |
|---|---|---|
displayName |
– | Ja |
externalId |
– | Ja |
members |
value, type, $ref, display |
Nein |
Erweiterungsattribute für das Schema von Unternehmensnutzern
In der folgenden Tabelle wird die Unterstützung für die Schemaerweiterung für Unternehmensnutzer beschrieben:
| Attribut | Unterstützte Unterattribute | Unterstützt in --claim-mapping |
|---|---|---|
employeeNumber |
– | Ja |
costCenter |
– | Ja |
organization |
– | Ja |
division |
– | Ja |
department |
– | Ja |
manager |
value, $ref, displayName |
Ja ($ref wird nur bei der SCIM-Bereitstellung unterstützt, nicht in --claim-mapping) |
Nächste Schritte
- SCIM in Microsoft Entra ID konfigurieren
- SCIM in Okta konfigurieren
- Fehlerbehebung bei der SCIM-Bereitstellung
- IAM-SCIM-Audit-Logging