Il Libraesva Email Security Gateway espone un insieme di Application Programming Interface.
Le API sono sempre disponibili, l'elenco di tutte le API disponibili si trova all'interno di ESG al percorso /api/v2/ dopo l'autenticazione.
Esempio: demo.esvacloud.com/api/v2/
Puoi interagire con le API direttamente dalla pagina della documentazione autenticandoti con il pulsante "Authorize" in alto a destra della pagina; questa autenticazione richiede un API Token valido.
Per generare un API Token e' necessario effettuare un login sull'endpoint /api/v2/login, che restituira' un API Token valido utilizzabile per effettuare altre chiamate API.
L'API Token generato erediterà i permessi dell'Utente specificato per effettuare l'autenticazione sull'endpoint /login, se si tratta di un normale Utente (presente nella tabella "User Management -> Users").
Per effettuare una chiamata API dopo il login devi passare l'API Token nell'header "X-ESG-Auth-Token".
Se l'autenticazione viene effettuata con un API User ("User Management -> API Users"), dopo il /login iniziale per generare l'API Token devi specificare un ESG User da impersonare tramite l'header "X-Switch-User".
In questo Header devi specificare lo username dell'ESG User da impersonare; l'API User che effettua la chiamata eredita i permessi dell'utente specificato per questa chiamata API. Non specificare un utente comportera' un errore 403: l'API User non ha permessi di default e puo' effettuare solo la chiamata /login.
Qui sotto puoi vedere gli header che devono essere compilati quando premi il pulsante "Authorize" per effettuare chiamate API direttamente dall'interno di ESG.
