Tokens de API
Overview
Esta sección permite crear y administrar tokens de API.
Los tokens de API se usan para la autenticación en la API de Zabbix.
Cada token de API se asigna a un único usuario y hereda los permisos de ese usuario.
Las solicitudes autenticadas con un token de API se autorizan según el rol y los permisos del usuario asociado.
Puede filtrar los tokens de API por nombre, por los usuarios a los que se han asignado los tokens, por fecha de expiración, por los usuarios que crearon los tokens o por estado (habilitado/deshabilitado). Haga clic en el estado del token en la lista para habilitar o deshabilitar rápidamente un token. También puede habilitar o deshabilitar tokens en masa seleccionándolos en la lista y haciendo clic en los botones Enable/Disable debajo de la lista.
Para crear un nuevo token, haga clic en el botón Create API token en la esquina superior derecha, y luego complete los campos obligatorios en la pantalla de configuración del token:
| Parameter | Description |
|---|---|
| Name | Nombre visible del token. |
| User | Usuario al que se debe asignar el token. Para seleccionar rápidamente un usuario, comience a escribir el nombre de usuario, el nombre o el apellido, y luego seleccione el usuario requerido de la lista de autocompletado. Como alternativa, puede hacer clic en el botón Select y seleccionar un usuario de la lista completa de usuarios. Un token solo puede asignarse a un usuario. |
| Description | Descripción opcional del token. |
| Set expiration date and time | Desmarque esta casilla si el token no debe tener fecha de expiración. |
| Expiry date | Haga clic en el icono del calendario para seleccionar la fecha de expiración del token o introduzca la fecha manualmente en el formato YYYY-MM-DD hh:mm:ss |
| Enabled | Desmarque esta casilla si necesita crear un token en estado deshabilitado. |
Haga clic en Add para crear un token.
Copie el valor de Auth token y guárdelo en un lugar seguro antes de cerrar la página, y luego haga clic en Close. El token aparecerá en la lista.
El valor de Auth token no se podrá volver a ver más adelante. Solo está disponible inmediatamente después de crear un token. Si pierde un token guardado, tendrá que regenerarlo, y al hacerlo se creará una nueva cadena de autorización.
Haga clic en el nombre del token para editar el nombre, la descripción, la configuración de la fecha de expiración o el estado del token. Tenga en cuenta que no es posible cambiar a qué usuario está asignado el token. Haga clic en el botón Update para guardar los cambios. Si un token se ha perdido o expuesto, puede hacer clic en el botón Regenerate para generar un nuevo valor de token. Aparecerá un cuadro de diálogo de confirmación que le pedirá que confirme esta operación, ya que después de continuar el token generado previamente quedará inválido.
Los usuarios sin acceso a la sección del menú Administration solo pueden ver y modificar los detalles de los tokens asignados a ellos en la sección User profile > API tokens section si Manage API tokens está permitido en los permisos de su user role.