Skip to main content

​
O que esta integração fornece

O KnowBe4 pode fornecer resultados de força de trabalho, de treinamento e de 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 o Living Security pode utilizar. Consulte como os dados de integração se transformam em sinais.

​
O que o 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 habilitar a Reporting API e gerar tokens.

​
Parte A — No KnowBe4

O administrador do KnowBe4 conclui estas etapas.
1

Habilite 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. Habilite a Reporting API, caso ainda não esteja habilitada, e depois gere um novo token de API.
Atribua ao token uma finalidade descritiva (por exemplo, Living Security Platform) caso o console solicite essa informação.
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 o 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 do Living Security à lista 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 do Living Security à lista de permissões. Os mesmos quatro endereços se aplicam a todas as regiões.
Se a lista 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, normalmente exibidas como 403) até que os IPs de saída do Living Security sejam adicionados à lista de permissões. Se você adicionar qualquer endereço a esta lista, também deverá adicionar os intervalos do Living Security; caso contrário, nossas solicitações serão rejeitadas, mesmo que o seu token seja válido.
Os endereços IP de saída do Living Security podem mudar quando a infraestrutura é atualizada, embora essas alterações 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 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 a 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 o Living Security consegue acessar. Se a sua conta do KnowBe4 estiver em outro servidor (por exemplo, uma instância do Governo dos EUA), entre em contato com o suporte do Living Security antes de iniciar a conexão.

​
Parte B — No Living Security Platform

O responsável pelo programa conclui esta etapa ou, se for utilizada a configuração delegada, o administrador do sistema.
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 possui acesso à Reporting API ou o IP da solicitação não está na lista Allowed IP Addresses. Verifique se a Reporting API está habilitada e se os quatro endereços IP de saída do Living Security estão na lista de permissões.
A Reporting API pode ainda não ter dados para retornar, ou a conta do token não possui visibilidade dos usuários e das campanhas que o Living Security ingere. Verifique se o token foi gerado por um Account Admin.