Skip to main content

Acerca de HiBob

Iru lee la plantilla de empleados (incluidos el estado, la fecha de inicio y la fecha de baja), los eventos del ciclo de vida, los departamentos y líneas jerárquicas y los campos de metadatos desde la API pública de HiBob. La autenticación usa un usuario de servicio de API creado en Configuración → Integraciones → Service Users. Un usuario de servicio no es un empleado y no puede iniciar sesión en Bob. Solo existe para autenticar las solicitudes a la API.

Cómo funciona

HiBob usa HTTP Basic sobre HTTPS, donde el nombre de usuario es el ID del usuario de servicio y la contraseña es su token. Iru se encarga de la codificación. Pegas los dos valores por separado. Las solicitudes se dirigen a https://api.hibob.com/v1; no hay ningún subdominio que configurar. Los permisos de los usuarios de servicio son granulares y acumulativos: cada categoría de datos se concede por separado mediante un grupo de permisos, y un endpoint no devuelve nada hasta que se concede su categoría. HiBob dejó de admitir los API Access Tokens el 31 de octubre de 2024. Los usuarios de servicio son el único método compatible para las integraciones creadas por los clientes. Referencias oficiales: Usuarios de servicio de API, Crear el encabezado de autorización, Permisos.

Requisitos previos

  • Una cuenta de administrador de Bob, o un administrador que pueda generar las credenciales por ti. Solo los administradores pueden crear usuarios de servicio.
  • Capacidad para crear un grupo de permisos y asignarle el usuario de servicio. No basta con crear el usuario de servicio. Sin un grupo de permisos, la autenticación se realiza correctamente pero no devuelve datos.

Conectar HiBob a Iru

Completa esta pestaña antes de conectar la fuente en Compliance.
1

Inicia sesión en Bob

Inicia sesión en Bob como administrador.
2

Abre Service Users

Ve a Configuración → Integraciones → Service Users.
3

Crea un usuario de servicio

Crea un usuario de servicio nuevo y asígnale un nombre como Iru Compliance para poder identificarlo más adelante.
4

Copia el ID y el token

Copia el ID del usuario de servicio y el token de inmediato. El token se muestra solo una vez. Si lo pierdes, actualiza el token del usuario de servicio y vuelve a conectar.
5

Asigna un grupo de permisos

Crea un grupo de permisos (o edita uno existente) y añade el nuevo usuario de servicio.
6

Concede permisos de lectura

Concede al grupo permisos de lectura para las categorías que necesita tu programa de cumplimiento. People - Read es el mínimo para la evidencia de la plantilla y las bajas. No concedas permisos de escritura ni de eliminación. Concede Payroll - Read solo si un control requiere datos de compensación.
Continúa en la pestaña Iru Compliance.

Solución de problemas

Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
El ID y el token no coinciden o el token se ha actualizado. Genera un token nuevo en HiBob y vuelve a conectar. Confirma que no hayas intercambiado los dos campos. El ID es el nombre de usuario.
El usuario de servicio no está en un grupo de permisos, o el grupo no tiene People - Read. Este es el problema de configuración más común de HiBob, porque la autenticación se completa sin errores en ambos casos.
Dejaron de funcionar el 31 de octubre de 2024. Migra a un usuario de servicio.
Confirma que la recopilación incluya registros inactivos; HiBob los excluye de forma predeterminada en algunos endpoints.

Consideraciones

Los grupos de permisos son obligatorios

No basta con crear el usuario de servicio. Sin un grupo de permisos que incluya People - Read, la autenticación se realiza correctamente pero no devuelve empleados.

Artículos relacionados

Gestión de fuentes

Explora y gestiona todas las fuentes de Compliance.

Introducción a Compliance

Marcos, acciones y Artefactos.

Descripción general de Iru

Cómo encajan Endpoint, Compliance e Identity.

Gestión de artefactos

Sube, revisa y organiza la evidencia de fuentes y acciones.