Gestión de Usuarios por WebService
Introducción
La API pública de INTEGRADOC contiene un conjunto de operaciones que resultan útiles para la gestión de los usuarios de la organización. A través de la invocación de webservices podrás crear o eliminar perfiles así como también gestionar sus roles.
Esto permite la administración desde sistemas externos, siendo particularmente útil para aquellas organizaciones que deban actualizar el perfil de sus usuarios en múltiples sistemas al mismo tiempo.
Operaciones disponibles
Enviar invitación a un nuevo usuario (Send user invitation)
Eliminar cuenta de usuario (Delete user account)
Agregar rol a un usuario existente (Add user role)
Eliminar rol a un usuario (Remove user role)
Listar los roles de un usuario (Get user roles)
La documentación de cada servicio la puedes encontrar en este link
API Key para Gestión de Usuarios
INTEGRADOC maneja de forma diferenciada los servicios que permite el acceso a los datos de las instancias y bases de datos, de los servicios de Gestión de Usuarios, y cada uno de ellos tiene un token de seguridad (API-Key) independiente.
De esta manera los administradores pueden generar y compartir una API-Key de Usuarios que no permitirá el acceso a los datos de los procesos.
Para configurarla ve al post ¿Qué es y cómo crear una API Key?
Invitar usuarios desde un proceso INTEGRADOC
Supongamos que tu organización tiene un proceso de Onboarding modelado en INTEGRADOC, durante el cual se le debe enviar al nuevo integrante, la invitación para crear su cuenta.
Esto es posible configurando los servicios de la API de usuarios en una Tarea de Servicio:
Crear un nuevo proceso o editar uno ya existente
En el formulario del proceso agregar un campo Email en donde se incluirá el correo del nuevo usuario a invitar
Añadir al Flujo de Trabajo (Workflow) la integración que permite los llamados a los servicios Rest:
Configurar el servicio Rest con los siguientes datos
URL:https://your-integradoc-server/integradocopenapi/api/v1/management/user/invitation
Método: POST
Datos de entrada
Nombre del parámetro: email , Valor: elegir el campo del formulario Email
Encabezados HTTP
X-Api-Key - API-Key para la Gestión de Usuarios
X-Username - Tu correo electrónico
Content-Type - application/json
Guardar los cambios y publica el proceso
De esta forma, cada vez que una instancia del proceso pase por la tarea de servicio, automáticamente se enviará una invitación a INTEGRADOC al correo definido en el campo "Email" del formulario.
De manera similar puedes configurar otros servicios de la API de Usuarios: Eliminar usuario, agregar rol, quitar rol, etc..
Actualizado el: 17/05/2022
¡Gracias!