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

# Configurar una integración

> Prepare las credenciales del proveedor, conecte un sistema compatible, habilite sus flujos de datos y verifique la primera sincronización correcta.

Esta guía describe el procedimiento de configuración común para las integraciones que aparecen en **Configuración → Integraciones → Catálogo**. Los campos, los permisos y los pasos de autenticación específicos de cada proveedor provienen de la guía de configuración enlazada en la tarjeta del Catálogo de dicho proveedor.

## Requisitos previos

| Rol | Responsabilidad |
| - | - |
| [**Propietario del programa**](/es/reference/glossary#responsable-del-programa) | Selecciona el origen, lo conecta en Living Security, habilita los flujos y verifica el resultado |
| [**Administrador del sistema**](/es/reference/glossary#administrador-del-sistema) | Crea o aprueba las credenciales y los ámbitos en el sistema de origen |

Ambos roles pueden recaer en la misma persona. La persona que introduzca las credenciales en Living Security debe tener un rol de administrador que permita gestionar integraciones; no invite a un administrador del sistema de origen a Living Security basándose únicamente en la suposición de que existe un rol de configuración de alcance limitado.

Antes de comenzar:

* Elija la organización y el entorno de Living Security a los que pertenece la conexión.
* Abra la guía del proveedor en el Catálogo y recopile los ámbitos requeridos, las URL de redirección y los requisitos de lista de permitidos.
* Utilice el proceso aprobado por su organización para compartir secretos si las credenciales las crean y las introducen personas distintas.
* Nunca envíe contraseñas, secretos de cliente, claves privadas ni valores de claves de acceso por correo electrónico ni en un ticket de soporte.

## 1. Preparar las credenciales del proveedor

Abra **Configuración → Integraciones → Catálogo**, busque el proveedor y lea su guía de configuración antes de crear las credenciales.

La autenticación del proveedor puede utilizar consentimiento OAuth, un token de API, un ID de cliente y un secreto, una cuenta de servicio u otro método compatible con el proveedor. Cree únicamente las credenciales y los ámbitos que indique la guía de ese proveedor.

<Warning>
  No copie permisos de otro proveedor ni conceda acceso amplio de escritura
  «por si acaso». La falta de permisos suele producir un error 401 o 403
  claro que se puede corregir; los permisos excesivos generan un riesgo evitable.
</Warning>

## 2. Conectar el proveedor

<Steps>
  <Step title="Abra el Catálogo">
    Vaya a **Configuración → Integraciones → Catálogo** y seleccione el proveedor.
  </Step>

  <Step title="Inicie la conexión">
    Seleccione **Conectar**. Complete el flujo de OAuth o introduzca los campos
    que solicita el cuadro de diálogo de conexión. La guía del proveedor explica
    de dónde procede cada valor.
  </Step>

  <Step title="Finalice la autenticación">
    Apruebe la pantalla de consentimiento del proveedor cuando corresponda. Una vez que la autenticación se complete correctamente, Living Security abre o muestra la nueva conexión en **conectado**.
  </Step>
</Steps>

Si el proveedor rechaza la autenticación, deténgase y corrija la credencial, el inquilino, la región, la URL de redirección o los permisos del sistema de origen antes de continuar.

## 3. Habilitar los flujos de datos

Abra la conexión en **Configuración → Integraciones → conectado**. Living Security detecta las plantillas de sincronización disponibles para ese proveedor y las muestra como flujos.

1. Revise el nombre y la finalidad de cada flujo.
2. Habilite únicamente los flujos que necesite su programa.
3. Deje en pausa los flujos que no estén relacionados.
4. Utilice **Sincronizar ahora**, cuando esté disponible, para solicitar la primera ejecución.

No todos los proveedores ofrecen los mismos flujos ni los mismos controles de programación. Siga los controles que se muestran en la conexión en lugar de esperar un asistente universal de frecuencia, ámbito, asignación de campos, borrador o activación.

## 4. Verificar la primera ejecución

La autenticación de la conexión por sí sola no demuestra que los datos estén fluyendo.

<Steps>
  <Step title="Compruebe el estado de la conexión">
    Confirme que la conexión está en buen estado y que no solicita una nueva autorización.
  </Step>

  <Step title="Compruebe el estado del flujo">
    Confirme que el flujo necesario está habilitado y no en pausa.
  </Step>

  <Step title="Inspeccione la última ejecución">
    Abra el flujo, el enlace de sincronización de la conexión o **Configuración** → **Integraciones** → **Sincronizaciones**. Espere a que se obtenga un resultado final correcto y revise los errores del proveedor y el número de registros cuando estén disponibles.
  </Step>

  <Step title="Confirme los datos posteriores">
    Abra la sección correspondiente de Living Security. Los datos de identidad deben generar las personas e identidades esperadas en Fuerza laboral; los datos de origen de seguridad deben aparecer en la funcionalidad documentada por ese proveedor.
  </Step>
</Steps>

Para la incorporación, las tareas **Verificar flujo de datos de identidad** y **Verificar flujo de datos de integración** del Mapa de recorrido se completan a partir de los datos ingeridos. No sustituya los resultados de esas verificaciones por una conexión guardada.

## Página de detalle de la sincronización

Desde **Configuración** → **Integraciones** → **Sincronizaciones**, abra cualquier sincronización para ver su configuración y su historial de ejecuciones en un solo lugar.

La página de detalle muestra:

| Sección | Qué incluye |
| - | - |
| **Encabezado** | Nombre de la sincronización, indicador de estado y proveedor de la integración |
| **Estadísticas** | Modelo, última sincronización, ejecuciones completadas y total de registros |
| **Historial de ejecuciones** | Ejecuciones recientes con estado, duración y número de registros |
| **Acciones** | **Actualizar**, **Pausa** / **Currículum** y **Sincronizar ahora** |

Utilice **Sincronizar ahora** para activar una ejecución inmediata cuando la sincronización esté activa. Las sincronizaciones en pausa deben reanudarse antes de que se inicien nuevas ejecuciones programadas o manuales.

También puede abrir una sincronización desde la página de detalle de su conexión cuando la integración muestra flujos activos.

## Operaciones de conexión

La página de detalle de la conexión expone las operaciones que admite esa integración:

| Operación | Efecto |
| - | - |
| **Sincronizar ahora** | Solicita una ejecución inmediata del flujo seleccionado |
| **Pausar flujo** | Detiene las nuevas ejecuciones de ese flujo y conserva la conexión |
| **Pausar conexión** | Detiene la actividad compatible de la conexión sin eliminar la configuración |
| **Currículum** | Reinicia un flujo o una conexión en pausa |
| **Volver a autorizar** | Repite la autenticación tras un cambio de credenciales o de consentimiento |
| **Eliminar** | Elimina la configuración de la conexión tras la confirmación |

Eliminar una conexión no equivale a eliminar los datos ya ingeridos desde ella. Consulte la guía del proveedor o póngase en contacto con Soporte si el comportamiento de retención de datos influye en su decisión.

## Fuentes push personalizadas

Utilice **Fuente push personalizada** cuando un sistema envíe datos a Living Security en lugar de ser consultado mediante un conector del Catálogo.

1. Cree la fuente desde la parte inferior del **Catálogo**.
2. Abra su página de detalle en el área de fuentes push personalizadas.
3. Seleccione el flujo de destino.
4. Utilice **Subir CSV** para un lote manual o **Enviar mediante API** para un emisor automatizado.
5. Obtenga una vista previa del archivo o de la carga útil y revise el historial de ejecuciones de la fuente después del envío.

Para conocer el contrato completo de punto de conexión, autenticación, carga útil, reintentos y verificación, consulte [API de fuente push personalizada](/es/integrations/custom-push-source). No deduzca esos detalles a partir de una guía antigua de integración de Unify.

El cargador del detalle de la fuente acepta un archivo CSV de origen de hasta 100 MB. Antes de la carga, el Panel de control lo divide en el cliente en solicitudes de no más de 10 MB y 10,000 filas cada una. Este cargador específico de la fuente es independiente de la página general **Integraciones → Subir** para plantillas de identidad y actividad.

## Solución de problemas

| Síntoma | Qué comprobar |
| - | - |
| `401 Unauthorized` | Valor de la credencial, caducidad, revocación, inquilino del proveedor y estado de reautorización |
| `403 Forbidden` | Rol requerido del proveedor, ámbitos, consentimiento del administrador y política de acceso del sistema de origen |
| La conexión falla de inmediato | URL de redirección, región, URL de origen y requisitos de lista de permitidos de red o IP |
| La conexión está en buen estado, pero no se producen ejecuciones | El flujo necesario está habilitado y el proveedor lo expone |
| Una ejecución correcta no devuelve registros | La cuenta de origen puede ver la población esperada y los filtros del lado del proveedor son correctos |
| Los datos aparecen bajo la persona equivocada | Los atributos de identidad y los alias son coherentes en todos los orígenes conectados |
| Los datos dejan de actualizarse | El flujo o la conexión está en pausa, las credenciales caducaron o la última ejecución falló |

Al ponerse en contacto con [Soporte de Living Security](mailto:support@livingsecurity.com), incluya la organización, el proveedor, el nombre de la conexión, el flujo, la hora de la última ejecución y el error visible. No incluya secretos.

## Temas relacionados

<CardGroup cols={2}>
  <Card title="Descripción general de Integraciones" icon="grid-2" href="/es/integrations/overview">
    Referencia de conectado, Catálogo, Sincronizaciones, Acciones y Subir.
  </Card>

  <Card title="Asignación de datos" icon="arrows-left-right" href="/es/integrations/managing/data-mapping">
    Conozca los atributos y las asignaciones compatibles, cuando estén disponibles.
  </Card>

  <Card title="Ciclo de vida de la integración" icon="route" href="/es/integrations/managing/lifecycle">
    Gestione una integración existente, desde la reautorización hasta su eliminación.
  </Card>

  <Card title="Incorporación de administradores" icon="circle-check" href="/es/getting-started/onboarding">
    Complete las tareas de verificación de datos de identidad y de seguridad.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.