Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Unternehmensgruppen mit der Cloud OAuth API abrufen

In diesem Leitfaden wird beschrieben, wie Sie Unternehmensgruppenmitgliedschaften für authentifizierte Workforce-Nutzer mithilfe des Endpunkts /groups in der Cloud OAuth API (cloudoauth.googleapis.com) abrufen.

Der Endpunkt /groups dient als Endpunkt für verteilte Ansprüche für OpenID Connect-Integrationen (OIDC) und gibt paginierte Unternehmensgruppenmitgliedschaften für Nutzer in SCIM-fähigen und nicht SCIM-fähigen Workforce Identity-Pools zurück.

Hinweis

Workforce Identity-Pool und -Anbieter konfigurieren Weitere Informationen finden Sie unter Mitarbeiteridentitätsföderation konfigurieren.
Registrieren Sie einen OAuth-Client und tauschen Sie einen Autorisierungscode gegen ein Zugriffstoken aus. Weitere Informationen finden Sie unter Tokens mit der Cloud OAuth API austauschen.
Aktivieren Sie die Cloud OAuth API, falls sie noch nicht aktiviert ist.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen
API aktivieren

Unternehmensgruppen abrufen

Wenn Sie Gruppenmitgliedschaften für den authentifizierten Nutzer abrufen möchten, senden Sie eine HTTP-GET-Anfrage an den /groups-Endpunkt:

Mit der Methode common.groups der Cloud OAuth API werden die Mitgliedschaften in Unternehmensgruppen für den authentifizierten Nutzer abgerufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

TOKEN: das kurzlebige OAuth 2.0-Zugriffstoken, das vom Tokenaustausch-Endpunkt abgerufen wurde.
PAGE_SIZE: Optional. Die maximale Anzahl von Gruppen, die pro Seite zurückgegeben werden sollen (zwischen 2.500 und 5.000).
PAGE_TOKEN: Optional. Ein Seitenumbruchtoken, das von einer vorherigen /groups-Antwort im Feld next_page_token empfangen wurde.

HTTP-Methode und URL:

GET https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie den folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer TOKEN" \
     "https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN"

PowerShell (Windows)

Führen Sie diesen Befehl aus:

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "groups": [
    "security-admin@example.com",
    "data-analysts@example.com",
    "looker-developers@example.com"
  ],
  "next_page_token": "AE12aBcDeFgHiJkLmNoPqRsTuVwXyZ"
}

Antwortfelder

Die Antwort umfasst die folgenden Felder:

Feld	Typ	Beschreibung
`groups`	`array of strings`	Die Liste der Unternehmensgruppenkennungen oder E‑Mail-Adressen, zu denen der authentifizierte Nutzer gehört.
`next_page_token`	`string`	Ein Token, das Sie in nachfolgenden Anfragen als `page_token` übergeben können, um die nächste Ergebnisseite abzurufen. Wenn dieses Feld leer ist oder weggelassen wird, gibt es keine nachfolgenden Seiten.

Informationen zu Fehlerantworten, die vom Endpunkt /groups zurückgegeben werden, finden Sie unter Cloud OAuth-Nutzerinformationen und -Gruppenfehler.