L'API Chrome Management Enrollment Tokens consente agli amministratori di gestire i token di registrazione utilizzati per registrare i browser Chrome in Chrome Enterprise Core. Questo insieme di API può essere utilizzato per creare, recuperare, elencare e revocare i token di registrazione per i dispositivi.
Panoramica rapida dei metodi API
Gli URL sono relativi a
https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Descrizione | URL relativo | Metodo HTTP |
|---|---|---|
| Creare un token di registrazione | /enrollmentTokens | PUBBLICA |
| Recuperare un token di registrazione | /enrollmentTokens/{token_permanent_id} | GET |
| Elenca i token di registrazione | /enrollmentTokens | GET |
| Revocare un token di registrazione | /enrollmentTokens/{token_permanent_id}:revoke | PUBBLICA |
Consulta gli esempi di codice per richieste e risposte di esempio.
Filtro dei risultati in corso…
Quando elenchi i token di registrazione con il metodo
/enrollmentTokens, puoi restringere i risultati utilizzando il parametro di query filter. Tutti
i parametri di filtro devono essere codificati come URL quando vengono inviati nelle richieste HTTP. È possibile combinare più condizioni utilizzando l'operatore AND.
- Campi stringa ed enum: supportano gli operatori di confronto
=e:. - Filtro unità organizzativa:puoi filtrare i token creati per un'unità organizzativa specifica specificando
org_unit_pathoorg_unit_id.
Campi filtrabili
| Campo | Descrizione |
|---|---|
device_type
|
Il tipo di dispositivo per cui vengono utilizzati i token di registrazione
(attualmente CHROME_BROWSER). |
token_state
|
Lo stato del token di registrazione (ACTIVE, EXPIRED,
REVOKED). |
org_unit_path
|
Il percorso dell'unità organizzativa per il token di registrazione
(ad es. /Marketing). |
org_unit_id
|
L'ID offuscato dell'unità organizzativa per il token di registrazione. |
Privilegi amministrativi
L'API Chrome Management Enrollment Tokens rispetta la delega del ruolo di amministratore.
| Metodo | Privilegi amministrativi richiesti |
|---|---|
| CreateEnrollmentToken | "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti" |
| GetEnrollmentToken | "Servizi -> Gestione di Chrome -> Impostazioni ->
Browser gestiti" o "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti -> Leggi" |
| ListEnrollmentTokens | "Servizi -> Gestione di Chrome -> Impostazioni ->
Browser gestiti" o "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti -> Leggi" |
| RevokeEnrollmentToken | "Servizi -> Gestione di Chrome -> Impostazioni -> Browser gestiti" |
Per gestire i ruoli e i privilegi di amministratore, vai a "Console di amministrazione -> Ruoli amministratore".
Ambiti API
L'API Chrome Management Enrollment Tokens richiede i seguenti ambiti OAuth:
| Metodo | Ambiti OAuth richiesti |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens o https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens o https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
Per saperne di più, consulta la Panoramica dell'autenticazione.