API: eam.ch-Daten in SIEM, Ticketsystem und Auswertungen
Über die API lesen Ihre eigenen Anwendungen Note, Befunde, Inventar, Tickets und Lieferanten – automatisch und ohne Export von Hand.
- Ihr System
- Schlüssel, nur lesen
- Note, Befunde, Tickets
- Automatische Auswertung
Abfrage
GET https://www.eam.ch/api.php?r=<Ressource> mit Kopfzeile Authorization: Bearer eamk_…. Antwort JSON mit v (Version 1), resource, generated_at (UTC) und tenant.
| Ressource | Inhalt |
|---|---|
rating | Gesamtnote und Punkte, je Kategorie und je Domain mit letztem Lauf |
findings | Befunde mit Kennung, Domain, Kategorie, Kontrolle, Schwere, Titel, Objekt, Status, Zeitpunkten und Link; status=open (Vorgabe) oder all, lang=de|fr|it|en |
assets | Inventar: Hostnamen, Adressen, Dienste mit erstem und letztem Auftreten |
tickets | Nummer, Titel, Domain, Quelle, Priorität, Status, Fälligkeit, überfällig, Link |
suppliers | Lieferanten mit Note, Bedeutung und Prüfstand |
watch | beobachtete Domains mit Registrierung, Mail, Website, Ablauf und Einschätzung |
Beispiele
curl
curl -H "Authorization: Bearer eamk_…" "https://www.eam.ch/api.php?r=findings&status=open&lang=de"
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"])
Grenzen und Fehler
- Höchstens 120 Abfragen je Stunde und Schlüssel, höchstens 5 aktive Schlüssel je Konto. Die Daten ändern sich mit den Prüfläufen – eine Abfrage pro Stunde genügt meist.
401Schlüssel fehlt, falsches Format oder widerrufen ·403Konto nicht aktiv ·400unbekannte Ressource ·405nur GET ·429zu viele Abfragen (KopfzeileRetry-After).- Gespeichert wird nur der SHA-256-Wert des Schlüssels; jede Abfrage steht im Ereignisprotokoll (SIEM, Quelle «api»), Erstellen und Widerrufen im Protokoll des Kontos.
- Den Schlüssel nicht im Programmcode ablegen, sondern in einer Umgebungsvariablen oder einem Tresor für Geheimnisse.
Bezug: IKT-Minimalstandard DE.CM (laufende Überwachung), ISO/IEC 27001:2022 A 8.16 (Überwachung) und A 5.17 (Authentisierungsinformationen).
Kurz zusammengefasst
- Über die API lesen eigene Anwendungen Note, Befunde, Inventar, Tickets, Lieferanten und beobachtete Domains.
- Nur Lesen, keine Personendaten, ein Schlüssel je Anwendung.
- Höchstens 120 Abfragen je Stunde und Schlüssel.
- Schlüssel unter Konto → Schnittstellen → API-Schlüssel (Hauptbenutzer).
Selbst prüfen
Befehle zum Nachprüfen auf Linux oder macOS. Ersetzen Sie ihre-domain.ch durch Ihre Domain und prüfen Sie nur eigene Systeme.
# Offene Befunde als JSON
curl -s -H 'Authorization: Bearer <schlüssel>' 'https://www.eam.ch/api.php/v1/findings?status=open'