easm.chCapire la superficie d’attacco esterna

API: dati di eam.ch in SIEM, sistema di ticket e analisi

Tramite l’API le sue applicazioni leggono nota, riscontri, inventario, ticket e fornitori – automaticamente e senza esportazioni manuali.

1 min di lettura · spiegato in modo semplice e per specialisti

Schema
  1. Il vostro sistema
  2. Chiave, sola lettura
  3. Nota, riscontri, ticket
  4. Valutazione automatica

Richiesta

GET https://www.eam.ch/api.php?r=<risorsa> con l’intestazione Authorization: Bearer eamk_…. Risposta JSON con v (versione 1), resource, generated_at (UTC) e tenant.

RisorsaContenuto
ratingnota complessiva e punti, per categoria e per dominio con ultimo controllo
findingsriscontri con identificativo, dominio, categoria, controllo, gravità, titolo, oggetto, stato, date e link; status=open (predefinito) o all, lang=de|fr|it|en
assetsinventario: nomi host, indirizzi, servizi con prima e ultima comparsa
ticketsnumero, titolo, dominio, fonte, priorità, stato, scadenza, in ritardo, link
suppliersfornitori con nota, importanza e stato del controllo
watchdomini osservati con registrazione, posta, sito web, scadenza e valutazione

Esempi

curl

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

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"])

Limiti ed errori

  • Al massimo 120 richieste all’ora per chiave, al massimo 5 chiavi attive per conto. I dati cambiano con i controlli – di solito basta una richiesta all’ora.
  • 401 chiave mancante, formato errato o revocata · 403 conto non attivo · 400 risorsa sconosciuta · 405 solo GET · 429 troppe richieste (intestazione Retry-After).
  • Viene salvato solo il valore SHA-256 della chiave; ogni richiesta figura nel registro degli eventi (SIEM, fonte «api»), creazione e revoca nel registro del conto.
  • Non metta la chiave nel codice, ma in una variabile d’ambiente o in una cassaforte per segreti.

Riferimento: standard minimo TIC DE.CM (monitoraggio continuo), ISO/IEC 27001:2022 A 8.16 (attività di monitoraggio) e A 5.17 (informazioni di autenticazione).

In breve

  • Tramite l’API le sue applicazioni leggono nota, riscontri, inventario, ticket, fornitori e domini osservati.
  • Solo lettura, nessun dato personale, una chiave per applicazione.
  • Al massimo 120 richieste all’ora per chiave.
  • Chiavi in Conto → Interfacce → Chiavi API (utenti principali).

Verificare da sé

Comandi per verificare su Linux o macOS. Sostituite ihre-domain.ch con il vostro dominio e verificate solo sistemi propri.

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