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

Requête

GET https://www.eam.ch/api.php?r=<ressource> avec l’en-tête Authorization: Bearer eamk_…. Réponse JSON avec v (version 1), resource, generated_at (UTC) et tenant.

RessourceContenu
ratingnote globale et points, par catégorie et par domaine avec dernier contrôle
findingsconstats avec identifiant, domaine, catégorie, contrôle, gravité, titre, objet, statut, dates et lien ; status=open (par défaut) ou all, lang=de|fr|it|en
assetsinventaire : noms d’hôtes, adresses, services avec première et dernière apparition
ticketsnuméro, titre, domaine, source, priorité, statut, échéance, en retard, lien
suppliersfournisseurs avec note, importance et état du contrôle
watchdomaines surveillés avec enregistrement, messagerie, site web, expiration et évaluation

Exemples

curl

curl -H "Authorization: Bearer eamk_…" "https://www.eam.ch/api.php?r=findings&status=open&lang=fr"

PowerShell

$h = @{ Authorization = "Bearer $env:EAM_KEY" }
Invoke-RestMethod -Headers $h -Uri "https://www.eam.ch/api.php?r=rating"

Python

import os, requests
r = requests.get("https://www.eam.ch/api.php", params={"r": "tickets"},
                 headers={"Authorization": "Bearer " + os.environ["EAM_KEY"]}, timeout=30)
r.raise_for_status()
print(r.json()["tickets"])

Limites et erreurs

  • 120 requêtes au maximum par heure et par clé, 5 clés actives au maximum par compte. Les données changent avec les contrôles – une requête par heure suffit généralement.
  • 401 clé manquante, format incorrect ou révoquée · 403 compte inactif · 400 ressource inconnue · 405 GET uniquement · 429 trop de requêtes (en-tête Retry-After).
  • Seule la valeur SHA-256 de la clé est enregistrée ; chaque requête figure dans le journal des événements (SIEM, source « api »), la création et la révocation dans le journal du compte.
  • Ne placez pas la clé dans le code, mais dans une variable d’environnement ou un coffre-fort à secrets.

Référence : norme minimale TIC DE.CM (surveillance continue), ISO/IEC 27001:2022 A 8.16 (activités de surveillance) et A 5.17 (informations d’authentification).

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

Vérifier soi-même

Commandes de vérification sous Linux ou macOS. Remplacez ihre-domain.ch par votre domaine et ne vérifiez que vos propres systèmes.

curl -s -H 'Authorization: Bearer <schlüssel>' 'https://www.eam.ch/api.php/v1/findings?status=open'