Ключі інтеграції в Afina#

У цьому гайді ви навчитеся додавати, редагувати, шукати та видаляти ключі інтеграції в Afina. Цей розділ призначений для безпечного зберігання службових даних, які використовуються у скриптах, модулях, автоматизаціях і зовнішніх API.

Що таке ключі інтеграції#

Ключі інтеграції — це спеціалізована таблиця в Afina, призначена для зберігання й керування конфіденційними даними, такими як API-ключі, токени, паролі та інші службові значення.

Цей розділ працює як окреме сховище для технічних секретів, щоб відокремити конфіденційні дані від логіки роботи скриптів, модулів і автоматизацій.

Головна особливість цього інструменту — безпека. У стовпці «Значення» дані відображаються у замаскованому вигляді, що допомагає приховати чутливу інформацію від випадкового перегляду сторонніми особами.

Перехід у розділ#

1. Перейдіть у розділ Налаштування.
2. Відкрийте пункт Ключі інтеграції.

На скріншоті нижче показано, де саме знаходиться пункт Ключі інтеграції у лівій навігаційній панелі.

Додавання нового ключа#

1. Натисніть + Додати у верхній частині сторінки.
2. У вікні «Створити ключ/значення» заповніть дані ключа.
3. У полі «Назва» введіть ім'я, за яким ви будете ідентифікувати цей ключ.
4. У полі «Значення» введіть токен, пароль або інше службове значення.
5. Натисніть Зберегти.
6. Знайдіть потрібний запис у таблиці, якщо потрібно перевірити, що ключ збережено.

На наступному скріншоті показано сторінку «Ключі інтеграції» з кнопкою + Додати та відкрите модальне вікно «Створити ключ/значення» з полями «Назва» і «Значення», які потрібно заповнити перед збереженням.

Редагування ключа#

1. Знайдіть потрібний запис у таблиці.
2. У полі «Пошук...» введіть назву ключа, якщо потрібно швидко знайти конкретний рядок.
3. Натисніть іконку Редагувати у правій частині потрібного рядка.
4. У вікні «Редагувати ключ/значення» внесіть потрібні зміни.
5. Натисніть Зберегти.
6. Після успішного оновлення система покаже повідомлення «Ключ/значення успішно оновлено».

На цьому скріншоті показано таблицю ключів із полем «Пошук...», іконкою Редагувати у правій частині рядка та відкрите вікно «Редагувати ключ/значення» після натискання.

Видалення ключів#

1. Натисніть іконку Видалити у рядку ключа, якщо потрібно видалити один запис.
2. Позначте потрібні ключі чекбоксами у лівій частині таблиці, якщо потрібно підготувати їх до масового видалення.
3. Натисніть іконку Видалити на верхній панелі керування.
4. Натисніть Підтвердити у вікні підтвердження.

Щоб не видаляти ключ, натисніть Скасувати або закрийте вікно підтвердження.

На скріншоті нижче показано одиничне видалення через іконку Видалити у рядку потрібного ключа та масове видалення через вибрані чекбокси й іконку Видалити на верхній панелі керування.

Пошук, сортування й оновлення#

1. У полі «Пошук...» введіть назву ключа, якщо потрібно відфільтрувати список. Таблиця фільтрується одразу під час введення.
2. Щоб повернути повний список, очистьте поле через іконку очищення або видаліть текст вручну.
3. Натисніть заголовок стовпця Назва, якщо потрібно відсортувати записи за назвою.
4. Натисніть заголовок стовпця Значення, якщо потрібно відсортувати записи за значенням.
5. Натисніть заголовок стовпця повторно, щоб змінити напрям сортування.
6. Натисніть Оновити, якщо потрібно актуалізувати стан таблиці після змін.

На скріншоті нижче показано таблицю ключів із полем «Пошук...», заголовками стовпців Назва і Значення, а також кнопкою Оновити.

Де використовуються ключі#

У скриптах це основний сценарій використання. Замість того щоб вписувати токен прямо в блок скрипта, ви викликаєте його за назвою з таблиці. Це дає змогу швидко оновити токен для всіх сценаріїв, змінивши лише одне значення.

Наприклад, у компоненті «Введення» натисніть іконку вибору змінної праворуч від поля «Значення».

У списку змінних виберіть потрібний ключ інтеграції. Наприклад, якщо у вашій таблиці є ключ із назвою metamaskpass, виберіть його.

Після вибору в полі «Значення» з'явиться змінна у форматі ${metamaskpass}.

На скріншоті нижче показано, як саме ключі інтеграції підставляються в скрипті через поле «Значення».

У модулях їх використовують для безпечної передачі технічних параметрів без збереження токенів безпосередньо в коді. Якщо ви передаєте модуль іншому користувачу або команді, достатньо додати власний ключ під тією ж назвою у своїй таблиці.

В автоматизаціях і тригерах їх застосовують для взаємодії із зовнішнім середовищем, коли сценарій повинен виконувати авторизацію, передавати технічні параметри або працювати з зовнішніми сервісами.

Чутливі значення не передаються назовні у відкритому вигляді через API або MCP. Зовнішні скрипти й AI-інструменти можуть працювати з ключами за їхніми назвами, але не бачать самих значень. Розшифрування відбувається локально в екзекуторі безпосередньо перед запуском сценарію.

Суміжні інтеграційні налаштування#

Окрім таблиці «Ключі інтеграції», в основних налаштуваннях Afina є вкладки «API» та «Зовнішнє». Вони відповідають за окремі інтеграційні параметри.

На вкладці «API» задають API-ключ ChatGPT і токен Telegram-бота. Для ChatGPT також можна вказати окремий проксі у форматі proxy:port:login:password.

На вкладці «Зовнішнє» налаштовують дані для інтеграцій з іншими антидетект-браузерами: локальні посилання з портами для AdsPower і Dolphin, API-ключ Dolphin та Vision X-Token.

У технічній роботі з API реєстр key_entity зберігає лише імена ключів. Фактичні значення не лежать у цьому реєстрі й отримуються через запит до /api/accounts/vars. Для звернення до каталогу API-ключів і токенів використовується група ендпоінтів /api/keys/*.

Обмеження при використанні через API#

Під час роботи з ключами інтеграції через локальний API система вимагає заголовок x-api-key. Без нього запит не буде виконано, а з'єднання може бути розірвано.

Локальний HTTP-сервер Afina працює на порту 50778. Усі запити потребують x-api-key, крім GET /api/health та OAuth callback.

Політика CORS приймає запити лише з http://localhost, http://127.0.0.1 та внутрішнього протоколу tauri://. Виклики із зовнішніх вебсайтів блокуються політикою CORS.

Прямого доступу до API з іншого ПК немає: MCP-сервер і локальний API працюють локально, а дані не мають залишати пристрій.

Результат#

Після виконання цих дій ви зможете керувати ключами інтеграції в Afina з однієї таблиці: додавати нові значення, шукати потрібні записи, редагувати їх, сортувати список і безпечно видаляти непотрібні ключі.