# Ключі API — який ключ під яку задачу

> Готові набори прав під типові задачі — звіти, сертифікати, DNS, ШІ-агент, покупки — і правила, за якими людина чи асистент ШІ підбирає ключ.

URL: https://zrazu.com/docs/api-key-recipes/

Ця сторінка — для вас і для асистента ШІ, який допомагає налаштувати ключ. Знайдіть свою задачу в таблиці, виберіть у формі [«Новий ключ»](https://vse.zrazu.com/team/api-keys/) указаний шаблон і заповніть «Де діє» та «Умови», як написано. Як працює сама форма — у [ключах API](https://zrazu.com/docs/api-keys.md).

## Задача → ключ

| Задача | Шаблон у формі | Права | Де діє | Умови |
| --- | --- | --- | --- | --- |
| Скрипт чи дашборд читає домени й строки | «Тільки читання» | `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. **Перевірка.** Після випуску:

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

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

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

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