> ## 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. # Configuració d'una integració > Prepareu les credencials del proveïdor, connecteu un sistema compatible, activeu-ne els fluxos de dades i verifiqueu la primera sincronització correcta. Aquesta guia descriu el procés de configuració habitual de les integracions que apareixen a **Settings → Integrations → Catalog**. Els camps, els permisos i els passos d'autenticació propis de cada proveïdor provenen de la guia de configuració enllaçada a la targeta d'aquest proveïdor al Catalog. ## Requisits previs | Rol | Responsabilitat | | - | - | | [**Program Owner**](/ca/reference/glossary#responsable-del-programa) | Selecciona l'origen, el connecta a Living Security, activa els fluxos i verifica el resultat | | [**System Administrator**](/ca/reference/glossary#administrador-del-sistema) | Crea o aprova les credencials i els àmbits (scopes) al sistema d'origen | Aquests rols poden recaure en una mateixa persona. La persona que introdueix les credencials a Living Security ha de tenir un rol d'administrador que permeti gestionar integracions; no convideu un administrador del sistema d'origen a Living Security pressuposant que existeix un rol de configuració amb permisos molt limitats. Abans de començar: * Trieu l'organització i l'entorn de Living Security on ha de residir la connexió. * Obriu la guia del proveïdor al Catalog i recopileu-ne els àmbits (scopes) requerits, els URL de redirecció i els requisits de llista d'permesos. * Si les credencials les creen i les introdueixen persones diferents, utilitzeu el procés aprovat de la vostra organització per compartir secrets. * No envieu mai contrasenyes, secrets de client, claus privades ni valors de claus d'accés per correu electrònic ni mitjançant un tiquet de suport. ## 1. Preparació de les credencials del proveïdor Obriu **Settings → Integrations → Catalog**, cerqueu el proveïdor i llegiu-ne la guia de configuració abans de crear les credencials. L'autenticació del proveïdor pot utilitzar el consentiment d'OAuth, un token d'API, un identificador i un secret de client, un compte de servei o un altre mètode compatible amb el proveïdor. Creeu únicament les credencials i els àmbits (scopes) que indiqui la guia del proveïdor. No copieu els permisos d'un altre proveïdor ni concediu un accés d'escriptura ampli «per si de cas». Els permisos que falten solen generar un error 401 o 403 clar que es pot corregir; els permisos excessius generen un risc evitable. ## 2. Connexió del proveïdor Aneu a **Settings → Integrations → Catalog** i seleccioneu el proveïdor. Seleccioneu **Connect**. Completeu el flux d'OAuth o introduïu els camps que sol·licita el diàleg de connexió. La guia del proveïdor explica d'on s'obté cada valor. Aprove la pantalla de consentiment del proveïdor, si escau. Un cop l'autenticació s'ha completat correctament, Living Security obre la nova connexió o la mostra a **Connected**. Si el proveïdor rebutja l'autenticació, atureu-vos i corregiu la credencial, el tenant, la regió, l'URL de redirecció o els permisos del sistema d'origen abans de continuar. ## 3. Activació dels fluxos de dades Obriu la connexió a **Settings → Integrations → Connected**. Living Security detecta les plantilles de sincronització disponibles per a aquest proveïdor i les mostra com a fluxos. 1. Reviseu el nom i la finalitat de cada flux. 2. Activeu només els fluxos que necessiti el vostre programa. 3. Deixeu en pausa els fluxos que no hi estiguin relacionats. 4. Utilitzeu **Sync Now**, si està disponible, per sol·licitar la primera execució. No tots els proveïdors ofereixen els mateixos fluxos ni els mateixos controls de programació. Seguiu els controls que es mostren a la connexió en lloc d'esperar un assistent universal de freqüència, àmbit, assignació de camps, esborrany o activació. ## 4. Verificació de la primera execució L'autenticació de la connexió, per si sola, no demostra que les dades estiguin fluint. Confirmeu que la connexió és saludable i que no sol·licita tornar-se a autoritzar. Confirmeu que el flux requerit està activat i no en pausa. Obriu el flux, l'enllaç de sincronització de la connexió o **Settings** → **Integrations** → **Syncs**. Espereu un resultat final correcte i reviseu els errors del proveïdor i el nombre de registres, si estan disponibles. Obriu l'àrea corresponent de Living Security. Les dades d'identitat han de generar les persones i identitats esperades a Workforce; les dades de les fonts de seguretat han d'aparèixer a la funcionalitat que documenti aquest proveïdor. Durant la incorporació, les tasques **Verify Identity Data Flowing** i **Verify Integration Data Flowing** del Journey Map es completen a partir de les dades ingerides. No substituïu els resultats d'aquestes verificacions per una connexió simplement desada. ## Pàgina de detall de la sincronització A **Settings** → **Integrations** → **Syncs**, obriu qualsevol sincronització per veure'n la configuració i l'historial d'execucions en un sol lloc. La pàgina de detall mostra: | Secció | Què inclou | | - | - | | **Header** | Nom de la sincronització, insígnia d'estat i proveïdor de la integració | | **Statistics** | Model, última sincronització, execucions completades i total de registres | | **Run history** | Execucions recents amb estat, durada i nombre de registres | | **Actions** | **Refresh**, **Pause** / **Resume** i **Sync Now** | Utilitzeu **Sync Now** per iniciar una execució immediata quan la sincronització estigui activa. Les sincronitzacions en pausa s'han de reprendre abans que s'iniciï cap execució programada o manual. També podeu obrir una sincronització des de la pàgina de detall de la connexió quan la integració llisti fluxos actius. ## Operacions de la connexió La pàgina de detall de la connexió ofereix les operacions compatibles amb aquesta integració: | Operació | Efecte | | - | - | | **Sync Now** | Sol·licita una execució immediata del flux seleccionat | | **Pause stream** | Atura les noves execucions d'aquest flux i conserva la connexió | | **Pause connection** | Atura l'activitat compatible de la connexió sense suprimir-ne la configuració | | **Resume** | Reinicia un flux o una connexió en pausa | | **Reauthorize** | Repeteix l'autenticació després d'un canvi de credencials o de consentiment | | **Remove** | Suprimeix la configuració de la connexió després de la confirmació | Eliminar una connexió no equival a suprimir les dades ja ingerides a través d'aquesta. Consulteu la guia del proveïdor o contacteu amb el Support si el comportament de conservació de dades influeix en la vostra decisió. ## Custom Push Sources Utilitzeu **Custom Push Source** quan un sistema envia dades a Living Security en lloc de ser consultat mitjançant un connector del Catalog. 1. Creeu l'origen des de la part inferior del **Catalog**. 2. Obriu-ne la pàgina de detall a l'àrea d'orígens push personalitzats. 3. Seleccioneu el flux de destinació. 4. Utilitzeu **Upload CSV** per a un lot manual o **Push via API** per a un emissor automatitzat. 5. Previsualitzeu el fitxer o la càrrega útil i reviseu l'historial d'execucions de l'origen després de l'enviament. Per al contracte complet d'endpoint, autenticació, càrrega útil, reintents i verificació, consulteu [Custom Push Source API](/ca/integrations/custom-push-source). No deduïu aquests detalls a partir d'una guia antiga d'integració d'Unify. El carregador de detall de l'origen accepta un fitxer CSV d'origen de fins a 100 MB. Abans de la càrrega, el Dashboard el divideix al costat del client en sol·licituds de com a màxim 10 MB i 10.000 files cadascuna. Aquest carregador específic de l'origen és independent de la pàgina general **Integrations → Upload** per a plantilles d'identitat i d'activitat. ## Resolució de problemes | Símptoma | Comproveu | | - | - | | `401 Unauthorized` | El valor de la credencial, la caducitat, la revocació, el tenant del proveïdor i l'estat de reautorització | | `403 Forbidden` | El rol requerit del proveïdor, els àmbits (scopes), el consentiment de l'administrador i la política d'accés del sistema d'origen | | La connexió falla immediatament | L'URL de redirecció, la regió, l'URL d'origen i els requisits de llista d'permesos de xarxa o d'IP | | La connexió és saludable però no hi ha execucions | Que el flux requerit estigui activat i que el proveïdor l'exposi | | Una execució correcta no retorna registres | Que el compte d'origen pugui veure la població esperada i que els filtres del costat del proveïdor siguin correctes | | Les dades apareixen sota una persona incorrecta | Que els atributs d'identitat i els àlies siguin coherents entre les fonts connectades | | Les dades deixen d'actualitzar-se | Que el flux o la connexió estigui en pausa, que les credencials hagin caducat o que l'última execució hagi fallat | Quan contacteu amb el [Living Security Support](mailto:support@livingsecurity.com), inclogueu l'organització, el proveïdor, el nom de la connexió, el flux, l'hora de l'última execució i l'error visible. No inclogueu secrets. ## Contingut relacionat Referència de Connected, Catalog, Syncs, Actions i Upload. Enteneu els atributs i les assignacions compatibles, allà on estiguin disponibles. Gestioneu una integració existent fins a la reautorització o l'eliminació. Completeu les tasques de verificació de dades d'identitat i de seguretat. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.