Skip to main content

​
Ce que cette intégration apporte

Abnormal Security peut fournir des données normalisées sur l’activité liée aux menaces par e-mail, à la distribution, au blocage et aux signalements des employés. Voici quelques exemples examinés :
  • phishing.real.blocked — hameçonnage réel bloqué avant la distribution
  • phishing.real.delivered — hameçonnage réel distribué dans la boîte de réception
  • phishing.real.reported — signale des e-mails d’hameçonnage réels
Ces exemples illustrent les types d’activité normalisée que Living Security peut utiliser. Consultez comment les données d’intégration deviennent des signaux.

​
Ce dont Living Security a besoin

Portées : Accès personnalisé avec Lire sur Abuse Campaigns (AI Security Mailbox) et Threats Rôle requis : Security Admin ou Super Admin dans Abnormal Security

​
Prérequis

  • Vous devez disposer d’un accès Security Admin ou Super Admin dans Abnormal Security pour créer et gérer des jetons d’API.

​
Partie A — Dans Abnormal Security

Votre administrateur Abnormal Security effectue ces étapes.
1

Accéder à la gestion des jetons d'API

  1. Connectez-vous à votre portail Abnormal Security.
  2. Dans la navigation de gauche, cliquez sur Settings, puis sélectionnez Integrations.
Menu Settings d'Abnormal Security affichant l'option Integrations
  1. Faites défiler la page jusqu’à la section API Token Management, en bas de la page Integrations.
  2. Cliquez sur + Create New Token.
Section API Token Management avec le bouton Create New Token
2

Sélectionner le type d'intégration

Sélectionnez REST API comme type d’intégration, puis cliquez sur Suivant.
3

Choisir la portée du jeton

Choisissez une portée pour le jeton, puis cliquez sur Suivant :
  • Client (tous les locataires actuels et futurs) — À utiliser si votre compte Abnormal gère plusieurs locataires. Ce jeton couvre automatiquement tous les locataires actuels et futurs.
  • Locataire (locataire unique) — À utiliser pour limiter le jeton à un seul locataire spécifique.
Pour la plupart des organisations ne disposant que d’un seul locataire Abnormal, l’une ou l’autre option convient. En cas de doute, sélectionnez Client.
4

Accorder l'accès requis

Sélectionnez Custom Access et activez Lire pour les deux groupes de points de terminaison :Cliquez ensuite sur Suivant.
L’accès Lire renvoie des données non sensibles sur les menaces et les campagnes. Read Sensitive expose en plus les informations personnelles identifiables (PII), les pièces jointes et les données des employés. Écriture permet de soumettre des actions de remédiation. N’accordez que l’accès Lire, sauf si votre cas d’usage exige expressément davantage.
5

Configurer les détails du jeton et la liste d'adresses IP autorisées

Renseignez les champs suivants :
  • Token Name — Un nom descriptif (par exemple, Living Security Platform)
  • descriptif — Contexte facultatif (par exemple, Read access for Living Security HRM platform)
  • Token Expiry — Choisissez 90, 180 ou 365 jours selon votre politique de rotation. Définissez un rappel dans votre calendrier pour renouveler le jeton avant son expiration.
  • IP Safelist — Saisissez les plages d’adresses IP de sortie de Living Security, une par entrée. Cliquez sur Ajouter après chacune.
La liste d’adresses IP autorisées est obligatoire. Abnormal Security rejette toutes les requêtes d’API provenant d’adresses ne figurant pas dans cette liste. La boîte de dialogue de connexion aboutira, mais les synchronisations de données échoueront avec 401 Unauthorized tant que les bonnes adresses IP n’auront pas été ajoutées à la liste.
Cliquez ensuite sur Suivant.
6

Vérifier et créer le jeton

Vérifiez le récapitulatif de la configuration de votre jeton, puis cliquez sur Create Token.Écran de vérification de la configuration du jeton
7

Copier et enregistrer votre jeton

Copiez immédiatement le jeton et conservez-le dans un emplacement sécurisé (par exemple, un coffre-fort de mots de passe ou un gestionnaire de secrets), puis cliquez sur Terminé.Boîte de dialogue de copie du jeton affichant le jeton généré
Le portail Abnormal n’affiche la valeur du jeton qu’une seule fois. Si vous quittez la page sans l’avoir copiée, vous devrez créer un nouveau jeton et révoquer l’ancien.
8

Identifier votre hôte d'API régional

Déterminez l’hôte d’API correspondant à votre environnement Abnormal Security :Saisissez uniquement l’hôte — sans le préfixe https:// et sans barre oblique finale.Si vous ne savez pas quel environnement votre organisation utilise, vérifiez l’URL de votre portail Abnormal ou contactez l’équipe de votre compte Abnormal Security.

​
Partie B — Dans Living Security Platform

Le responsable du programme effectue cette étape, ou l’administrateur système si la configuration déléguée est utilisée.
Vous êtes maintenant connecté à Abnormal Security.

​
Dépannage

Il manque au jeton l’un des accès requis, ou les deux (Abuse Campaigns ou Threats). Le type d’intégration, la portée et le niveau d’accès ne peuvent pas être modifiés après la création du jeton : vous devez créer un nouveau jeton avec les paramètres appropriés et révoquer l’ancien.
Soit le jeton est invalide ou expiré, soit l’adresse IP de la requête ne figure pas dans la liste des adresses autorisées. Vérifiez les points suivants :
  1. Le jeton n’a pas été révoqué et n’a pas expiré
  2. Les quatre adresses IP de sortie de Living Security figurent dans la liste des adresses autorisées
Si les synchronisations fonctionnaient auparavant mais échouent désormais avec 401, les adresses IP de sortie ont peut-être changé : consultez Configuration des adresses IP de sortie des intégrations et vérifiez que la liste des adresses autorisées correspond.
Si votre organisation possède des jetons d’API créés avant l’introduction de l’expérience libre-service Token Management, ils apparaissent comme Legacy dans le tableau de bord. Les jetons hérités continuent de fonctionner, mais ils ne peuvent pas faire l’objet d’une rotation : seule leur liste d’adresses IP autorisées peut être mise à jour. Tous les jetons hérités expirent automatiquement le 30 avril 2027. Prévoyez de les remplacer par de nouveaux jetons avant cette date.