Skip to main content

​
O que esta integração fornece

O KnowBe4 pode fornecer resultados de força de trabalho, treinamento e simulação de phishing. Entre os exemplos analisados estão:
  • training.completed — conclui o treinamento de segurança
  • training.past.due — possui treinamento em atraso
  • phishing.simulation.clicked — clicou em uma simulação sem reportá-la
Esses exemplos mostram os tipos de atividade normalizada que a Living Security pode utilizar. Consulte como os dados de integração se tornam sinais.

​
O que a Living Security precisa

Escopos: Não há nada a configurar — os tokens da Reporting API do KnowBe4 são somente leitura por definição e não possuem escopos. O token concede acesso de leitura a usuários, inscrições em treinamentos e resultados de testes de segurança de phishing, que é exatamente o que a sincronização lê. Função necessária: Account Admin no KnowBe4 (somente administradores da conta podem acessar Account Settings → API)

​
Pré-requisitos

  • Você deve estar conectado ao console do KnowBe4 com a função Account Admin. Somente administradores da conta podem acessar Account Settings → API para ativar a Reporting API e gerar tokens.

​
Parte A — No KnowBe4

O administrador do KnowBe4 conclui estas etapas.
1

Ative a Reporting API e gere um token

  1. Faça login no console do KnowBe4.
  2. Clique no nome da sua conta no canto superior direito e selecione Account Settings.
  3. Na navegação à esquerda, selecione API.
  4. Ative a Reporting API, caso ainda não esteja ativada, e gere um novo token de API.
Atribua ao token uma finalidade descritiva (por exemplo, Living Security Platform), caso o console solicite.
O KnowBe4 exibe o valor do token de API apenas uma vez, no momento em que ele é gerado. Copie-o imediatamente e armazene-o em um local seguro (por exemplo, um cofre de senhas ou um gerenciador de segredos). Se você sair da página sem copiá-lo, será necessário gerar um novo token.
A Reporting API é somente leitura. Ela expõe usuários, inscrições em treinamentos e resultados de testes de segurança de phishing — os dados que a Living Security ingere para pontuação e geração de relatórios. Não é necessário acesso de gravação.
2

Adicione os IPs de saída da Living Security à lista de Allowed IP Addresses

O KnowBe4 permite restringir o acesso à Reporting API a um conjunto específico de endereços IP de origem. Essa configuração fica no mesmo local do token:
  1. No console do KnowBe4, acesse Account Settings → API → Allowed IP Addresses.
  2. Adicione cada endereço IP de saída da Living Security à lista de permissões. Os mesmos quatro endereços se aplicam a todas as regiões.
Se a lista de Allowed IP Addresses estiver configurada, ela será aplicada na camada de rede. A caixa de diálogo de conexão será concluída com sucesso no momento da autenticação, mas as sincronizações de dados falharão (bloqueadas na camada de rede, geralmente exibidas como 403) até que os IPs de saída da Living Security sejam adicionados à lista de permissões. Se você adicionar qualquer endereço a essa lista, também deverá adicionar os intervalos da Living Security; caso contrário, nossas requisições serão rejeitadas, mesmo que o token seja válido.
Os endereços IP de saída da Living Security podem mudar quando a infraestrutura é atualizada, embora essas mudanças sejam raras. Se as sincronizações de dados começarem a falhar após terem funcionado anteriormente, consulte Configuração dos endereços IP de saída das integrações e verifique se a lista de Allowed IP Addresses corresponde.
3

Identifique a região do servidor do KnowBe4

O KnowBe4 disponibiliza a Reporting API a partir de um host específico de cada região. Você seleciona a região na caixa de diálogo de conexão, em vez de digitar um nome de host:Se você não tiver certeza de qual região sua conta utiliza, verifique o domínio da URL do console do KnowBe4 ou entre em contato com o administrador do KnowBe4.
Estas cinco regiões são as que a Living Security consegue acessar. Se sua conta do KnowBe4 estiver em outro servidor (por exemplo, uma instância do Governo dos EUA), entre em contato com o suporte da Living Security antes de iniciar a conexão.

​
Parte B — Na Living Security Platform

O responsável pelo programa conclui esta etapa, ou o administrador do sistema, caso a configuração delegada seja utilizada.
Agora você está conectado ao KnowBe4.

​
Solução de problemas

O token de API é inválido ou expirou. Verifique se o token está correto e se não foi regenerado em Account Settings → API.
O token não tem acesso à Reporting API ou o IP da requisição não consta na lista de Allowed IP Addresses. Verifique se a Reporting API está ativada e se todos os quatro endereços IP de saída da Living Security estão na lista de permissões.
A Reporting API pode ainda não ter dados a retornar, ou a conta do token não tem visibilidade sobre os usuários e as campanhas que a Living Security ingere. Verifique se o token foi gerado por um Account Admin.