> ## 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 Adaptive Security

> Conecte o Adaptive Security ao Living Security Platform para importar os resultados de simulações de phishing, smishing e vishing, além dos resultados de treinamento de conscientização em segurança 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="Adaptive Security" />

## O que esta integração fornece

O Adaptive Security pode fornecer resultados da força de trabalho, de treinamento e de simulações multicanal. Exemplos revisados incluem:

* `phishing.simulation.clicked` — clicou em um e-mail simulado sem reportá-lo
* `phishing.simulation.credential.submitted` — inseriu credenciais em uma página de login simulada
* `phishing.simulation.attachment.opened` — abriu um anexo em um e-mail simulado
* `phishing.simulation.reported` — reportou um e-mail simulado
* `smishing.simulation.replied` — respondeu a uma mensagem de texto simulada
* `vishing.simulation.succeeded` — atendeu às solicitações de um interlocutor de voz simulado
* `training.assigned` — recebeu treinamento de segurança atribuído
* `training.completed` — concluiu o treinamento de segurança
* `training.past.due` — perdeu o prazo de um treinamento

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

<Note>
  **O Adaptive simula em três canais, e o Living Security pontua cada um separadamente.**
  Os resultados de e-mail são pontuados como phishing, os de mensagens de texto como smishing e os de chamadas de voz como vishing. Uma pessoa que clica em um e-mail simulado e outra que responde a uma mensagem de texto simulada não são medidas como tendo o mesmo comportamento, pois o julgamento exercido em cada caso é diferente.
</Note>

## O que o Living Security precisa

| Credencial | Descrição |
| - | - |
| **Token de API** | Um token de API do Adaptive Security. O Living Security o envia como bearer token em cada solicitação. |

**Função necessária:** Um administrador da sua conta do Adaptive Security com acesso a **Settings → API**. O Adaptive controla o acesso à API por meio de permissões baseadas em função, portanto o token deve pertencer a uma função que possa ler usuários, phishing e treinamento.

**Acesso:** Somente leitura. O Living Security apenas lê dados do Adaptive Security e nunca cria, altera nem exclui nada na sua conta.

### O que o Living Security recupera

| Dados | Detalhe |
| - | - |
| **Pessoas** | O diretório de usuários do Adaptive: nome, e-mail, departamento, cargo, nome e e-mail do gestor, localização, divisão, situação de emprego e data de início. |
| **Simulações de e-mail** | Por pessoa e por simulação: quando a mensagem foi entregue, aberta, clicada, respondida, teve o anexo aberto, teve o código QR escaneado, teve credenciais inseridas ou foi reportada. |
| **Simulações de texto** | Por pessoa e por simulação: entregue, aberta, clicada, respondida, com credenciais inseridas ou reportada. |
| **Simulações de voz** | Por pessoa e por simulação: a isca entregue, o número chamado, se a pessoa atendeu às solicitações do interlocutor e se a reportou. |
| **Treinamento** | Por pessoa e por campanha: quando foi inscrita, qual era o prazo, quando iniciou, quando concluiu e se confirmou ciência da política da campanha. |

<Note>
  **Os números de telefone não são armazenados.** O Adaptive retorna números de escritório e de celular no registro do usuário. O Living Security descarta ambos antes de armazenar qualquer dado, pois nenhum recurso do Living Security os utiliza.
</Note>

<Note>
  **A pontuação de risco do próprio Adaptive é registrada, mas nunca utilizada no cálculo.** O Adaptive calcula um `current_risk_score` por pessoa. O Living Security o mantém para que você possa comparar os dois sistemas lado a lado, mas o Índice de Risco Humano é sempre calculado a partir do comportamento observado, usando o modelo publicado do próprio Living Security — nunca a partir da pontuação composta de outro fornecedor.
</Note>

### Pré-requisitos

