Configurar uma integração

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

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.

​

2. Conectar o provedor

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. 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: 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: 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. 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

Ao entrar em contato com o Suporte da Living Security, 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