У розділі Налаштування › Доступ до API ви можете створити особисті токени доступу, щоб скрипт або MCP-клієнт міг використовувати Dvina від вашого імені. Там само адміністратори додають вебхуки, щоб надсилати події Livespace до власних систем.
Доступ до API входить до плану Enterprise. Кожен учасник може створювати власні токени; розділ Вебхуки бачать лише власники й адміністратори.
Створення токена
- Відкрийте Налаштування та виберіть Доступ до API.
- У розділі Особисті токени доступу виберіть Створити токен.
- Введіть Назву, щоб згодом знати, де використовується токен.
- Виберіть Доступ: Лише читання або Читання та запис.
- Виберіть, коли Термін дії закінчується: Через 30 днів, Через 90 днів, Через 365 днів або Безстроково.
- Виберіть Створити токен.
- У розділі Скопіюйте свій токен скопіюйте токен і збережіть його в безпечному місці. Він відображається лише один раз.
Токен діє від вашого імені в тому Livespace, де ви його створили, з вашою поточною роллю в ньому. Токен із доступом Лише читання дає змогу читати, але не додавати чи змінювати будь-що.
Щоб використовувати токен із MCP-клієнтом, див. Підключення за допомогою ключа API замість OAuth.
Перевірка, заміна або відкликання токена
Ваші токени перелічено в розділі Особисті токени доступу із зазначенням їхнього доступу. Виберіть токен, щоб переглянути поля Починається з, Доступ, Востаннє використано та Термін дії закінчується.
- Щоб замінити токен, виберіть Замінити…, а потім Замінити для підтвердження. Новий токен замінить старий, і старий одразу перестане працювати. Скопіюйте новий токен у розділі Скопіюйте свій токен.
- Щоб припинити дію токена, виберіть Відкликати…, а потім Відкликати для підтвердження. Усе, що використовує цей токен, одразу перестане працювати.
Створення, заміна й відкликання токена фіксуються в журналі аудиту.
Додавання вебхука
Вебхук надсилає події Livespace — ті самі записи, що й у журналі аудиту, — на вибрану вами адресу.
- У Налаштуваннях › Доступ до API, у розділі Вебхуки, виберіть Додати вебхук.
- Введіть Назву та URL. Використовуйте загальнодоступну HTTPS-адресу.
- Залиште поле Події порожнім, щоб отримувати всі події, або вкажіть дії та області, наприклад
member.addedчиsharing.*. - Виберіть Додати.
- У розділі Скопіюйте секрет підпису скопіюйте секрет. Він відображається лише один раз.
Якщо Dvina повідомляє Ця адреса недоступна з Dvina, використовуйте загальнодоступну HTTPS-адресу.
Перевірка підпису кожного запиту
Dvina надсилає події пакетами у форматі JSON і підписує кожен запит. Використовуйте секрет підпису, щоб перевірити, чи запит надійшов від Dvina:
- Кожен запит має заголовок
X-Dvina-Signatureу форматіt=<timestamp>,v1=<signature>. - Підпис — це HMAC-SHA256 у шістнадцятковому форматі, обчислений для часової позначки, крапки та тіла запиту за допомогою вашого секрету підпису.
- Обчисліть підпис самостійно та порівняйте. Відхиляйте запити, якщо підпис не збігається або часова позначка надто давня.
Перевірка або зміна вебхука
Ваші вебхуки відображаються в розділі Вебхуки зі статусом: Увімкнено, Призупинено або Помилка. Виберіть вебхук, щоб переглянути його відомості.
- Щоб змінити вебхук, відредагуйте його Назву, URL або Події, а потім виберіть Зберегти.
- Щоб призупинити вебхук, вимкніть Надсилати події. Увімкніть цей параметр знову, щоб відновити надсилання.
- Щоб перевірити роботу вебхука, перегляньте його Статус і кількість подій у полі Надіслано. Якщо вебхук працює з помилками, відображається його Остання помилка. Dvina продовжує спроби надсилання та записує збій у журнал аудиту.
- Щоб змінити секрет вебхука, виберіть Новий секрет підпису…, а потім підтвердьте зміну. Запити одразу підписуються новим секретом, тому негайно оновіть його на стороні отримувача.
- Щоб видалити вебхук, виберіть Видалити…, а потім Видалити для підтвердження. Після цього до нього більше нічого не надсилається.