L'API Chrome Management Enrollment Tokens permet aux administrateurs de gérer les jetons d'enregistrement utilisés pour enregistrer les navigateurs Chrome dans Chrome Enterprise Core. Cet ensemble d'API peut être utilisé pour créer, récupérer, lister et révoquer les jetons d'enregistrement de leurs appareils.
Présentation rapide des méthodes d'API
Les URL sont relatives à
https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Description | URL relative | Méthode HTTP |
|---|---|---|
| Créer un jeton d'enregistrement | /enrollmentTokens | POST |
| Récupérer un jeton d'enregistrement | /enrollmentTokens/{token_permanent_id} | GET |
| Lister les jetons d'enregistrement | /enrollmentTokens | GET |
| Révoquer un jeton d'enregistrement | /enrollmentTokens/{token_permanent_id}:revoke | POST |
Consultez les exemples de code pour obtenir des exemples de requêtes et de réponses.
Filtrage des résultats…
Lorsque vous répertoriez des jetons d'inscription avec la méthode /enrollmentTokens, vous pouvez affiner les résultats à l'aide du paramètre de requête filter. Tous les paramètres de filtre doivent être échappés au format URL lorsqu'ils sont envoyés dans des requêtes HTTP. Vous pouvez combiner plusieurs conditions à l'aide de l'opérateur AND.
- Champs de type "String" et "Enum" : ils acceptent les opérateurs de comparaison
=et:. - Filtrage par unité organisationnelle : vous pouvez filtrer les jetons créés pour une unité organisationnelle spécifique en spécifiant
org_unit_pathouorg_unit_id.
Champs acceptant le filtrage
| Champ | Description |
|---|---|
device_type
|
Type d'appareil pour lequel les jetons d'enregistrement sont utilisés (actuellement CHROME_BROWSER). |
token_state
|
État du jeton d'enregistrement (ACTIVE, EXPIRED, REVOKED). |
org_unit_path
|
Chemin d'accès à l'unité organisationnelle pour le jeton d'inscription (par exemple, /Marketing). |
org_unit_id
|
ID obscurci de l'unité organisationnelle pour le jeton d'enregistrement. |
Droits d'administrateur
L'API Chrome Management Enrollment Tokens respecte la délégation des rôles d'administrateur.
| Méthode | Droits d'administrateur requis |
|---|---|
| CreateEnrollmentToken | "Services > Gestion de Chrome > Paramètres > Navigateurs gérés" |
| GetEnrollmentToken | "Services > Gestion de Chrome > Paramètres >
Navigateurs gérés" ou "Services > Gestion de Chrome > Paramètres > Navigateurs gérés > Lire" |
| ListEnrollmentTokens | "Services > Gestion de Chrome > Paramètres >
Navigateurs gérés" ou "Services > Gestion de Chrome > Paramètres > Navigateurs gérés > Lire" |
| RevokeEnrollmentToken | "Services > Gestion de Chrome > Paramètres > Navigateurs gérés" |
Pour gérer les rôles et droits d'administrateur, accédez à "Console d'administration > Rôles d'administrateur".
Champs d'application de l'API
L'API Chrome Management Enrollment Tokens requiert les niveaux d'accès OAuth suivants :
| Méthode | Champs d'application OAuth requis |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens ou https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens ou https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
Pour en savoir plus, consultez la présentation de l'authentification.