Токен в 1С: что это такое и для чего он нужен

Под запросом «током 1С» чаще всего имеется в виду токен — специальная строка-ключ, которую 1С или внешняя система использует для подтверждения доступа. Токен заменяет логин и пароль при обмене данными: его передают при обращении к API, веб-сервисам, HTTP-сервисам и при интеграциях с сайтами, банками, маркетплейсами и CRM.

Токен не является частью типовой конфигурации как отдельный объект. Это понятие из области интеграций: его выдаёт внешний сервис (например, оператор ЭДО, банк, маркетплейс) или генерирует сама система, а 1С хранит его и подставляет в запросы. Понимание того, где лежит токен и как он используется, нужно при настройке обменов и при диагностике ошибок вида «401 Unauthorized» или «доступ запрещён».

Ниже разобрано, что такое токен простыми словами, где он встречается в типовых сценариях 1С, как его получить и передать, как проверить работоспособность и какие ошибки встречаются чаще всего.

Что такое токен и чем он отличается от пароля

Пароль привязан к учётной записи пользователя и, как правило, не имеет срока действия, пока его не сменят. Токен — временный ключ с ограниченной областью действия: он может разрешать только чтение данных, только конкретный метод API или работу с одним магазином. Если токен скомпрометирован, его отзывают, не меняя основной пароль учётной записи.

В интеграциях 1С токен выполняет роль пропуска. Например, при обмене с маркетплейсом программа при каждом запросе передаёт токен в заголовке HTTP-запроса, и площадка по нему определяет, какая организация обращается и какие операции ей разрешены. Вводить логин и пароль при каждом обращении не требуется.

Важно понимать: токен — это секрет. Тот, кто знает токен, получает те же права, что и ваша программа. Поэтому его нельзя публиковать в открытых источниках, пересылать в незащищённых письмах и встраивать в код, доступный посторонним.

Где токены встречаются в работе с 1С

Чаще всего с токенами сталкиваются при настройке интеграций: обмен с маркетплейсами, интернет-магазинами, службами доставки, банками, операторами электронного документооборота, сервисами SMS- и email-рассылок, телефонией. В каждом случае внешний сервис выдаёт токен в личном кабинете, а его значение вносят в настройки обмена в 1С.

Вторая область — публикация HTTP-сервисов и веб-сервисов самой 1С. Когда база 1С сама принимает запросы от внешних систем (например, от сайта или мобильного приложения), разработчик часто реализует проверку токена: внешняя система передаёт ключ, а код в 1С сверяет его с хранимым значением и решает, выполнять ли запрос.

Третий сценарий — авторизация по протоколу OAuth в корпоративных интеграциях. Здесь применяется пара токенов: access token (короткоживущий, используется в запросах) и refresh token (служит для получения нового access token без повторного ввода логина и пароля).

Как получить токен и куда его внести в 1С

Токен выдаёт сторона, к сервису которой подключается 1С. Типовой путь: зайти в личный кабинет внешнего сервиса, найти раздел «Интеграция», «API» или «Ключи доступа», создать токен и скопировать его значение. Некоторые сервисы показывают токен только один раз — при создании, поэтому его нужно сразу сохранить в надёжном месте.

В 1С токен вводится в настройках соответствующего обмена. В типовых конфигурациях это обычно разделы администрирования или интеграций: настройка обмена с конкретным сервисом содержит поле «Токен», «Ключ API» или «API-ключ». После ввода значения настройку сохраняют и выполняют тестовое подключение, если такая кнопка предусмотрена.

Если интеграция реализована доработкой, место хранения токена определяет разработчик: это может быть константа, регистр сведений или защищённое хранилище. Перед изменением таких настроек уточните у специалиста, где именно хранится ключ, чтобы не осталось двух разных значений в разных местах.

1. 1
   Откройте личный кабинет внешнего сервиса и найдите раздел API или интеграций
2. 2
   Создайте новый токен и сразу скопируйте его значение
3. 3
   Откройте в 1С настройку соответствующего обмена и вставьте токен в поле ключа доступа
4. 4
   Сохраните настройку и запустите проверку соединения или тестовый обмен
5. 5
   Убедитесь, что данные загружаются без ошибок авторизации

Как токен передаётся в запросах

При программном обращении к API токен чаще всего передаётся в заголовке HTTP-запроса. Распространённый вариант — заголовок Authorization со значением вида «Bearer <токен>». Некоторые сервисы принимают токен в параметре адресной строки или в теле запроса — это определяется документацией конкретного API.

Передача токена в адресной строке менее безопасна: URL может сохраняться в журналах, истории и логах прокси-серверов. Если сервис позволяет выбрать способ, предпочтительнее заголовок запроса и обязательно защищённое соединение по HTTPS.

Заголовки = Новый Соответствие;
Заголовки.Вставить("Authorization", "Bearer " + Токен);
Запрос = Новый HTTPЗапрос("/api/orders", Заголовки);

Срок действия и обновление токена

Большинство токенов имеют ограниченный срок жизни — от нескольких минут до нескольких месяцев, в зависимости от политики сервиса. По истечении срока запросы начинают отклоняться, и обмен останавливается. Это нормальное поведение, а не сбой программы.

При схеме OAuth обновление происходит автоматически: программа по refresh token запрашивает новый access token. В простых интеграциях с постоянным ключом токен перевыпускают вручную в личном кабинете сервиса и заменяют значение в настройках 1С. Полезно заранее выяснить у сервиса срок действия ключа и назначить ответственного за его своевременную замену.

Безопасное хранение токенов

Токен не должен храниться в открытом виде в общедоступных местах: в тексте модулей, в файлах обмена, в письмах. В типовых механизмах 1С предусмотрено безопасное хранилище для паролей и ключей — при доработках стоит использовать именно его, а не открытые константы.

Ограничьте круг лиц, которые видят токен: обычно это администратор интеграций и ответственный за обмен. Права на настройку обменов выдаются только тем, кому это необходимо по работе. При увольнении сотрудника, имевшего доступ к ключам, токены критичных интеграций разумно перевыпустить.

Типичные ошибки при работе с токенами

Самая частая проблема — лишние символы при копировании: пробел в начале или конце строки, перенос строки, неполное значение. Внешне настройка выглядит заполненной, но сервис отклоняет ключ. Если обмен не работает, первым делом заново скопируйте токен и вставьте его аккуратно, без лишних символов.

Вторая группа ошибок — использование токена не от того окружения. У многих сервисов есть тестовый и рабочий контуры с разными ключами. Токен от тестового кабинета не подойдёт для рабочего обмена, и наоборот. Третья типичная ситуация — токен создан с недостаточными правами: чтение работает, а запись документов отклоняется.

Частые вопросы о токенах в 1С