Ключи провайдера позволяют использовать учетные записи собственных поставщиков моделей вместо моделей, маршрутизируемых через Coroid. Оплата за их использование производится непосредственно этим провайдером по тарифам, оговоренным в ваших договорах.
Управляйте ими в разделе Настройки → Ключи провайдера.
Когда стоит использовать собственные ключи
Режим BYOK целесообразен, если у вас уже заключены договоры с провайдерами, предусмотрены фиксированные расходы или требования к закупкам, согласно которым поставщик моделей должен быть прямым контрагентом.
Если ни одно из этих условий не выполняется, проще использовать модели, маршрутизируемые через Coroid, с предоплаченными кредитами, при этом Coroid не добавляет никаких наценок к тарифам провайдера в любом случае. Выбор между этими вариантами зависит от особенностей заключения договоров, а не от цены.
Как обрабатываются ключи
- Они шифруются при хранении.
- Их никогда не возвращают. После сохранения ключ нельзя прочитать через интерфейс или через API. Его можно заменить, но восстановить — нет.
- Их никогда не экспортируют. В архивах экспорта настроек указывается лишь плейсхолдер, а не сам секретный ключ. Подробнее в разделе Экспорт и импорт настроек.
Такое поведение — результат осознанного решения: учетные данные, которые можно прочитать обратно, могут быть утечь при наличии у кого-либо прав на чтение.
Ротация ключей
Замените старый ключ на новый. Текущие задачи продолжат выполняться по уже установленному соединению, а новые задачи будут использовать новый ключ.
Проводите ротацию по графику вашего провайдера и при увольнении сотрудника с правами администратора. Определить через Coroid, использовался ли ключ где-то еще, невозможно — для этого существует журнал аудита самого провайдера.
Ограничение доступа
Если ваш провайдер поддерживает ключи с ограниченным доступом или заданными параметрами, используйте именно такие ключи. Ключ, ограниченный моделями и лимитом расходов, предназначенными для работы с Coroid, представляет гораздо меньшую угрозу в случае его утечки.
Установите лимит расходов непосредственно у провайдера. Это единственный жесткий лимит — ограничения самого Coroid касаются только производительности, а не счета вашего провайдера.
Переход на запасной вариант
Если ключ недействителен, истек срок его действия или превышен лимит провайдера, запросы к моделям с его использованием завершатся ошибкой. Работа не продолжится автоматически через другого провайдера — это было бы неприемлемо, ведь речь идет о чужих средствах.
Исправьте ключ, и отложенные задачи возобновятся.