Vue d'ensemble des intégrations
exoCortex se connecte aux systèmes que vous utilisez déjà : un logiciel de gestion ouvre des tickets via l’API, les alertes de supervision et de sécurité deviennent des tickets, votre fournisseur d’identité crée les utilisateurs, votre site héberge le formulaire d’assistance.
De quelle intégration avez-vous besoin ?
Section intitulée « De quelle intégration avez-vous besoin ? »| Vous voulez… | Utilisez | Guide |
|---|---|---|
| Ouvrir et suivre des tickets depuis l’un de vos systèmes | API REST v1 avec une clé API | Clés API |
| Recevoir un événement lorsqu’un ticket change | Webhooks sortants | Webhooks sortants |
| Transformer des alertes de supervision, DevOps ou de sécurité en tickets | Webhooks entrants et connecteurs | Webhooks entrants |
| Synchroniser les tickets avec un autre ITSM | Intégrations de l’Integration Center | Webhooks entrants |
| Placer un formulaire d’assistance sur votre site | Widget | Widget |
| Créer et désactiver les utilisateurs depuis votre fournisseur d’identité | SCIM 2.0 | Provisionnement SCIM |
| Importer des données depuis un système existant | Import Hub | Integration Hub et import |
Pour les exemples de code et la référence de chaque endpoint, consultez la section Développeurs.
Adresse de l’API
Section intitulée « Adresse de l’API »Tous les appels vont à https://exocortex-api.ai-exo-cortex.com. Chaque intégration travaille sur un seul tenant : celui de la clé, du jeton ou du connecteur que vous utilisez.
Sécurité
Section intitulée « Sécurité »- Chaque identifiant est lié à un tenant et ne voit pas les données des autres tenants.
- Les clés API, les secrets des webhooks et les jetons SCIM ne sont affichés qu’une seule fois, lors de leur création : conservez-les dans un gestionnaire de secrets.
- Les événements qu’exoCortex vous envoie sont signés, et ceux que vous envoyez doivent l’être aussi : la signature inclut un horodatage et protège aussi contre les requêtes rejouées.
- Les fonctions de gestion (clés API, webhooks, jetons SCIM) exigent un administrateur dans exoCortex Core : une clé API ne permet pas de gérer d’autres clés.
Stabilité
Section intitulée « Stabilité »La version actuelle de l’API d’intégration est la 1.1.0. Dans /api/v1, nous n’apportons que des modifications compatibles : votre client doit ignorer les champs, les événements et les codes d’erreur qu’il ne connaît pas. Une fonction dépréciée reste active au moins six mois après son annonce. Les fonctions dépréciées aujourd’hui cesseront de fonctionner le 30 juin 2027 :
| Fonction dépréciée | À utiliser à la place |
|---|---|
Clés API nh_… |
Clés nhk.<keyid>.<secret> |
Signature X-NH-Signature sur les webhooks sortants |
X-Exo-Signature avec X-Exo-Timestamp |
Signature X-NH-Connector-Signature sur les webhooks entrants |
X-Exo-Signature avec X-Exo-Timestamp |
Champs event, timestamp, source dans le corps des webhooks |
type, created_at, data |