Gestión de Usuarios por WebService

Introducción

La API Pública de Flokzu 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 flokzu.docs.apiary.io

API Key para Gestión de Usuarios

Flokzu 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 Flokzu

Supongamos que tu organización tiene un proceso de Onboarding modelado en Flokzu durante el cual se le debe enviar al nuevo integrante, la invitación para crear su cuenta Flokzu.
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://app.flokzu.com/flokzuopenapi/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 Flokzu al correo definido en el campo "Email" del formulario.

Actualizado el: 09/06/2022