4 Tokens de API
Resumen
Esta sección permite crear y gestionar tokens de API.
Los tokens de API se utilizan para la autenticación en la API de Zabbix.
A cada token de API se le asigna 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, usuarios a los que están asignados los tokens, fecha de caducidad, usuarios que crearon tokens o 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 varios tokens a la vez seleccionándolos en la lista y haciendo clic en los botones Enable/Disable debajo de la lista.
Para crear un nuevo token, pulse el botón Create API token en la esquina superior derecha y, a continuación, 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, empiece a escribir el nombre de usuario, el nombre o el apellido y, a continuación, seleccione el usuario requerido de la lista de autocompletado. Como alternativa, puede pulsar 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 un token no debe tener fecha de caducidad. |
| Expiry date | Haga clic en el icono del calendario para seleccionar la fecha de caducidad 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. |
Pulse Add para crear un token. En la siguiente pantalla, copie y guarde en un lugar seguro el valor Auth token antes de cerrar la página y, a continuación, pulse Close. El token aparecerá en la lista.
El valor Auth token no se puede 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 caducidad o el estado del token. Tenga en cuenta que no es posible cambiar a qué usuario está asignado el token. Pulse el botón Update para guardar los cambios. Si un token se ha perdido o expuesto, puede pulsar 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, al continuar, el token generado previamente dejará de ser vá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.