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 enhttps://YOUR_DOMAIN.freshservice.com/api/v2. El asistente del conector solicita primero las credenciales Basic y luego el dominio.
Cómo funciona
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.
Referencias oficiales: Referencia de la API v2, Dónde encontrar tu clave de API.
Requisitos previos
- Tu dominio (
acmedehttps://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
- Freshservice
- Iru Compliance
Completa esta pestaña antes de conectar la fuente en Compliance.
1
Inicia sesión en Freshservice
Inicia sesión en
https://YOUR_DOMAIN.freshservice.com como el agente con nivel de administrador cuyos permisos debe heredar la integración.2
Abre Profile Settings
Selecciona tu avatar de perfil en la esquina superior derecha y, a continuación, Profile Settings.
3
Copia tu clave de API
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.
4
Ten en cuenta la convención de la contraseña
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.
Solución de problemas
No se abre nada al activar la fuente
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.
401 con unsupported_authentication_type
401 con unsupported_authentication_type
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.
401 sin detalles
401 sin detalles
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.access_denied en algunos endpoints
access_denied en algunos endpoints
El agente que generó la clave no tiene permiso para cambios, activos o problemas. Vuelve a generarla desde un agente con nivel de administrador.
Faltan activos
Faltan activos
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.
El asistente informa de un host inaccesible
El asistente informa de un host inaccesible
Corrige el dominio y vuelve a conectar. El dominio es solo el subdominio, no la URL completa.
Artículos relacionados
Gestión de fuentes
Explora y gestiona todas las fuentes de Compliance.
Freshsales
Conecta Freshsales para obtener evidencia de CRM.
Introducción a Compliance
Marcos, acciones y Artefactos.
Gestión de artefactos
Sube, revisa y organiza la evidencia de fuentes y acciones.