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