Серверный API-ключ стоит менять, если он мог попасть к посторонним, если из команды ушёл сотрудник с доступом к ключу, или просто регулярно — в целях безопасности. Чтобы приложение не перестало отправлять письма, сначала выпустите новый ключ, а старый отзовите только после того, как перейдёте на новый.
- Откройте SMTP-серверы и выберите нужный сервер.
- Перейдите на вкладку API-ключи.
- В блоке Выпустить новый ключ введите название, например имя приложения, в котором будет работать ключ, и выберите срок действия.
- Нажмите Выпустить ключ и скопируйте значение — оно показывается сразу после выпуска.
- Замените старый ключ на новый во всех приложениях и интеграциях, которые отправляют письма через этот сервер.
- Убедитесь, что письма уходят, и нажмите Отозвать напротив старого ключа.
После отзыва ключ перестаёт работать сразу: все запросы с ним получат ошибку 10 «Неверный API-ключ».
Срок действия и лимит
При выпуске ключа можно выбрать срок: бессрочно, 30 дней, 90 дней или 1 год. Ключ с ограниченным сроком перестаёт работать в дату из столбца «Действует до», поэтому выпускайте замену заранее.
В аккаунте может быть до 10 активных серверных ключей — это общий лимит для всех серверов. Если лимит исчерпан, отзовите неиспользуемый ключ. Если значение ключа понадобится снова, нажмите Показать — кабинет попросит подтвердить действие одноразовым кодом.
Подробнее о ключах — в статье «Типы ключей. API-ключи, SMTP-ключи».