> ## 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.
# Freshservice
> Conecta Freshservice a Iru Compliance mediante HTTP Basic Auth con tu clave de API como nombre de usuario para recopilar aprobaciones de cambios, tiempos de resolución de incidentes, registros de tickets e inventario de activos de la CMDB.
### Acerca de Freshservice
Iru lee **tickets**, **cambios** (con estado de aprobación y fechas de implementación), **incidentes**, **problemas**, **activos de la CMDB** y **agentes con sus roles** desde la API v2 de Freshservice. La autenticación usa tu **clave de API**, que se encuentra en **Profile Settings**. Las solicitudes se dirigen al dominio de tu cuenta en `https://YOUR_DOMAIN.freshservice.com/api/v2`. El asistente del conector solicita primero las **credenciales Basic** y luego el **dominio**.
### Cómo funciona
```http theme={null}
Authorization: Basic BASE64("YOUR_API_KEY:X")
```
Freshservice usa **HTTP Basic** sobre HTTPS: el **nombre de usuario** es tu **clave de API** y la **contraseña** es cualquier cadena no vacía, por convención el literal `X`. Iru se encarga de la codificación. La autenticación Basic con nombre de usuario y contraseña **quedó obsoleta el 31 de mayo de 2023** y ahora falla, por lo que la clave de API es el único método compatible.
Una clave de API tiene **exactamente los permisos del agente que la generó** y no hay ámbitos por endpoint. Una clave de un agente con permisos limitados devuelve una vista parcial de tickets y cambios. Usa una cuenta de servicio dedicada con nivel de administrador para que la evidencia sea completa.
| Detalle | Valor |
| - | - |
| **Categoría** | Soporte |
| **Autenticación** | Basic (clave de API + `X`) |
Referencias oficiales: [Referencia de la API v2](https://api.freshservice.com/v2/), [Dónde encontrar tu clave de API](https://support.freshservice.com/support/solutions/articles/50000000306-where-do-i-find-my-api-key-).
### Requisitos previos
* Tu **dominio** (`acme` de `https://acme.freshservice.com`).
* Una **cuenta de agente con nivel de administrador** desde la que generar la clave. Una cuenta de agente personal vincula la recopilación de evidencia a los permisos de una sola persona y deja de funcionar cuando esa persona sale de la organización.
* Decide qué entra en el alcance. Freshservice te permite excluir tipos de tickets, omitir el inventario de activos o filtrar por departamento. Cuando se excluyen los datos subyacentes, Iru marca los controles afectados como imposibles de verificar.
### Conectar Freshservice a Iru
Completa esta pestaña antes de conectar la fuente en Compliance.
Inicia sesión en `https://YOUR_DOMAIN.freshservice.com` como el **agente con nivel de administrador** cuyos permisos debe heredar la integración.
Selecciona tu **avatar de perfil** en la esquina superior derecha y, a continuación, **Profile Settings**.
Localiza **Your API Key** en esa página y cópiala. Freshservice muestra la clave en la página de perfil en lugar de generar una nueva cada vez, por lo que puedes volver a consultarla más tarde.
La **contraseña** para la autenticación Basic es el literal `X`. Introdúcela en Iru, no en Freshservice.
Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
Primero completa la pestaña [**Freshservice**](#freshservice).
En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.
Busca **Freshservice** (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.
El primer paso del asistente es **Enter Basic Authentication**. Introduce **Nombre de usuario** = tu **clave de API** y **Contraseña** = `X` (literal). Freshservice no valida el campo de contraseña. Cualquier valor de marcador de posición no vacío funciona.
Selecciona **Enviar credenciales**.
Introduce solo el **dominio** (por ejemplo, `acme`, no la URL completa). Confirma la URL de vista previa si el asistente muestra una. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Freshservice** está **Activo**.
### Solución de problemas
Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
Se usaron una dirección de correo electrónico y una contraseña en lugar de la clave de API. Ese método se eliminó el 31 de mayo de 2023. Usa la clave como **nombre de usuario**.
Pega la clave de API completa y confirma que el campo de **contraseña** contenga un valor no vacío, como `X`. Una contraseña vacía falla.
El agente que generó la clave no tiene permiso para cambios, activos o problemas. Vuelve a generarla desde un agente con nivel de administrador.
O bien la CMDB está fuera del alcance de esta conexión, o bien el agente no puede leer los activos. Iru no puede distinguir entre estos casos.
Corrige el **dominio** y vuelve a conectar. El dominio es solo el subdominio, no la URL completa.
### Artículos relacionados
Explora y gestiona todas las fuentes de Compliance.
Conecta Freshsales para obtener evidencia de CRM.
Marcos, acciones y **Artefactos**.
Sube, revisa y organiza la evidencia de fuentes y acciones.