easm.chComprendre votre surface d’attaque externe

API : données eam.ch dans le SIEM, le système de tickets et les analyses

Grâce à l’API, vos propres applications lisent la note, les constats, l’inventaire, les tickets et les fournisseurs – automatiquement et sans export manuel.

1 min de lecture · en termes simples et pour les spécialistes

Schéma
  1. Votre système
  2. Clé, lecture seule
  3. Note, constats, tickets
  4. Évaluation automatique

Qu’est-ce que l’API ?

Une API (interface de programmation) est un accès destiné aux programmes plutôt qu’aux personnes. Votre SIEM, votre système de tickets ou un outil d’analyse interroge eam.ch régulièrement et reçoit les données dans un format fixe (JSON).

Comme une boîte aux lettres dans laquelle votre logiciel comptable va chercher lui-même les relevés – au lieu que quelqu’un les saisisse.

À quoi elle sert

  • SIEM : voir les nouveaux constats à côté d’autres événements de sécurité et déclencher des alertes.
  • Système de tickets : synchroniser les constats ouverts ou les tickets.
  • Analyses : afficher la note et son évolution dans vos propres rapports ou tableaux de bord.

L’API fournit des données sur demande. Si les messages doivent arriver dès qu’un événement se produit, les webhooks conviennent mieux.

Sûre et économe

  • Lecture seule – rien ne peut être modifié via l’API.
  • Pas de données personnelles : ni personnes responsables, ni intervenants externes.
  • Une clé par application. Vous pouvez ainsi en révoquer une sans perturber les autres.

Avec eam.ch

  • Dans l’espace client, sous Compte → « Interfaces » → « Gérer les clés API » (utilisateurs principaux), créez une clé avec une désignation.
  • Copiez la clé immédiatement et enregistrez-la de manière sûre dans votre application – elle n’est affichée qu’une fois.
  • L’application l’envoie à chaque requête (voir « Pour les spécialistes »).
  • Plus nécessaire ou soupçon d’abus : révoquez la clé.

En bref

  • Grâce à l’API, vos applications lisent note, constats, inventaire, tickets, fournisseurs et domaines surveillés.
  • Lecture seule, pas de données personnelles, une clé par application.
  • 120 requêtes au maximum par heure et par clé.
  • Clés sous Compte → Interfaces → Clés API (utilisateurs principaux).