Panoramica delle integrazioni
exoCortex si collega ai sistemi che usi già: un gestionale apre ticket via API, gli allarmi di monitoraggio e sicurezza diventano ticket, il tuo identity provider crea gli utenti, il tuo sito ospita il modulo di assistenza.
Quale integrazione ti serve
Sezione intitolata “Quale integrazione ti serve”| Vuoi… | Usa | Guida |
|---|---|---|
| Aprire e seguire ticket da un tuo sistema | REST API v1 con una chiave API | Chiavi API |
| Ricevere un evento quando un ticket cambia | Webhook in uscita | Webhook in uscita |
| Trasformare allarmi di monitoraggio, DevOps o sicurezza in ticket | Webhook in entrata e connettori | Webhook in entrata |
| Sincronizzare i ticket con un altro ITSM | Integrazioni dell’Integration Center | Webhook in entrata |
| Mettere un modulo di assistenza sul tuo sito | Widget | Widget |
| Creare e disattivare gli utenti dal tuo identity provider | SCIM 2.0 | Provisioning SCIM |
| Importare dati da un sistema esistente | Import Hub | Integration Hub e import |
Per gli esempi di codice e la reference di ogni endpoint vedi la sezione Sviluppatori.
Indirizzo dell’API
Sezione intitolata “Indirizzo dell’API”Tutte le chiamate vanno a https://exocortex-api.ai-exo-cortex.com. Ogni integrazione lavora su un solo tenant: quello della chiave, del token o del connettore che usi.
Sicurezza
Sezione intitolata “Sicurezza”- Ogni credenziale è legata a un tenant e non vede i dati degli altri tenant.
- Le chiavi API, i segreti dei webhook e i token SCIM sono mostrati una sola volta, quando li crei: conservali in un gestore di segreti.
- Gli eventi che exoCortex ti invia sono firmati, e così devono esserlo quelli che invii tu: la firma include un timestamp e protegge anche dalle richieste ripetute.
- Le funzioni di gestione (chiavi API, webhook, token SCIM) richiedono un amministratore in exoCortex Core: con una chiave API non si gestiscono altre chiavi.
Stabilità
Sezione intitolata “Stabilità”La versione attuale dell’API di integrazione è la 1.1.0. Dentro /api/v1 facciamo solo modifiche compatibili: il tuo client deve ignorare campi, eventi e codici di errore che non conosce. Una funzione deprecata resta attiva per almeno sei mesi dall’annuncio. Le funzioni deprecate oggi smettono di funzionare il 30 giugno 2027:
| Funzione deprecata | Cosa usare |
|---|---|
Chiavi API nh_… |
Chiavi nhk.<keyid>.<secret> |
Firma X-NH-Signature sui webhook in uscita |
X-Exo-Signature con X-Exo-Timestamp |
Firma X-NH-Connector-Signature sui webhook in entrata |
X-Exo-Signature con X-Exo-Timestamp |
Campi event, timestamp, source nel corpo dei webhook |
type, created_at, data |