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.
- Votre système
- Clé, lecture seule
- Note, constats, tickets
- É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.
| Ressource | Contenu |
|---|---|
rating | note globale et points, par catégorie et par domaine avec dernier contrôle |
findings | constats 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 |
assets | inventaire : noms d’hôtes, adresses, services avec première et dernière apparition |
tickets | numéro, titre, domaine, source, priorité, statut, échéance, en retard, lien |
suppliers | fournisseurs avec note, importance et état du contrôle |
watch | domaines 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.
401clé manquante, format incorrect ou révoquée ·403compte inactif ·400ressource inconnue ·405GET uniquement ·429trop de requêtes (en-têteRetry-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'