Artículos sobre: Usuarios y roles

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:



Llamado al servicio API en el WorkFlow


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

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!