La API de Chrome Management Enrollment Tokens permite a los administradores administrar los tokens de inscripción que se usan para inscribir navegadores Chrome en Chrome Enterprise Core. Este conjunto de APIs se puede usar para crear, recuperar, enumerar y revocar tokens de inscripción para sus dispositivos.
Descripción general rápida de los métodos de la API
Las URLs son relativas a https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Descripción | URL relativa | Método HTTP |
|---|---|---|
| Crea un token de inscripción | /enrollmentTokens | PUBLICAR |
| Recupera un token de inscripción | /enrollmentTokens/{token_permanent_id} | GET |
| Enumera tokens de inscripción | /enrollmentTokens | GET |
| Revoca un token de inscripción | /enrollmentTokens/{token_permanent_id}:revoke | PUBLICAR |
Consulta las muestras de código para ver ejemplos de solicitudes y respuestas.
Filtrando resultados
Cuando enumeras tokens de inscripción con el método /enrollmentTokens, puedes limitar los resultados con el parámetro de consulta filter. Todos los parámetros de filtro deben tener escape de URL cuando se envían en solicitudes HTTP. Se pueden combinar varias condiciones con el operador AND.
- Campos de cadena y de enumeración: Admiten los operadores de comparación
=y:. - Filtrado por unidad organizativa: Puedes filtrar los tokens creados para una unidad organizativa específica si especificas
org_unit_pathoorg_unit_id.
Campos filtrables
| Campo | Descripción |
|---|---|
device_type
|
Es el tipo de dispositivo para el que se usan los tokens de inscripción (actualmente, CHROME_BROWSER). |
token_state
|
Estado del token de inscripción (ACTIVE, EXPIRED, REVOKED). |
org_unit_path
|
Es la ruta de acceso de la unidad organizativa para el token de inscripción (p.ej., /Marketing). |
org_unit_id
|
Es el ID ofuscado de la unidad organizativa para el token de inscripción. |
Privilegios de administrador
La API de Chrome Management Enrollment Tokens respeta la delegación de roles de administrador.
| Método | Se requieren privilegios de administrador |
|---|---|
| CreateEnrollmentToken | "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados" |
| GetEnrollmentToken | "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados" o "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados -> Lectura" |
| ListEnrollmentTokens | "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados" o "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados -> Lectura" |
| RevokeEnrollmentToken | "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados" |
Para administrar los roles y privilegios de administrador, visita "Consola del administrador -> Roles de administrador".
Permisos de la API
La API de Chrome Management Enrollment Tokens requiere los siguientes permisos de OAuth:
| Método | Permisos de OAuth requeridos |
|---|---|
| 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 |
Para obtener más información, consulta la Descripción general de la autenticación.