Огляд інтеграцій
exoCortex під’єднується до систем, якими ти вже користуєшся: облікова система створює тікети через API, сповіщення моніторингу й безпеки стають тікетами, твій identity provider створює користувачів, а твій сайт містить форму звернення до підтримки.
Яка інтеграція тобі потрібна
Section titled “Яка інтеграція тобі потрібна”| Ти хочеш… | Використовуй | Посібник |
|---|---|---|
| Створювати тікети й стежити за ними зі своєї системи | REST API v1 з API-ключем | API-ключі |
| Отримувати подію, коли тікет змінюється | Вихідні вебхуки | Вихідні вебхуки |
| Перетворювати сповіщення моніторингу, DevOps чи безпеки на тікети | Вхідні вебхуки та конектори | Вхідні вебхуки |
| Синхронізувати тікети з іншою ITSM-системою | Інтеграції Integration Center | Вхідні вебхуки |
| Розмістити форму звернення до підтримки на своєму сайті | Віджет | Віджет |
| Створювати й деактивувати користувачів зі свого identity provider | SCIM 2.0 | Провізіонінг SCIM |
| Імпортувати дані з наявної системи | Import Hub | Integration Hub та імпорт |
Приклади коду і довідку з кожного ендпоінта див. у розділі Розробникам.
Адреса API
Section titled “Адреса API”Усі виклики надсилаються на https://exocortex-api.ai-exo-cortex.com. Кожна інтеграція працює лише з одним тенантом: тим, якому належить ключ, токен або конектор, яким ти користуєшся.
Безпека
Section titled “Безпека”- Кожні облікові дані прив’язані до одного тенанта і не бачать даних інших тенантів.
- API-ключі, секрети вебхуків і токени SCIM показуються лише один раз, коли ти їх створюєш: зберігай їх у менеджері секретів.
- Події, які exoCortex тобі надсилає, підписані, і так само мають бути підписані ті, що надсилаєш ти: підпис містить позначку часу і також захищає від повторних запитів.
- Функції керування (API-ключі, вебхуки, токени SCIM) потребують адміністратора в exoCortex Core: API-ключем не можна керувати іншими ключами.
Стабільність
Section titled “Стабільність”Поточна версія інтеграційного API — 1.1.0. У межах /api/v1 ми вносимо лише сумісні зміни: твій клієнт має ігнорувати поля, події та коди помилок, яких не знає. Застаріла функція працює щонайменше шість місяців після оголошення. Функції, застарілі сьогодні, перестануть працювати 30 червня 2027 року:
| Застаріла функція | Що використовувати замість |
|---|---|
API-ключі nh_… |
Ключі nhk.<keyid>.<secret> |
Підпис X-NH-Signature у вихідних вебхуках |
X-Exo-Signature з X-Exo-Timestamp |
Підпис X-NH-Connector-Signature у вхідних вебхуках |
X-Exo-Signature з X-Exo-Timestamp |
Поля event, timestamp, source у тілі вебхуків |
type, created_at, data |