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.
- Il vostro sistema
- Chiave, sola lettura
- Nota, riscontri, ticket
- 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.
| Risorsa | Contenuto |
|---|---|
rating | nota complessiva e punti, per categoria e per dominio con ultimo controllo |
findings | riscontri con identificativo, dominio, categoria, controllo, gravità, titolo, oggetto, stato, date e link; status=open (predefinito) o all, lang=de|fr|it|en |
assets | inventario: nomi host, indirizzi, servizi con prima e ultima comparsa |
tickets | numero, titolo, dominio, fonte, priorità, stato, scadenza, in ritardo, link |
suppliers | fornitori con nota, importanza e stato del controllo |
watch | domini 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.
401chiave mancante, formato errato o revocata ·403conto non attivo ·400risorsa sconosciuta ·405solo GET ·429troppe richieste (intestazioneRetry-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'