Crear y gestionar usuarios de servicio

Los usuarios de servicio se gestionan en la consola de administración, junto a las personas de tu organización. Esta página te guía paso a paso. No hace falta programar; tus desarrolladores solo necesitarán las credenciales que crees después.

Antes de empezar

Permisos. Necesitas permiso para gestionar usuarios de servicio en tu organización. Si no ves la pestaña Usuarios de servicio, o no puedes crear ni editar usuarios de servicio, pide ayuda a un administrador de tu organización.
Ten claro qué necesita la integración. Averigua qué datos lee o modifica la integración. Lo usarás para elegir el rol con el menor acceso que le permita funcionar.

Encontrar los usuarios de servicio de tu organización

Inicia sesión en la consola de administración.
En la barra lateral, selecciona Usuarios.
Selecciona la pestaña Usuarios de servicio.

La lista muestra cada usuario de servicio con su Rol administrativo, su Estado y su fecha de creación. Puedes buscar por nombre y filtrar por rol o estado. Selecciona una fila para abrir el usuario de servicio.

Crear un usuario de servicio

En la barra lateral, selecciona Usuarios y después Nuevo usuario.
En Tipo de usuario, elige Usuario de servicio.
Introduce un Nombre que identifique la integración, por ejemplo “Sincronización de RR. HH.” o “Servicio de copias de seguridad”. Los nombres deben ser únicos en la organización.
Elige un Rol administrativo (consulta más abajo).
Selecciona Crear usuario de servicio.

El usuario de servicio se crea como Activo, sin credenciales. A continuación, crea una credencial para que la integración pueda autenticarse.

Elegir un rol

Igual que las personas, los usuarios de servicio tienen un rol administrativo que define lo que pueden hacer en la organización. Elige el rol con el menor acceso que cubra lo que hace la integración. Los usuarios de servicio pueden tener cualquier rol excepto Propietario.

Rol	Qué permite	Integración habitual
Auditor	Acceso de solo lectura a la organización, incluidos los registros de auditoría.	Informes, exportaciones de cumplimiento, reaccionar a webhooks
Aprovisionador SCIM	Crear, actualizar y eliminar usuarios y grupos, y gestionar los miembros de los grupos. Nada más.	Plataforma de RR. HH. o directorio que aprovisiona usuarios
Helpdesk	Ver usuarios y grupos, y ocuparse del MFA y las sesiones de los usuarios gestionados.	Herramientas internas de soporte
Facturación	Gestionar la facturación.	Herramientas financieras
Administrador	Gestionar la organización, los usuarios, los grupos, las aplicaciones, la facturación y los registros de auditoría.	Solo cuando no funcione nada más limitado

Para ver exactamente lo que puede hacer cada rol, selecciona Ver las definiciones de roles en el formulario.

Consejo: si tienes varias integraciones, crea un usuario de servicio para cada una. Así, cada una tiene solo el acceso que necesita y puedes desactivar una sin afectar a las demás.

Editar un usuario de servicio

Abre el usuario de servicio desde la pestaña Usuarios de servicio.
Selecciona Editar.
Cambia el nombre, el rol o el estado y selecciona Guardar cambios.

Un nuevo rol se aplica a partir de la siguiente petición del usuario de servicio a la API.

Desactivar o reactivar un usuario de servicio

Para detener una integración de inmediato, desactiva su usuario de servicio:

Abre el usuario de servicio desde la pestaña Usuarios de servicio.
En la pestaña Visión general, selecciona Cambiar estado y elige Inactivo.

Mientras un usuario de servicio está Inactivo:

no puede obtener nuevos tokens de acceso, sea cual sea el estado de sus credenciales;
la API rechaza las peticiones hechas con los tokens que ya tiene, aunque no hayan caducado.

Sus credenciales se conservan. Cuando vuelvas a ponerlo como Activo, la integración podrá autenticarse de nuevo con sus credenciales activas, sin ningún cambio por su parte.

Nota: para detener solo una instalación de una integración, como un entorno de pruebas, desactiva una de sus credenciales en lugar del usuario de servicio completo.

Eliminar un usuario de servicio

Abre el usuario de servicio desde la pestaña Usuarios de servicio.
Selecciona Eliminar.
En el cuadro de diálogo Eliminar usuario de servicio, introduce tu contraseña actual para confirmar.

Importante: eliminar un usuario de servicio no se puede deshacer. Todas sus credenciales dejan de funcionar, y cualquier integración que las use pierde el acceso de inmediato. Si puedes llegar a necesitarlo de nuevo, desactívalo.

Los cambios quedan auditados

La creación, la actualización y la eliminación de usuarios de servicio y de sus credenciales quedan registradas en los Registros de auditoría de tu organización, igual que cada token de acceso que obtiene un usuario de servicio. Las acciones que un usuario de servicio realiza a través de la API se registran con su nombre.