> ## 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 específicos do provedor, as permissões e as etapas de autenticação constam do guia de configuração vinculado ao card do provedor no Catálogo. ## Pré-requisitos | Função | Responsabilidade | | - | - | | [**Proprietário do Programa**](/pt-BR/reference/glossary#respons%C3%A1vel-pelo-programa) | Seleciona a origem, a conecta à Living Security, ativa os fluxos e verifica o resultado | | [**Administrador do Sistema**](/pt-BR/reference/glossary#administrador-do-sistema) | Cria ou aprova as credenciais e os escopos no sistema de origem | Essas funções podem ser exercidas pela mesma pessoa. A pessoa que inserir 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 por presumir 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 antes de criar as credenciais. A autenticação do provedor pode usar consentimento OAuth, token de API, ID e segredo de cliente, conta de serviço ou outro método compatível com o provedor. Crie somente as credenciais e os escopos indicados no guia desse 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. Quando aplicável, aprove a tela de consentimento do provedor. Após a autenticação ser concluída com sucesso, 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 identifica 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. Mantenha pausados os fluxos não relacionados. 4. Use **Sincronizar agora**, quando disponível, para solicitar a primeira execução. Nem todos os provedores oferecem os mesmos fluxos ou controles de agendamento. Siga os controles exibidos na conexão, em vez de esperar uma frequência, um escopo, um mapeamento de campos, um rascunho ou um assistente de ativação universais. ## 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 nova autorizaçã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 a contagem 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. Na integração inicial, as tarefas **Verificar fluxo de dados de identidade** e **Verificar fluxo de dados de integração** 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 exibe: | 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 disparar 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. Também é possível abrir uma sincronização a partir da página de detalhes da conexão, quando a integração lista fluxos ativos. ## Operações da 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 para o fluxo selecionado | | **Pausar fluxo** | Interrompe novas execuções desse fluxo e mantém 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 mudança de credenciais ou de 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 a partir 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 enviar dados para a Living Security, em vez de ser consultado por meio de 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 o contrato completo de endpoint, autenticação, payload, novas tentativas e verificação, consulte [API de fonte de envio personalizada](/pt-BR/integrations/custom-push-source). Não deduza 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 de 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 há execuções | O fluxo necessário está ativado e o provedor disponibiliza esse fluxo | | Uma execução bem-sucedida não retorna registros | A conta de origem enxerga a população esperada e os filtros do lado do provedor estão corretos | | Os dados aparecem na 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 execução mais recente 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 execução mais recente 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 os mapeamentos compatíveis, quando disponíveis. Opere uma integração existente, da reautorização à 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.