> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HiBob

> Conecta HiBob a Iru Compliance mediante HTTP Basic Auth con un ID y un token de usuario de servicio para recopilar evidencia de la plantilla de empleados, los eventos del ciclo de vida y la estructura organizativa.

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

```http theme={null}
Authorization: Basic BASE64("SERVICE-USER-ID:TOKEN")
```

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.

| Detalle | Valor |
| - | - |
| **Categoría** | HRIS |
| **Autenticación** | Basic (ID de usuario de servicio + token) |

Referencias oficiales: [Usuarios de servicio de API](https://apidocs.hibob.com/docs/api-service-users), [Crear el encabezado de autorización](https://apidocs.hibob.com/reference/authorization), [Permisos](https://apidocs.hibob.com/reference/permissions).

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

<Tabs>
  <Tab title="HiBob">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Inicia sesión en Bob">
        Inicia sesión en Bob como **administrador**.
      </Step>

      <Step title="Abre Service Users">
        Ve a **Configuración** → **Integraciones** → **Service Users**.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="Asigna un grupo de permisos">
        Crea un **grupo de permisos** (o edita uno existente) y añade el nuevo usuario de servicio.
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**HiBob**](#hibob).
    </Note>

    <Steps>
      <Step title="Abre Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activa HiBob">
        Busca **HiBob** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Introduce la autenticación Basic">
        Introduce **Nombre de usuario** = el **ID del usuario de servicio** y **Contraseña** = el **token del usuario de servicio**.
      </Step>

      <Step title="Finaliza la conexión">
        Selecciona **Enviar credenciales**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **HiBob** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="La autenticación falla con tokenNotMatch">
    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.
  </Accordion>

  <Accordion title="La conexión se realiza correctamente pero no se devuelven empleados">
    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.
  </Accordion>

  <Accordion title="Estás usando un API Access Token antiguo">
    Dejaron de funcionar el **31 de octubre de 2024**. Migra a un usuario de servicio.
  </Accordion>

  <Accordion title="Faltan empleados dados de baja">
    Confirma que la recopilación incluya registros inactivos; HiBob los excluye de forma predeterminada en algunos endpoints.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Los grupos de permisos son obligatorios" icon="circle-info">
    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.
  </Card>
</CardGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Gestión de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y gestiona todas las fuentes de Compliance.
  </Card>

  <Card title="Introducción a Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Sube, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>
