Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Recuperare i gruppi aziendali con l'API Cloud OAuth

Questa guida descrive come recuperare le iscrizioni ai gruppi aziendali per gli utenti della forza lavoro autenticati utilizzando l'endpoint /groups nell'API Cloud OAuth (cloudoauth.googleapis.com).

L'endpoint /groups funge da endpoint di rivendicazioni distribuite per le integrazioni OpenID Connect (OIDC), restituendo le iscrizioni ai gruppi aziendali impaginati per gli utenti nei pool di identità della forza lavoro abilitati e non abilitati per SCIM.

Prima di iniziare

Configura un pool di identità della forza lavoro e un provider. Per saperne di più, consulta Configura la federazione delle identità per la forza lavoro.
Registra un client OAuth e scambia un codice di autorizzazione con un token di accesso. Per saperne di più, consulta Scambia i token con l'API Cloud OAuth.
Abilita l'API Cloud OAuth, se non è già abilitata.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.
Abilitare l'API

Recupera i gruppi aziendali

Per recuperare le iscrizioni ai gruppi per l'utente autenticato, invia una richiesta HTTP GET all'endpoint /groups:

Il metodo common.groups dell'API Cloud OAuth recupera le iscrizioni ai gruppi aziendali per l'utente autenticato.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

TOKEN: il token di accesso OAuth 2.0 di breve durata ottenuto dall'endpoint di scambio di token.
PAGE_SIZE: (Facoltativo) Il numero massimo di gruppi da restituire per pagina (tra 2500 e 5000).
PAGE_TOKEN: (Facoltativo) Un token di paginazione ricevuto da una risposta /groups precedente nel campo next_page_token.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo comando:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Campi di risposta

La risposta contiene i seguenti campi:

Campo	Tipo	Descrizione
`groups`	`array of strings`	L'elenco degli identificatori o degli indirizzi email dei gruppi aziendali a cui appartiene l'utente autenticato.
`next_page_token`	`string`	Un token che puoi passare come `page_token` nelle richieste successive per recuperare la pagina successiva dei risultati. Se questo campo è vuoto o viene omesso, non verranno visualizzate altre pagine.

Per informazioni sulle risposte di errore restituite dall'endpoint /groups, consulta Errori relativi alle informazioni utente e ai gruppi di Cloud OAuth.