> ## 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 uma integração > Prepare as credenciais do provedor, conecte um sistema compatível, ative seus fluxos de dados e verifique a primeira sincronização bem-sucedida. Este guia descreve o caminho de configuração comum para as integrações listadas em **Configurações → Integrações → Catálogo**. Os campos, as permissões e as etapas de autenticação específicos de cada provedor constam no guia de configuração vinculado ao card desse provedor no Catálogo. ## Pré-requisitos | Função | Responsabilidade | | - | - | | [**Proprietário do Programa**](/pt/reference/glossary#respons%C3%A1vel-pelo-programa) | Seleciona a origem, a conecta na Living Security, ativa os fluxos e verifica o resultado | | [**Administrador do Sistema**](/pt/reference/glossary#administrador-do-sistema) | Cria ou aprova credenciais e escopos no sistema de origem | Essas funções podem ser exercidas pela mesma pessoa. A pessoa que insere as credenciais na Living Security deve ter uma função de administrador que permita o gerenciamento de integrações; não convide um administrador do sistema de origem para a Living Security apenas presumindo que exista uma função de configuração com escopo restrito. Antes de começar: * Escolha a organização e o ambiente da Living Security aos quais a conexão pertence. * Abra o guia do provedor no Catálogo e reúna os escopos obrigatórios, as URLs de redirecionamento e os requisitos de lista de permissões. * Use o processo de compartilhamento de segredos aprovado pela sua organização se pessoas diferentes criarem e inserirem as credenciais. * Nunca envie senhas, segredos de cliente, chaves privadas ou valores de chaves de acesso por e-mail ou chamado de suporte. ## 1. Preparar as credenciais do provedor Abra **Configurações → Integrações → Catálogo**, localize o provedor e leia o guia de configuração dele antes de criar as credenciais. A autenticação do provedor pode usar consentimento OAuth, um token de API, um ID de cliente e segredo, uma conta de serviço ou outro método compatível com o provedor. Crie somente as credenciais e os escopos indicados no guia do provedor. Não copie permissões de outro provedor nem conceda amplo acesso de gravação “por precaução”. A falta de permissões normalmente gera um erro 401 ou 403 claro, que pode ser corrigido; permissões excessivas criam riscos evitáveis. ## 2. Conectar o provedor Acesse **Configurações → Integrações → Catálogo** e selecione o provedor. Selecione **Conectar**. Conclua o fluxo OAuth ou preencha os campos solicitados na caixa de diálogo de conexão. O guia do provedor explica a origem de cada valor. Aprove a tela de consentimento do provedor, quando aplicável. Após a autenticação ser bem-sucedida, a Living Security abre ou lista a nova conexão em **conectado**. Se o provedor rejeitar a autenticação, pare e corrija a credencial, o tenant, a região, a URL de redirecionamento ou as permissões do sistema de origem antes de continuar. ## 3. Ativar os fluxos de dados Abra a conexão em **Configurações → Integrações → conectado**. A Living Security descobre os modelos de sincronização disponíveis para esse provedor e os lista como fluxos. 1. Revise o nome e a finalidade de cada fluxo. 2. Ative somente os fluxos de que o seu programa precisa. 3. Deixe os fluxos não relacionados pausados. 4. Use **Sincronizar agora**, quando disponível, para solicitar a primeira execução. Nem todo provedor oferece os mesmos fluxos ou controles de agendamento. Siga os controles exibidos na conexão, em vez de esperar um assistente universal de frequência, escopo, mapeamento de campos, rascunho ou ativação. ## 4. Verificar a primeira execução A autenticação da conexão, por si só, não comprova que os dados estão fluindo. Confirme que a conexão está íntegra e não solicita reautorização. Confirme que o fluxo necessário está ativado, e não pausado. Abra o fluxo, o link de sincronização da conexão ou **Configurações** → **Integrações** → **Sincronizações**. Aguarde um resultado final bem-sucedido e revise os erros do provedor e as contagens de registros, quando disponíveis. Abra a área relevante da Living Security. Os dados de identidade devem gerar as pessoas e identidades esperadas em Força de trabalho; os dados de fontes de segurança devem aparecer no recurso documentado por esse provedor. Durante a integração inicial, as tarefas **Verify Identity Data Flowing** e **Verify Integration Data Flowing** do Mapa da Jornada são concluídas a partir dos dados ingeridos. Não substitua esses resultados de verificação por uma conexão salva. ## Página de detalhes da sincronização Em **Configurações** → **Integrações** → **Sincronizações**, abra qualquer sincronização para ver sua configuração e o histórico de execuções em um só lugar. A página de detalhes mostra: | Seção | O que inclui | | - | - | | **Cabeçalho** | Nome da sincronização, selo de status e provedor da integração | | **Estatísticas** | Modelo, última sincronização, execuções concluídas e total de registros | | **Histórico de execuções** | Execuções recentes com status, horário e contagem de registros | | **Ações** | **Atualização**, **Pausa** / **Currículo** e **Sincronizar agora** | Use **Sincronizar agora** para acionar uma execução imediata quando a sincronização estiver ativa. As sincronizações pausadas devem ser retomadas antes que novas execuções agendadas ou manuais sejam iniciadas. Você também pode abrir uma sincronização a partir da página de detalhes da conexão quando a integração listar fluxos ativos. ## Operações de conexão A página de detalhes da conexão expõe as operações compatíveis com essa integração: | Operação | Efeito | | - | - | | **Sincronizar agora** | Solicita uma execução imediata do fluxo selecionado | | **Pausar fluxo** | Interrompe novas execuções desse fluxo, mantendo a conexão | | **Pausar conexão** | Interrompe a atividade compatível da conexão sem excluir a configuração | | **Currículo** | Reinicia um fluxo ou uma conexão pausados | | **Reautorizar** | Repete a autenticação após alteração de credenciais ou do consentimento | | **Remover** | Exclui a configuração da conexão após confirmação | Remover uma conexão não equivale a excluir os dados já ingeridos por meio dela. Consulte o guia do provedor ou entre em contato com o Suporte se o comportamento de retenção de dados influenciar a sua decisão. ## Fontes de envio personalizadas Use **Fonte de envio personalizada** quando um sistema envia dados para a Living Security, em vez de ser consultado por um conector do Catálogo. 1. Crie a fonte na parte inferior do **Catálogo**. 2. Abra a página de detalhes dela na área de envio personalizado. 3. Selecione o fluxo de destino. 4. Use **Carregar CSV** para um lote manual ou **Enviar via API** para um remetente automatizado. 5. Visualize o arquivo ou o payload e revise o histórico de execuções da fonte após o envio. Para consultar o contrato completo de endpoint, autenticação, payload, novas tentativas e verificação, consulte [API de fonte de envio personalizada](/pt/integrations/custom-push-source). Não presuma esses detalhes a partir de um guia de integração mais antigo do Unify. O carregador na página de detalhes da fonte aceita um arquivo CSV de origem de até 100 MB. Antes do carregamento, o Painel o divide, no lado do cliente, em solicitações de no máximo 10 MB e 10.000 linhas cada. Esse carregador específico da fonte é separado da página geral **Integrações → Carregar**, destinada a modelos de identidade e atividade. ## Solução de problemas | Sintoma | Verificação | | - | - | | `401 Unauthorized` | Valor da credencial, expiração, revogação, tenant do provedor e estado de reautorização | | `403 Forbidden` | Função exigida no provedor, escopos, consentimento do administrador e política de acesso do sistema de origem | | A conexão falha imediatamente | URL de redirecionamento, região, URL de origem e requisitos de lista de permissões de rede ou IP | | A conexão está íntegra, mas não ocorrem execuções | O fluxo necessário está ativado e o provedor disponibiliza esse fluxo | | A execução bem-sucedida não retorna registros | A conta de origem enxerga a população esperada e quaisquer filtros do lado do provedor estão corretos | | Os dados aparecem para a pessoa errada | Os atributos de identidade e os aliases são consistentes entre as fontes conectadas | | Os dados deixam de ser atualizados | O fluxo ou a conexão está pausado, as credenciais expiraram ou a última execução falhou | Ao entrar em contato com o [Suporte da Living Security](mailto:support@livingsecurity.com), informe a organização, o provedor, o nome da conexão, o fluxo, o horário da última execução e o erro exibido. Não inclua segredos. ## Relacionados Referência para conectado, Catálogo, Sincronizações, Ações e Carregar. Entenda os atributos e mapeamentos compatíveis, quando disponíveis. Opere uma integração existente, incluindo reautorização ou remoção. Conclua as tarefas de verificação de dados de identidade e de segurança. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.