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

> Conecte o NINJIO à Living Security Platform para importar os resultados de treinamento de conscientização em segurança e os resultados de simulações de phishing da sua força de trabalho.

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 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="NINJIO" />

## O que esta integração fornece

O NINJIO pode fornecer resultados da força de trabalho, de treinamento e de simulação de phishing. Entre os exemplos analisados estão:

* `training.assigned` — possui treinamento de segurança atribuído
* `training.completed` — conclui o treinamento de segurança
* `training.passed` — é aprovado nas avaliações do treinamento de segurança
* `phishing.simulation.clicked` — clicou em uma simulação sem reportá-la
* `phishing.simulation.reported` — reporta simulações de phishing

Esses exemplos mostram os tipos de atividade normalizada que a Living Security pode utilizar. Consulte [como os dados da integração se tornam sinais](/pt/signals/data-sources).

## O que a Living Security precisa

| Credencial | Descrição |
| - | - |
| **Chave de API** | Uma chave de API do NINJIO com acesso de leitura aos pontos de acesso de funcionários, treinamento e phishing. A Living Security a envia em todas as requisições. |

**Escopos:** o NINJIO define os escopos de cada chave de API por *ponto de acesso*, com permissões de leitura e de gravação separadas. A Living Security precisa de **leitura** em três deles: funcionários, treinamento e phishing. O acesso de gravação não é necessário e não deve ser concedido.

**Função necessária:** **Administrador** na sua conta do NINJIO. Somente administradores podem acessar a área de Integração, onde as chaves são criadas.

<Warning>
  **O NINJIO exibe uma nova chave somente uma vez, no momento em que ela é criada.** Copie-a diretamente para a Living Security Platform, ou para um cofre de senhas, antes de sair da página. Uma chave que não tenha sido copiada não pode ser recuperada — será necessário gerar uma substituta.
</Warning>

### O que a Living Security obtém

| Dados | Detalhe |
| - | - |
| **Aprendizes** | O diretório de funcionários do seu NINJIO: nome, e-mail, departamento, cargo, gestor, país, filial e status ativo. |
| **Treinamento** | Quem recebeu cada treinamento e quem o concluiu — com data de conclusão, nota do exame e pontuação de engajamento. |
| **Phishing** | Quem interagiu com um e-mail de phishing simulado e quem o reportou, com o horário em que ocorreu. |

<Note>
  **Os números de telefone dos aprendizes não são armazenados.** O NINJIO retorna um número de telefone no registro do funcionário. A Living Security o descarta antes de armazenar qualquer dado, pois nenhum recurso da Living Security o utiliza.
</Note>

### Pré-requisitos

* Uma conta do NINJIO com acesso à API.
* Acesso de administrador a [admin.goninjio.com](https://admin.goninjio.com/).
* Endereços de e-mail dos aprendizes no NINJIO que correspondam aos endereços usados pelos seus outros sistemas conectados. O e-mail é a forma como a Living Security associa um aprendiz do NINJIO a uma pessoa.

***

## Parte A — No NINJIO

*O administrador do NINJIO realiza estas etapas.*

<Steps>
  <Step title="Abra a área de Integração">
    1. Faça login em [admin.goninjio.com](https://admin.goninjio.com/) como administrador.
    2. Selecione **Integration** no canto superior direito da tela.
  </Step>

  <Step title="Crie a chave de API">
    1. Selecione **New API Key**.
    2. Dê à chave um nome que você reconheça depois — por exemplo, `Living Security`.
    3. Conceda acesso de **leitura** aos pontos de acesso **employee**, **training** e **phishing**.
    4. Deixe o acesso de gravação desmarcado. A Living Security apenas lê dados do NINJIO.
    5. Selecione **Generate Key**.

    <Warning>
      Copie a chave agora. O NINJIO a exibe uma única vez e não poderá exibi-la novamente.
    </Warning>
  </Step>
</Steps>

***

## Parte B — Na Living Security Platform

*O responsável pelo programa realiza esta etapa, ou o administrador do sistema, caso a configuração delegada seja utilizada.*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Campo | Valor |
    | - | - |
    | **Chave de API** | A chave que você gerou na Parte A |
  </ConnectInPlatform>
</Steps>

Agora você está conectado ao NINJIO.

***

## Frequência de obtenção dos dados

| Dados | Agendamento |
| - | - |
| Aprendizes | Diariamente |
| Resultados de treinamento | A cada 6 horas |
| Resultados de phishing | A cada 6 horas |

Na primeira conexão, a Living Security obtém os últimos 12 meses de conclusões de treinamento e, em seguida, passa a atualizar os dados de forma incremental. As simulações de phishing são lidas uma única vez e verificadas novamente por duas semanas após o término, de modo que cliques e relatos tardios ainda sejam capturados.

<Note>
  A primeira conexão em uma conta grande do NINJIO pode levar várias execuções agendadas para concluir a leitura de todos os dados. Cada execução lê o máximo que puder e a seguinte continua de onde a anterior parou; por isso, as contagens aumentam ao longo do primeiro ou do segundo dia, em vez de aparecerem todas de uma vez.
</Note>

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    A chave de API está incorreta ou incompleta. A causa mais comum é uma chave copiada parcialmente — o NINJIO a exibe uma única vez, portanto é fácil colar um texto truncado e impossível perceber isso depois. Gere uma nova chave no NINJIO e reconecte-se com ela.
  </Accordion>

  <Accordion title="403 Forbidden">
    Este **não** é um problema de credencial. A chave foi autenticada, mas um dos pontos de acesso necessários não recebeu permissão de leitura.

    Colar novamente a mesma chave não resolverá o problema. No NINJIO, crie uma chave com acesso de **leitura** aos três pontos de acesso — employee, training e phishing — e reconecte-se com ela.
  </Accordion>

  <Accordion title="Conectado com sucesso, mas sem dados de treinamento">
    Verifique no NINJIO se pelo menos uma campanha de treinamento está **ativa** e possui uma simulação associada. Uma campanha sem simulação permanece inativa e não entrega nada, portanto não há resultados para obter.

    Se houver campanhas ativas, confirme se os aprendizes incluídos nelas têm endereços de e-mail em seus registros do NINJIO. Um aprendiz sem endereço de e-mail não pode ser associado a uma pessoa e é ignorado.
  </Accordion>

  <Accordion title="O treinamento aparece como atribuído, mas nunca concluído">
    Essa é a exibição esperada para um treinamento que o aprendiz ainda não finalizou. A Living Security registra a atribuição quando a simulação do NINJIO é iniciada e registra a conclusão separadamente, quando o NINJIO informa uma data de conclusão.
  </Accordion>

  <Accordion title="Alguns aprendizes não aparecem">
    A Living Security associa um aprendiz do NINJIO a uma pessoa pelo **endereço de e-mail**. Um aprendiz cujo e-mail no NINJIO seja diferente do endereço registrado no seu diretório — um endereço pessoal, um domínio antigo ou um erro de digitação — não será associado.

    Corrija o endereço no NINJIO e a associação será feita na próxima obtenção agendada.
  </Accordion>

  <Accordion title="Os resultados de phishing de uma simulação mais antiga estão ausentes">
    A Living Security verifica novamente uma simulação de phishing por duas semanas após o término e, depois, deixa de fazê-lo. Os resultados que o NINJIO registrar após esse período não são obtidos. Entre em contato com o suporte se precisar que uma simulação mais antiga seja lida novamente.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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