API і MCP
Ключі API — який ключ під яку задачу
Готові набори прав під типові задачі — звіти, сертифікати, DNS, ШІ-агент, покупки — і правила, за якими людина чи асистент ШІ підбирає ключ.
Ця сторінка — для вас і для асистента ШІ, який допомагає налаштувати ключ. Знайдіть свою задачу в таблиці, виберіть у формі «Новий ключ» указаний шаблон і заповніть «Де діє» та «Умови», як написано. Як працює сама форма — у ключах API.
Задача → ключ
| Задача | Шаблон у формі | Права | Де діє | Умови |
|---|---|---|---|---|
| Скрипт чи дашборд читає домени й строки | «Тільки читання» | domain.read, monitor.read | усі домени | IP — за бажанням, строк до 365 днів |
| Бухгалтерія чи звіт бачить баланс | «Баланс і домени» | domain.read, billing.read | усі домени | IP — за бажанням, строк до 365 днів |
| Програма ставить домени на моніторинг | «Моніторинг» | monitor.read, monitor.edit | усі домени або вибрані | IP сервера, 90 днів |
| Сервер сам оновлює файли сертифіката | «Сертифікати SSL» | ssl.read, ssl.reissue | лише домени цього сервера | IP сервера, 90 днів |
| Програма замовляє сертифікати | «SSL — замовлення» | ssl.read, ssl.reissue, ssl.order, billing.read | вибрані домени або всі | IP обов'язково, денний ліміт (для всіх доменів — обов'язково), 30 днів |
| Менеджер чи підрядник правлять записи кількох сайтів | «Зони DNS — для менеджера» | dns.read, dns.edit | лише вибрані домени | особистий ключ, 90 днів |
| ШІ-агент чи автоматизація ведуть усі зони | «Зони DNS — повний доступ» | dns.read, dns.edit, dns.zone_create, keys.zones_grant | усі домени | ключ організації, IP сервера, 90 днів |
| Продовження за розкладом | «Продовження доменів» | domain.read, domain.renew, billing.read | усі домени або вибрані | IP обов'язково, денний ліміт, 30 днів |
| Реєстрація нових доменів | «Реєстрація доменів» | domain.read, domain.register, billing.read | усі домени | IP обов'язково, денний ліміт, 30 днів |
| Агент веде домен від покупки до записів DNS | «Домени й DNS — для ШІ» | реєстрація, продовження, усі права DNS, крім видачі зон, і баланс | усі домени | IP обов'язково, денний ліміт, 30 днів |
Шаблон лише заповнює права. Їх можна прибрати чи додати рядком у формі «Що дозволити ключу».
«Зони DNS — повний доступ» реєструвати домени не дозволяє. Нову зону цей ключ створює для домену, який уже є в організації, або для чужого імені, яке ви переведете на наші сервери імен. Для домену, якого ще немає, спершу потрібна реєстрація.
Один ключ чи два
Агенту, який і купує домени, і веде DNS, краще дати два ключі:
- Ключ DNS — «Зони DNS — повний доступ», строк 90 днів і більше.
- Ключ на покупки — «Реєстрація доменів» або «Продовження доменів», строк 30 днів, денний ліміт на 1–2 домени.
Якщо ключ на покупки витече, втрата обмежена денним лімітом і короткий ключ скоро вимкнеться сам. Ключ DNS при цьому балансу не торкнеться. Шаблон «Домени й DNS — для ШІ» простіший, але живе не довше 90 днів, і при витоку під ударом і записи, і гроші.
Як підбирати ключ — правила для людини й асистента ШІ
Спершу задача, потім права. Що програма робитиме, з якими доменами, з якого сервера. Права — найменші, що закривають задачу: рівень «Читання», якщо зміни не потрібні.
Гроші — окремим ключем. Права
ssl.order,domain.renewіdomain.registerвимагають дозволених IP, строк такого ключа — не більше 90 днів. Денний ліміт обов'язковий для продовження й реєстрації і для будь-якого ключа з грошима на всі домени; ставте його завжди. Ключ для реєстрації візьме власником лише запис «Контактів» з повною адресою й позначкою повноважень: заведіть його до випуску ключа, а форма ключа попередить, якщо такого запису ще немає.Чий ключ. Для сервера, CI чи інтеграції — «Організації»: він переживе зміну людей. Для себе чи свого асистента на своєму комп'ютері — «Особистий».
Дозволені IP — адреса, звідки йдуть виклики. Для сервера — адреса сервера. Для асистента на вашому комп'ютері — адреса комп'ютера: форма показує її під полем і додає кнопкою «Додати». Домашня адреса може змінюватися — тоді ключ перестане працювати, і адресу треба оновити.
Домени — вибрані, коли можна. Менеджеру й серверу сертифіката досить своїх доменів. На всі домени діють лише нові зони, видача зон іншим ключам і реєстрація нових імен.
Кілька організацій. Особистий ключ — «Ця й вибрані»; на «Усі мої організації» — лише права читання. Ключ, що витрачає гроші, і ключ організації діють в одній організації.
Строк — короткий. Ключ, який 90 днів ніхто не викликав, вимикається сам. Задача закінчилась — відкличте ключ.
Ключ — лише в секрети. Не в чат, не в код сторінок, не в репозиторій. Асистентові ШІ — через змінну середовища чи файл секретів, не текстом повідомлення.
Перевірка. Після випуску:
curl -H "Authorization: Bearer zr_live_..." https://api.zrazu.com/v1/api-keys/currentВідповідь покаже права, домени, IP і строк. Якщо чогось бракує — випустіть новий ключ із потрібними правами; змінити права наявного ключа не можна.
Чого не дасть жоден ключ
Змінювати контакти й замки, отримувати код перенесення, відкликати сертифікати, керувати людьми, ключами й оплатою. Ці дії є лише в кабінеті. Асистенту не варто радити шукати для цього права — їх немає.