easm.chWissen zur Angriffsfläche von aussen

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.

1 Min. Lesezeit · einfach erklärt und für Fachleute

Schema
  1. Ihr System
  2. Schlüssel, nur lesen
  3. Note, Befunde, Tickets
  4. 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.

RessourceInhalt
ratingGesamtnote und Punkte, je Kategorie und je Domain mit letztem Lauf
findingsBefunde mit Kennung, Domain, Kategorie, Kontrolle, Schwere, Titel, Objekt, Status, Zeitpunkten und Link; status=open (Vorgabe) oder all, lang=de|fr|it|en
assetsInventar: Hostnamen, Adressen, Dienste mit erstem und letztem Auftreten
ticketsNummer, Titel, Domain, Quelle, Priorität, Status, Fälligkeit, überfällig, Link
suppliersLieferanten mit Note, Bedeutung und Prüfstand
watchbeobachtete 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.
  • 401 Schlüssel fehlt, falsches Format oder widerrufen · 403 Konto nicht aktiv · 400 unbekannte Ressource · 405 nur GET · 429 zu viele Abfragen (Kopfzeile Retry-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'