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

> Готовые наборы прав под типовые задачи — отчёты, сертификаты, DNS, ИИ-агент, покупки — и правила, по которым человек или ассистент ИИ подбирает ключ.

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

Эта страница — для вас и для ассистента ИИ, который помогает настроить ключ. Найдите свою задачу в таблице, выберите в форме [«Новый ключ»](https://vse.zrazu.com/team/api-keys/) указанный шаблон и заполните «Где действует» и «Условия», как написано. Как работает сама форма — в [ключах API](https://zrazu.com/ru/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 и срок. Если чего-то не хватает — выпустите новый ключ с нужными правами; изменить права существующего ключа нельзя.

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

Менять контакты и замки, получать код переноса, отзывать сертификаты, управлять людьми, ключами и оплатой. Эти действия есть только в кабинете. Ассистенту не стоит советовать искать для этого права — их нет.
