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 днів, і при витоку під ударом і записи, і гроші.

Як підбирати ключ — правила для людини й асистента ШІ

  1. Спершу задача, потім права. Що програма робитиме, з якими доменами, з якого сервера. Права — найменші, що закривають задачу: рівень «Читання», якщо зміни не потрібні.

  2. Гроші — окремим ключем. Права ssl.order, domain.renew і domain.register вимагають дозволених IP, строк такого ключа — не більше 90 днів. Денний ліміт обов'язковий для продовження й реєстрації і для будь-якого ключа з грошима на всі домени; ставте його завжди. Ключ для реєстрації візьме власником лише запис «Контактів» з повною адресою й позначкою повноважень: заведіть його до випуску ключа, а форма ключа попередить, якщо такого запису ще немає.

  3. Чий ключ. Для сервера, CI чи інтеграції — «Організації»: він переживе зміну людей. Для себе чи свого асистента на своєму комп'ютері — «Особистий».

  4. Дозволені IP — адреса, звідки йдуть виклики. Для сервера — адреса сервера. Для асистента на вашому комп'ютері — адреса комп'ютера: форма показує її під полем і додає кнопкою «Додати». Домашня адреса може змінюватися — тоді ключ перестане працювати, і адресу треба оновити.

  5. Домени — вибрані, коли можна. Менеджеру й серверу сертифіката досить своїх доменів. На всі домени діють лише нові зони, видача зон іншим ключам і реєстрація нових імен.

  6. Кілька організацій. Особистий ключ — «Ця й вибрані»; на «Усі мої організації» — лише права читання. Ключ, що витрачає гроші, і ключ організації діють в одній організації.

  7. Строк — короткий. Ключ, який 90 днів ніхто не викликав, вимикається сам. Задача закінчилась — відкличте ключ.

  8. Ключ — лише в секрети. Не в чат, не в код сторінок, не в репозиторій. Асистентові ШІ — через змінну середовища чи файл секретів, не текстом повідомлення.

  9. Перевірка. Після випуску:

curl -H "Authorization: Bearer zr_live_..." https://api.zrazu.com/v1/api-keys/current

Відповідь покаже права, домени, IP і строк. Якщо чогось бракує — випустіть новий ключ із потрібними правами; змінити права наявного ключа не можна.

Чого не дасть жоден ключ

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

Ця сторінка в Markdown