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

> Conecte o Abnormal Security para importar dados de ameaças por e-mail e de campanhas 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="Abnormal Security" />

## O que esta integração fornece

O Abnormal Security pode fornecer atividades normalizadas de ameaças por e-mail, entrega, bloqueio e denúncias por colaboradores. Os exemplos analisados incluem:

* `phishing.real.blocked` — phishing real bloqueado antes da entrega
* `phishing.real.delivered` — phishing real entregue na caixa de entrada
* `phishing.real.reported` — denuncia e-mails de phishing reais

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

## O que o Living Security precisa

| Credencial | Descrição |
| - | - |
| **Chave de API** | Um token de portador (bearer) da API REST gerado no Abnormal Portal |
| **Host regional da API** | O nome de host do seu ambiente do Abnormal Security |

**Escopos:** Custom Access com **Leitura** em `Abuse Campaigns (AI Security Mailbox)` e `Threats`

**Função necessária:** **Security Admin** ou **Super Admin** no Abnormal Security

### Pré-requisitos

* É necessário ter acesso de **Security Admin** ou **Super Admin** no Abnormal Security para criar e gerenciar tokens de API.

***

## Parte A — No Abnormal Security

*O administrador do Abnormal Security conclui estas etapas.*

<Steps>
  <Step title="Acesse o API Token Management">
    1. Faça login no portal do Abnormal Security.
    2. Na navegação à esquerda, clique em **Configurações** e, em seguida, selecione **Integrações**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/settings-integrations.webp?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=7f5d7a616acdcf72a9048f16c6706b5e" alt="Menu Configurações do Abnormal Security exibindo a opção Integrações" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. Role até a seção **API Token Management** na parte inferior da página Integrações.
    4. Clique em **+ Create New Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/api-token-management.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=13cfdfb7ced9b3f3fca67c781ee7e844" alt="Seção API Token Management com o botão Create New Token" width="1239" height="1151" data-path="integrations/images/abnormal-security/api-token-management.avif" />
  </Step>

  <Step title="Selecione o tipo de integração">
    Selecione **REST API** como o tipo de integração e clique em **Próximo**.
  </Step>

  <Step title="Escolha o escopo do token">
    Escolha um escopo para o token e clique em **Próximo**:

    * **Cliente (All Current and Future Tenants)** — Utilize esta opção se a sua conta do Abnormal gerencia vários tenants. Este token abrange automaticamente todos os tenants atuais e futuros.
    * **Tenant (Single Tenant)** — Utilize esta opção para restringir o token a um único tenant específico.

    Para a maioria das organizações com um único tenant do Abnormal, qualquer uma das opções funciona. Em caso de dúvida, selecione **Cliente**.
  </Step>

  <Step title="Conceda o acesso necessário">
    Selecione **Custom Access** e habilite **Leitura** para os dois grupos de endpoints:

    | Grupo de endpoints | Nível de acesso necessário |
    | - | - |
    | **Abuse Campaigns (AI Security Mailbox)** | Leitura |
    | **Threats** | Leitura |

    Em seguida, clique em **Próximo**.

    <Note>
      O acesso de **Leitura** retorna dados não sensíveis de ameaças e campanhas. **Read Sensitive** expõe adicionalmente PII, anexos e dados de colaboradores. **Gravação** envia ações de remediação. Conceda somente **Leitura**, a menos que o seu caso de uso exija especificamente mais permissões.
    </Note>
  </Step>

  <Step title="Configure os detalhes do token e a lista de IPs permitidos">
    Preencha os seguintes campos:

    * **Token Name** — Um nome descritivo (por exemplo, `Living Security Platform`)
    * **Descrição** — Contexto opcional (por exemplo, `Read access for Living Security HRM platform`)
    * **Token Expiry** — Escolha **90**, **180** ou **365 dias** de acordo com a sua política de rotação. Defina um lembrete no calendário para rotacionar o token antes que ele expire.
    * **IP Safelist** — Informe os intervalos de IP de saída do Living Security, um por entrada. Clique em **Adicionar** após cada um.

    <EgressIpSafelist system="Abnormal Security" />

    <Warning>
      **A lista de IPs permitidos é obrigatória.** O Abnormal Security rejeita todas as solicitações de API provenientes de endereços que não estejam na lista. A caixa de diálogo de conexão será concluída com êxito, mas as sincronizações de dados falharão com `401 Unauthorized` até que os IPs corretos sejam adicionados à lista de permitidos.
    </Warning>

    Em seguida, clique em **Próximo**.
  </Step>

  <Step title="Revise e crie o token">
    Revise o resumo da configuração do token e clique em **Create Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/review-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=6935f488f5778fcea3f6907629aa1316" alt="Tela de revisão da configuração do token" style={{maxWidth: "550px"}} width="1910" height="726" data-path="integrations/images/abnormal-security/review-token.avif" />
  </Step>

  <Step title="Copie e salve o token">
    **Copie o token imediatamente** e armazene-o em um local seguro (por exemplo, um cofre de senhas ou um gerenciador de segredos) e, em seguida, clique em **Concluído**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/copy-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=fa752c333af664ad5b3ed037dbb67143" alt="Caixa de diálogo de cópia do token exibindo o token gerado" style={{maxWidth: "550px"}} width="1999" height="329" data-path="integrations/images/abnormal-security/copy-token.avif" />

    <Warning>
      O Abnormal Portal exibe o valor do token **somente uma vez**. Se você sair da página sem copiá-lo, será necessário criar um novo token e revogar o anterior.
    </Warning>
  </Step>

  <Step title="Identifique o host regional da API">
    Determine o host de API correto para o seu ambiente do Abnormal Security:

    | Ambiente | Host regional da API |
    | - | - |
    | Padrão (comercial dos EUA) | `api.abnormalplatform.com` |
    | UE | `eu.rest.abnormalsecurity.com` |
    | FedRAMP | `rest.abnormalsecurity.us` |

    Informe **apenas o host** — sem o prefixo `https://` e sem barra no final.

    Se você não tiver certeza de qual ambiente a sua organização utiliza, verifique a URL do seu portal do Abnormal ou entre em contato com a equipe da sua conta do Abnormal Security.
  </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 seja delegada.*

