Аккаунт и магазин не одно и то же
Аккаунт даёт владельцу вход в кабинет. В нём могут быть сайты с собственными доменами и настройками. Каталог, публичный ключ и секрет интеграции относятся к конкретному сайту. Перед любым изменением проверьте домен, показанный в «Настройках» (/lk/settings), и домен возле токена.
Поиск и консультант включаются для сайта отдельно. Наличие аккаунта, ключа или установленного модуля не доказывает, что оба продукта доступны. Если модуль показывает, что консультант не подключён, установка галочки чата на витрине этого не исправит.
Какие ключи где использовать
| Данные | Назначение | Как обращаться |
|---|---|---|
Public key, YOUR_PUBLIC_KEY в примерах |
Идентификатор сайта для браузерного виджета | Допустим в HTML; не даёт доступ владельца в кабинет |
Integration key, ik_… |
Секрет сайта для серверного подключения | Только настройки сервера или модуля; не HTML и не снимок экрана |
| «Токены интеграции» | Отдельные серверные API-токены для сайта | Каждый хранить как секрет; выпуск и отзыв выполняются отдельно |
| Пароль и коды восстановления | Вход владельца в кабинет | Не передавать модулю и не использовать как API-ключ |
Токены из одноимённого раздела имеют права search и reindex; в форме выпуска нет выбора произвольных прав. Не считайте их автоматически тем же значением, что Integration key: формат выданного токена может отличаться. Используйте ключ, требуемый вашим подключением. Для поля «Ключ Anmarto» ориентируйтесь на секрет сайта ik_…, а не на публичный ключ виджета.
Первичная настройка
- Войдите в аккаунт владельца и откройте «Настройки» (
/lk/settings). Если подключение начато в Битриксе, завершите подтверждение почты по письму. - Сверьте домен магазина. Не переносите ключ другого сайта даже при общем владельце.
- Проверьте профиль: имя и электронную почту. Почта здесь является логином, поэтому меняйте её только на адрес, к которому сохраняется доступ.
- Найдите «Ключи интеграции». Публичный ключ используйте в коде виджета; секретный ключ сохраните в защищённом хранилище при получении.
- Если для серверного API нужен отдельный токен, в «Токенах интеграции» нажмите «Выпустить для …» возле нужного домена. Скопируйте значение сразу: повторно оно не показывается.
- Введите серверный секрет в предназначенную для него настройку интеграции. Для Битрикса проверьте сообщение принятого ключа и домен сайта.
- Выполните небольшую проверку: связь модуля, выгрузка контрольного товара, поиск на витрине. Не публикуйте ключ вместе с результатом проверки.
- Защитите вход: в «Вход в кабинет» нажмите «Включить», добавьте QR-код в приложение одноразовых кодов и нажмите «Подтвердить» после ввода кода.
Замена и отзыв без неожиданностей
Кнопка «Перевыпустить ключ» заменяет Integration key: старое значение перестаёт работать сразу. До подтверждения соберите список модулей и скриптов, использующих его. После выпуска сохраните новый секрет, обновите эти подключения и повторно проверьте связь. Не используйте перевыпуск как обычную кнопку просмотра.
Выпуск отдельного API-токена не отзывает предыдущие токены. Для плановой замены сначала выдайте новый, перенастройте соответствующий клиент, проверьте работу и только затем нажмите «Отозвать» у старого. Отзыв отключает все подключения, в которых использовано именно это значение. При подозрении на утечку отзывайте скомпрометированный секрет без ожидания и восстанавливайте связь новым.
Вход и диагностика
Двухфакторная защита активна только после подтверждения кода, не после одного показа QR. Сохраните коды восстановления сразу: каждый используется один раз. В кабинете показано, сколько осталось; отключение защиты требует пароля. При смене пароля заполните текущий пароль, новый и подтверждение нового.
Если связь не установлена, проверьте тип ключа, домен, факт отзыва и доступ по HTTPS. Поле последнего использования токена помогает найти неиспользуемые подключения, но не заменяет проверку модуля. В обращении в поддержку укажите домен, время и сообщение ошибки без самого секрета. Продолжение: Битрикс, встраивание, диагностика.