Integración de Plataformas Externas con la Administración de Usuarios en AUTOMY

Centro de Conocimiento — Conexiones

Por Carlos J Quintero · 2025-04-05

A medida que las organizaciones adoptan arquitecturas más complejas, la gestión centralizada de identidades se vuelve crítica tanto para la eficiencia operativa como para la seguridad.

AUTOMY ofrece una API robusta y flexible que permite a los clientes sincronizar sus sistemas de gestión de usuarios —como plataformas de recursos humanos, Active Directory o bases de datos personalizadas— con el motor de usuarios de AUTOMY en tiempo real.

Este artículo explica cómo automatizar completamente la administración de usuarios en AUTOMY: desde la creación y modificación hasta la desactivación, asignación de roles, grupos y entornos, todo a través de nuestra API. 🧩 Caso de uso: ¿Por qué integrar? Imagina este escenario común: Tu empresa utiliza un sistema interno de RRHH (como Workday, SAP o una base de datos propia).

Cuando un nuevo colaborador ingresa, necesitas: Crear automáticamente su perfil en AUTOMY.

Asignarle su cargo, jefe, rol y área correspondiente.

Agregarlo a los grupos de usuario y entornos correctos.

Gestionar su nivel de acceso sin intervención manual.

Del mismo modo, si el colaborador cambia de rol o deja la organización, deseas que esos cambios se reflejen de inmediato en AUTOMY. 🚀 Paso 1: Autenticación AUTOMY soporta múltiples métodos de autenticación: 🔑 Autenticación Básica http POST /auth Encabezados : clientId: {{tu_client_id}} clientSecret: {{tu_client_secret}} Autenticación básica (Basic Auth) : Usuario: tu usuario API Contraseña: tu contraseña API Respuesta : json { "accessToken": "tu-token-jwt", "refreshToken": "tu-refresh-token" } Guarda estos tokens para usarlos en futuras solicitudes. 🏢 Autenticación con Azure Active Directory http POST /auth/ad Basic Auth : Usuario: ad Contraseña: Token de Azure AD Ideal si ya utilizas Microsoft Entra ID para gestionar el acceso de usuarios. 👥 Paso 2: Crear un Usuario http POST /user Ejemplo de cuerpo : json { "email": "juan.perez@tuempresa.com", "names": "Juan", "lastNames": "Pérez", "fullName": "Juan Pérez", "role": "RoleUser", "positionId": "uuid-del-cargo", "userBossId": "uuid-del-jefe", "accessType": 2, "isActive": true } 💡 Puedes obtener los cargos disponibles y jefes mediante los endpoints /position/paged y /user/paged, respectivamente. 🔄 Paso 3: Actualizar un Usuario Actualización Completa http PUT /user Envía el objeto completo del usuario, incluyendo el campo id.

Actualización Parcial http PATCH /user/{userId} Ejemplo : json { "fullName": "Juan A.

Pérez", "role": "RoleAdmin" } ⛔ Paso 4: Desactivar o Eliminar Usuarios Para desactivar un usuario (recomendado para bajas laborales): http POST /user/activate/{userId}/false Para eliminarlo permanentemente: http DELETE /user/{userId} 🔍 Paso 5: Consultar Información de Usuarios Obtener Usuario por ID http GET /user/{userId}?$expand=position($select=name),area($select=name),userGroups($select=name) Buscar Usuarios http GET /user/paged?$filter=contains(fullName,'juan') 🧱 Paso 6: Asignar Grupos y Entornos Los grupos y entornos permiten controlar el acceso de forma modular y escalable.

Actualizar Grupos http POST /user/updateGroups/{userId} Ejemplo : json [ { "id": "uuid-grupo-1" }, { "id": "uuid-grupo-2" } ] Actualizar Entornos http POST /user/updateEnvironments/{userId} Ejemplo : json [ { "id": "uuid-entorno-1" }, { "id": "uuid-entorno-2" } ] 🔧 Bonus: Automatización por Cron Jobs o Webhooks Una vez integrada, tu plataforma puede: Llamar a la API de AUTOMY cada vez que se cree, edite o elimine un usuario.

Ejecutar sincronizaciones nocturnas con todo tu directorio de empleados.