Skip to main content

O que esta integração fornece

O Abnormal Security pode fornecer atividades normalizadas de ameaças por e-mail, entrega, bloqueio e denúncias de funcionários. 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 a Living Security pode utilizar. Consulte como os dados de integração se tornam sinais.

O que a Living Security precisa

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

  • Você deve 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.
1

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.
Menu de configurações do Abnormal Security exibindo a opção Integrações
  1. Role até a seção API Token Management na parte inferior da página Integrações.
  2. Clique em + Create New Token.
Seção API Token Management com o botão Create New Token
2

Selecione o tipo de integração

Selecione REST API como o tipo de integração e clique em Próximo.
3

Escolha o escopo do token

Escolha um escopo para o token e clique em Próximo:
  • Cliente (todos os tenants atuais e futuros) — Use esta opção se a sua conta do Abnormal gerencia vários tenants. Este token abrange automaticamente todos os tenants atuais e futuros.
  • Tenant (tenant único) — Use 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.
4

Conceda o acesso necessário

Selecione Custom Access e habilite Leitura para os dois grupos de endpoints:Em seguida, clique em Próximo.
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 funcionários. Gravação envia ações de remediação. Conceda somente Leitura, a menos que o seu caso de uso exija especificamente mais permissões.
5

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 fazer a rotação do token antes que ele expire.
  • IP Safelist — Informe os intervalos de IP de saída da Living Security, um por entrada. Clique em Adicionar após cada um.
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 de IPs permitidos. A caixa de diálogo de conexão será concluída com sucesso, mas as sincronizações de dados falharão com 401 Unauthorized até que os IPs corretos sejam incluídos na lista.
Em seguida, clique em Próximo.
6

Revise e crie o token

Revise o resumo da configuração do token e clique em Create Token.Tela de revisão da configuração do token
7

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.Caixa de diálogo de cópia do token exibindo o token gerado
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.
8

Identifique o host regional da API

Determine o host de API correto para o seu ambiente do Abnormal Security:Informe somente o host — sem o prefixo https:// e sem barra 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.

Parte B — Na Living Security Platform

O responsável pelo programa conclui esta etapa ou, se a configuração delegada for utilizada, o administrador do sistema.
Agora você está conectado ao Abnormal Security.

Solução de problemas

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 — você deve criar um novo token com as configurações corretas e revogar o anterior.
O token é inválido ou está expirado, ou o IP da solicitação não está na lista de IPs permitidos. Verifique:
  1. Se o token não foi revogado nem expirou
  2. Se os quatro endereços IP de saída da Living Security estão na lista de IPs permitidos
Se as sincronizações funcionavam anteriormente, mas agora falham com 401, os endereços IP de saída podem ter sido alterados — consulte Configuring Integration Egress IP Addresses e verifique se a lista de IPs permitidos corresponde.
Se a sua organização tiver tokens de API criados antes da introdução da experiência de autoatendimento de Token Management, eles aparecerão como Legacy no painel. Os tokens legados continuam funcionando, mas não podem passar por rotação — 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.