<Steps>
  <ConnectInPlatform tile="Abnormal Security">
    | Campo | Valor |
    | - | - |
    | **Chave de API** | O token copiado na Parte A, Etapa 7 |
    | **Host regional da API** | O host da Parte A, Etapa 8 (padrão dos EUA: `api.abnormalplatform.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/abnormal-security/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=46afa66685c5f59483324c863fd4fa86" alt="Caixa de diálogo de conexão do Living Security para o Abnormal Security" style={{maxWidth: "450px"}} width="576" height="638" data-path="integrations/images/abnormal-security/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Agora você está conectado ao Abnormal Security.

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="403 Forbidden — You do not have permission to perform this action">
    O token não possui uma ou ambas as concessões de acesso necessárias (**Abuse Campaigns** ou **Threats**). O tipo de integração, o escopo e o nível de acesso não podem ser alterados após a criação do token — é necessário criar um novo token com as configurações corretas e revogar o anterior.
  </Accordion>

  <Accordion title="401 Unauthorized">
    O token é inválido ou expirou, ou o IP da solicitação não está na lista de permitidos. Verifique:

    1. Se o token não foi revogado nem expirou
    2. Se todos os quatro [endereços IP de saída do Living Security](/pt/integrations/managing/egress-ip-addresses) estão na lista de permitidos

    Se as sincronizações funcionavam anteriormente, mas agora falham com `401`, os endereços IP de saída podem ter mudado — consulte [Configuração dos endereços IP de saída das integrações](/pt/integrations/managing/egress-ip-addresses) e verifique se a lista de permitidos corresponde a eles.
  </Accordion>

  <Accordion title="Expiração de tokens legados (30 de abril de 2027)">
    Se a sua organização possui tokens de API criados antes da introdução da experiência de autoatendimento do Token Management, eles aparecem como **Legacy** no painel. Os tokens legados continuam funcionando, mas não podem ser rotacionados — somente a lista de IPs permitidos pode ser atualizada. Todos os tokens legados expiram automaticamente em **30 de abril de 2027**. Planeje a substituição dos tokens legados por novos tokens antes dessa data.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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