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, 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

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.

​

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

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 última execução e o erro exibido. Não inclua segredos.

​

Relacionados