Freshservice

Verificaciones automáticasSincronización de accesos

Mesa de ayuda y gestión de servicios de TI. Evidencia la aprobación de cambios y la vigencia de los accesos de los agentes.

• Categoría: Gestión de servicios TI (IT Service Management en el catálogo)
• Verificaciones: 2 (aportan evidencia a tus marcos)
• Sincroniza accesos: sí — quién tiene acceso y con qué rol
• Documentación oficial: Freshservice

Qué evidencia aporta

Cada ejecución de la conexión corre estas 2 verificaciones y deja el resultado como evidencia en tus auditorías, asociado al control que aparece en la última columna.

Verificación	Severidad si falla	Aporta al control
Agentes activos con acceso vigente	Media	A.5.18 Derechos de acceso
Cambios con aprobación registrada	Alta	A.8.32 Gestión del cambio

Los controles corresponden al Anexo A de la norma ISO/IEC 27001:2022. Si trabajas con otro marco, los cruces entre marcos trasladan el resultado a los requisitos equivalentes.

Qué te va a pedir la plataforma

Al crear la conexión completarás estos campos. Las credenciales se guardan cifradas y no vuelven a mostrarse.

Campo	Tipo	¿Obligatorio?
API Key de Freshservice	Secreto	Sí
Dominio (si tu URL es acme.freshservice.com, escribe ‘acme’)	Dato de conexión	Sí

Requisitos y permisos mínimos

Tipo de credencial: API key de un agente de Freshservice con permisos de lectura sobre agentes y cambios.

Permisos: la clave hereda el rol del agente que la genera. Se recomienda un agente con rol de solo lectura (o ‘IT Ops Agent’ sin privilegios de edición).

Qué ocurre si el rol es insuficiente: la API responde 403 en los endpoints restringidos y el check reporta error con la causa.

Límite de tasa: Freshservice aplica cuotas por plan (por minuto); los reintentos con backoff del runtime absorben los 429.

La integración solo lee: nunca crea ni modifica tickets ni cambios.

Configuración paso a paso

Estos pasos se hacen en Freshservice. Cuando termines, vuelve a Preceptix y crea la conexión con los datos obtenidos (ver Conecta tu primera integración).

1. Identifica (o crea) el agente de integración

   Freshservice → Admin → Agents. Preferible un agente dedicado con rol de solo lectura.

2. Copia su API key

   Iniciando sesión con ese agente: icono de perfil → ‘Profile settings’ → sección Your API Key.

3. Identifica el dominio

   Si tu URL es https://acme.freshservice.com, el dominio es ‘acme’.

4. Completa esta pantalla

   • Dominio: del paso 3.
   • API Key: la del paso 2.
   • Dominio (Preceptix): donde aterrizarán las cuentas y la evidencia.

   Pulsa ‘Probar conexión’ antes de guardar.

---

¿Falla la conexión o una verificación queda en rojo? Revisa Estado y cobertura.