* Uma conta do Adaptive Security com a API habilitada.
* Acesso de administrador a [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* Endereços de e-mail dos usuários no Adaptive que correspondam aos endereços usados pelos outros sistemas conectados. O e-mail é o meio pelo qual o Living Security associa um usuário do Adaptive a uma pessoa.

***

## Parte A — No Adaptive Security

*O administrador do Adaptive Security conclui estas etapas.*

<Steps>
  <Step title="Abra as configurações da API">
    1. Faça login em [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) como administrador.
    2. Acesse **Settings → API**.
  </Step>

  <Step title="Gere o token de API">
    1. Gere um novo token de API.
    2. Dê a ele um nome que você reconheça posteriormente — por exemplo, `Living Security`.
    3. Confirme que a função do token pode ler usuários, campanhas de phishing e campanhas de treinamento.
    4. Copie o token.

    <Warning>
      Copie o token antes de sair da página. Se a sua conta do Adaptive definir uma data de expiração para o token, anote-a — o Living Security não consegue recuperar dados após a expiração, e a conexão precisará ser atualizada com um novo token.
    </Warning>
  </Step>
</Steps>

***

## Parte B — No Living Security Platform

*O responsável pelo programa conclui esta etapa, ou o administrador do sistema, caso a configuração delegada esteja em uso.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Campo | Valor |
    | - | - |
    | **Token de API** | O token gerado na Parte A |
  </ConnectInPlatform>
</Steps>

Agora você está conectado ao Adaptive Security.

***

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

| Dados | Agendamento |
| - | - |
| Pessoas | A cada 6 horas |
| Resultados de simulações (e-mail, texto, voz) | A cada 6 horas |
| Resultados de treinamento | A cada 6 horas |

A API de relatórios do Adaptive não oferece um filtro de "o que mudou desde", portanto o Living Security lê cada campanha de simulação e de treinamento enquanto ela ainda estiver produzindo resultados e deixa de lê-la quando ela estiver encerrada há duas semanas. Assim, cliques e reportes tardios ainda são capturados, e as campanhas finalizadas não são relidas indefinidamente.

<Note>
  A primeira conexão em uma conta grande do Adaptive pode exigir várias execuções agendadas para concluir a leitura de todos os dados. Cada execução lê o máximo possível e a seguinte continua do ponto em que a anterior parou; por isso, as contagens aumentam ao longo do primeiro ou dos dois primeiros dias, em vez de aparecerem todas de uma só vez.
</Note>

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    O token de API está incorreto, expirou ou foi revogado. O Adaptive retorna um corpo de resposta vazio nesse erro, portanto não há mais detalhes a consultar. Gere um novo token em **Settings → API** e reconecte com ele. Um token copiado parcialmente produz o mesmo erro e é a causa mais comum.
  </Accordion>

  <Accordion title="403 Forbidden">
    O token foi autenticado, mas a função associada a ele não pode ler os dados solicitados. Colar novamente o mesmo token não resolverá o problema. No Adaptive, confirme que a função do token tem acesso de leitura a usuários, phishing e treinamento, ou emita um token a partir de uma função que tenha.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    O Adaptive aplicou limite de taxa à conexão. O Living Security interrompe essa execução e a retoma do mesmo ponto na próxima execução agendada, portanto nenhum dado é perdido — as contagens apenas levam mais tempo para aumentar. Se o problema persistir por vários dias, entre em contato com o suporte do Adaptive Security para consultar o limite de taxa aplicável à sua conta.
  </Accordion>

  <Accordion title="As pessoas aparecem, mas não há resultados de simulação">
    Verifique se as campanhas esperadas realmente foram executadas. O Adaptive informa inscrições apenas para simulações que já foram enviadas; portanto, uma campanha ainda com status **Draft** ou **Scheduled** não contribui com nada até ser enviada. O Living Security deliberadamente não lê essas campanhas, para que use seu limite de solicitações em campanhas com resultados reais.
  </Accordion>

  <Accordion title="Simulações de voz ou de texto estão ausentes">
    O Living Security determina o canal de cada resultado a partir do cenário associado a ele. Se um cenário foi excluído no Adaptive após a execução da simulação, seus resultados são registrados no canal de e-mail, pois o canal não pode mais ser lido. Manter os cenários desativados no Adaptive, em vez de excluí-los, evita esse problema.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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