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

# Configuração da integração com o KnowBe4

> Conecte o KnowBe4 ao Living Security Platform para importar usuários, inscrições em treinamentos e resultados de testes de segurança de phishing.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Recursos relacionados</h2>
    <ul>
      <li>
        <a href="/pt/signals/data-sources">Saiba como os dados de integração se transformam em Sinais de Gerenciamento de Risco Humano</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Explore as Integrações da Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Abra a Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Solicite uma demonstração da Living Security</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Adicione os quatro endereços IP de saída de sincronização da Living Security</strong> à lista de permissões em{' '}
    {system}. Insira cada um como um único host com <code>/32</code> se o sistema {system} esperar notação CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    O tráfego pode sair por qualquer um dos quatro endereços; portanto, incluir apenas alguns deles na lista de permissões causa falhas intermitentes de
    sincronização. Estes quatro endereços são os mesmos em todas as regiões da Living Security. Consulte{' '}
    <a href="/pt/integrations/managing/egress-ip-addresses">
      Configuração dos endereços IP de saída das Integrações
    </a>{' '}
    para obter a lista completa, a política de alterações e a solução de problemas.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Insira as credenciais na Living Security Platform">
    <p>
      Realizado por quem possui acesso à Living Security — o responsável pelo programa ou o
      administrador do sistema, caso tenha sido convidado (configuração delegada).
    </p>
    <ol>
      <li>
        Acesse <strong>Configurações → Integrações → Catálogo</strong>, localize o cartão{' '}
        <strong>{tile}</strong> e clique em <strong>Conectar</strong>.
      </li>
      <li>
        Preencha os campos abaixo e, em seguida, clique em <strong>Conectar</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Este guia destina-se ao administrador de {system}.</strong> Abrange a criação de
      credenciais de API no {system}, o que requer acesso de administrador ao {system} — e não à
      Living Security Platform.
    </p>
    <p>
      Se for o <strong>responsável pelo programa</strong> da Living Security e não administrar o {system},
      envie esta página a quem o faça. Essa pessoa conclui a Parte A e devolve-lhe as credenciais
      (ou introduz-las diretamente, caso tenha sido convidada para a plataforma).
      {recommendDelegated && <>
          {' '}Como a configuração gera material de chaves confidencial, recomendamos o percurso de{' '}
          <strong>configuração delegada</strong>, para que o segredo nunca lhe seja enviado.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

## 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](/pt/signals/data-sources).

## O que o Living Security precisa

| Credencial | Descrição |
| - | - |
| **Chave de API** | Um token de portador da Reporting API gerado em **Account Settings → API**. Enviado em todas as solicitações no cabeçalho `Authorization: Bearer`. |
| **Região do servidor da Reporting API** | A região em que a sua conta do KnowBe4 foi provisionada, escolhida em uma lista (EUA, UE, Canadá, Reino Unido, Alemanha). |

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

<Steps>
  <Step title="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.

    <Warning>
      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.
    </Warning>

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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](/pt/integrations/managing/egress-ip-addresses) à lista de permissões. Os mesmos quatro endereços se aplicam a todas as regiões.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **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.
    </Warning>

    <Note>
      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](/pt/integrations/managing/egress-ip-addresses) e verifique se a lista Allowed IP Addresses corresponde.
    </Note>
  </Step>

  <Step title="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:

    | Região | Host da Reporting API |
    | - | - |
    | Estados Unidos | `us.api.knowbe4.com` |
    | Europa | `eu.api.knowbe4.com` |
    | Canadá | `ca.api.knowbe4.com` |
    | Reino Unido | `uk.api.knowbe4.com` |
    | Alemanha | `de.api.knowbe4.com` |

    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.

    <Note>
      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.
    </Note>
  </Step>
</Steps>

***

## 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.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Campo | Valor |
    | - | - |
    | **Chave de API** | O token da Reporting API da Parte A, Etapa 1 |
    | **Região do servidor da Reporting API** | A região da Parte A, Etapa 3 (por exemplo, Estados Unidos) |
  </ConnectInPlatform>
</Steps>

Agora você está conectado ao KnowBe4.

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    O token de API é inválido ou expirou. Verifique se o token está correto e se não foi regenerado em **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    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](/pt/integrations/managing/egress-ip-addresses) estão na lista de permissões.
  </Accordion>

  <Accordion title="Resultados vazios (200 OK, mas sem dados)">
    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.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.