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

Was ist die API?

Eine API (Programmierschnittstelle) ist ein Zugang für Programme statt für Menschen. Ihr SIEM, Ihr Ticketsystem oder ein Auswertungswerkzeug fragt eam.ch regelmässig ab und erhält die Daten in einem festen Format (JSON).

Wie ein Postfach, aus dem Ihr Buchhaltungsprogramm die Kontoauszüge selbst holt – statt dass jemand sie abtippt.

Wofür sie sich eignet

  • SIEM: neue Befunde neben anderen Sicherheitsereignissen sehen und Alarme auslösen.
  • Ticketsystem: offene Befunde oder Tickets abgleichen.
  • Auswertungen: die Note und ihren Verlauf in eigenen Berichten oder Dashboards zeigen.

Die API liefert Daten auf Abfrage. Sollen Meldungen sofort kommen, sobald etwas geschieht, eignen sich Webhooks besser.

Sicher und sparsam

  • Nur Lesen – über die API lässt sich nichts ändern.
  • Keine Personendaten: keine zuständigen Personen, keine externen Bearbeiter.
  • Ein Schlüssel je Anwendung. So können Sie einen einzelnen widerrufen, ohne die anderen zu stören.

So geht es mit eam.ch

  • Im Kundenbereich unter Konto → «Schnittstellen» → «API-Schlüssel verwalten» (Hauptbenutzer) einen Schlüssel mit Bezeichnung erstellen.
  • Den Schlüssel sofort kopieren und in Ihrer Anwendung sicher hinterlegen – er wird nur einmal angezeigt.
  • Die Anwendung schickt ihn bei jeder Abfrage mit (siehe «Für Fachleute»).
  • Nicht mehr gebraucht oder Verdacht auf Missbrauch: Schlüssel widerrufen.

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