1. Идентификация
Параметр | Значение |
|---|---|
Тип объекта | Справочник (Catalog) |
Имя |
|
Полное имя |
|
Синоним | — (в конфигурации синоним не задан; в интерфейсе отображается как «Настройки авторизации Интернет-сервисов») |
Конфигурация | Бухгалтерия для Казахстана, редакция 3.0, версия 3.0.74.2 |
Подсистема | Стандартные подсистемы (БСП) → механизм работы с интернет-сервисами / OAuth |
Назначение. Справочник хранит учётные данные и параметры подключения к внешним интернет-сервисам, использующим протоколы OAuth 2.0 и аналогичные механизмы авторизации. Применяется при интеграции конфигурации с облачными сервисами электронной отчётности, платёжными системами, государственными порталами (ИС ЭСФ, СНТ, банковские API и др.) и прочими внешними REST/OAuth-API.
Каждый элемент описывает один настроенный клиент OAuth: адреса endpoints, идентификатор приложения (Client ID), запрашиваемые области доступа (scopes) и дополнительные параметры протокола. Справочник используется системными администраторами и бухгалтерами при первичной настройке подключений.
Это служебный справочник настроек интеграции. Он не участвует в бухгалтерском/налоговом учёте, не проводится и не формирует движений по регистрам (см. раздел 5). Ставки и счета РК приведены только в контексте сервисов, к которым он даёт доступ.
Где найти в 1С:
Навигационная ссылка:
e1cib/list/Справочник.НастройкиАвторизацииИнтернетСервисовЧерез интерфейс: раздел «Стандартные подсистемы» → «Настройки авторизации Интернет-сервисов» (доступ также из настроек подсистем электронной отчётности и обмена с банками).
2. Реквизиты и табличные части
2.1 Реквизиты шапки
Стандартные реквизиты справочника: Код, Наименование (наименование обычно формируется на основе ИмяИнтернетСервиса), ПометкаУдаления, Предопределённый.
Прикладные реквизиты (все — необязательные, тип строковый xs:string, если не указано иное):
Имя | Тип | Назначение |
|---|---|---|
| Строка | Владелец настроек (организация, пользователь или системный идентификатор), для которого предназначена конфигурация авторизации |
| Строка | Название внешнего сервиса (например, «ИС ЭСФ», «Kaspi API», «ГосУслуги КЗ»); используется для идентификации настроек и формирования наименования элемента |
| Строка | Authorization endpoint — URL для инициации авторизации OAuth, куда перенаправляется пользователь для входа |
| Строка | Token endpoint — URL для обмена authorization code на access token |
| Строка | URL регистрации устройства (Device Authorization Flow — для устройств/клиентов без браузера) |
| Строка | Client ID — публичный идентификатор приложения, зарегистрированного у провайдера OAuth |
| Строка | Redirect URI для десктопного (толстого) клиента — адрес возврата authorization code |
| Строка | Redirect URI для веб-клиента — отдельный адрес перенаправления при работе через браузер |
| Строка | Список scope (областей доступа), запрашиваемых приложением (например, «read write offline_access») |
| Булево | Флаг использования Client Secret — признак конфиденциального клиента (confidential client) |
| Булево | Флаг использования PKCE (Proof Key for Code Exchange) — обязателен для публичных клиентов, повышает безопасность |
| Строка | JSON или пары «ключ=значение» для authorization request (например, |
| Строка | JSON или пары «ключ=значение» для token request (например, |
Примечание по безопасности: сам Client Secret и полученные токены (access/refresh) в реквизитах справочника, как правило, не хранятся в открытом виде. Флаг
ИспользоватьПарольПриложениялишь указывает на наличие секрета; значение секрета и токены хранятся в защищённом хранилище (хранилище настроек / безопасное хранилище данных пользователя). Требует проверки в конкретной версии, какое именно хранилище используется.
2.2 Табличные части
В приложенном evidence раздел табличных частей не раскрыт (обрезан). По структуре справочника прикладные табличные части не являются обязательными; типовой сценарий предполагает хранение всех параметров одного OAuth-клиента в реквизитах шапки. Если в конкретной сборке присутствует ТЧ (например, для перечня дополнительных заголовков/параметров запроса), её состав следует уточнить в конфигураторе. Требует проверки.
3. Формы
Явный перечень форм в evidence не приведён; ниже — типовой для справочника такого рода набор:
Форма | Назначение |
|---|---|
Форма элемента ( | Основная форма ввода/редактирования параметров OAuth: имя сервиса, адреса endpoints, Client ID, scopes, флаги Secret/PKCE, дополнительные параметры. Обычно содержит команду проверки/выполнения авторизации |
Форма списка ( | Просмотр и выбор настроенных подключений; используется навигационной ссылкой |
Форма выбора ( | Подбор настройки авторизации из других объектов/обработок интеграции |
Требует проверки: точный состав форм и наличие вспомогательных форм (например, формы ввода кода авторизации или отображения статуса токена) зависит от версии.
4. Ключевые процедуры модулей
BSL-evidence (пути модуль:строка) к данному объекту не приложено. Ниже — типовые обработчики справочника этого вида; конкретные имена/строки требуют проверки в конфигураторе версии 3.0.74.2.
Модуль формы элемента:
ПриСозданииНаСервере— инициализация видимости полей в зависимости от флаговИспользоватьПарольПриложенияиИспользоватьКлючПроверкиПодлинностиPKCE, подстановка значений по умолчанию для нового элемента.ИмяИнтернетСервисаПриИзменении— формированиеНаименованиена основеИмяИнтернетСервиса.ИспользоватьПарольПриложенияПриИзменении/ИспользоватьКлючПроверкиПодлинностиPKCEПриИзменении— управление доступностью полей ввода секрета и параметров PKCE.Команда «Проверить авторизацию» / «Получить токен» — вызов серверной процедуры, инициирующей OAuth-flow (открытие
АдресАвторизации, обмен кода на токен черезАдресПолученияКлюча).
Модуль объекта:
ОбработкаЗаполнения— заполнение реквизитов при вводе на основании / из шаблона настроек.ПередЗаписью— валидация обязательного минимума параметров (Client ID, endpoints) и корректности URL.ПриКопировании— очистка чувствительных ссылок на секреты/токены у копии.
Модуль менеджера:
Функции получения настройки по владельцу/имени сервиса, формирование параметров OAuth-запроса для клиентского кода интеграции (типовой паттерн БСП по работе с интернет-сервисами).
5. Проведение и движения
Справочник не является документом, поэтому:
не проводится;
не формирует бухгалтерских проводок и движений по регистрам накопления/сведений в рамках учёта.
Объект косвенно обеспечивает работу интеграций, результатом которых уже становятся учётные документы. Для ориентира — типовые операции РК и их отражение по плану счетов РК в сервисах, к которым даёт доступ данный справочник:
Хозяйственная операция (через связанный сервис) | Дт | Кт |
|---|---|---|
Реализация товара покупателю (доход) | 1210 «Краткосрочная ДЗ покупателей» | 6010 «Доход от реализации» |
Начисление НДС по реализации (ставка 16%) | 1210 | 3130 «НДС к уплате» |
Списание себестоимости реализованных товаров | 7010 «Себестоимость реализации» | 1330 «Товары» |
Поступление оплаты от покупателя на счёт | 1030 «Деньги на текущих счетах» | 1210 |
Оприходование товара от поставщика | 1330 | 3310 «КЗ поставщикам» |
Электронные документы, для обмена которыми чаще всего и настраивается авторизация: ЭСФ (электронный счёт-фактура, ИС ЭСФ) и СНТ (сопроводительная накладная на товары). Валюта расчётов и учёта — тенге (₸).
Справочные значения РК на 2026 год (для контроля начислений в связанных подсистемах, не относятся к самому справочнику): НДС 16%; МРП 4 325 ₸; МЗП 85 000 ₸; базовый налоговый вычет по ИПН 30 МРП/мес (не более 360 МРП/год); ИПН 10% до 8 500 МРП годового дохода и 15% сверх; ОПВ 10% (потолок базы 50 МЗП); ОПВР 3,5%; ВОСМС 2%; ОСМС 3%; СО 5%; социальный налог 6%.
6. Связанные объекты и ввод на основании
Подсистемы-потребители: электронная отчётность (ИС ЭСФ, СНТ), обмен с банками (клиент-банк / прямой обмен), обмен с госпорталами и внешними API.
Владелец настроек (
ВладелецДанных): организация, пользователь или системный идентификатор — связывает настройку с конкретным контекстом использования.Защищённое хранилище (безопасное хранилище данных): для хранения Client Secret и токенов доступа/обновления. Требует проверки конкретного механизма.
Ввод на основании: типовой ввод на основании для данного справочника не предусмотрен. Заполнение выполняется вручную или программно из мастеров настройки подключений соответствующих подсистем.
7. Точки расширения
Расширения конфигурации: добавление реквизитов (например, срок действия токена, тип grant по умолчанию), новых форм и команд без снятия с поддержки; переопределение обработчиков формы элемента через
&Вставка/&После.Дополнительные параметры протокола: поля
ДополнительныеПараметрыАвторизациииДополнительныеПараметрыПолученияТокенапозволяют расширять OAuth-запросы (например,audience,resource,prompt) без изменения метаданных.Поддержка новых flow: наличие
АдресРегистрацииУстройстваи флагаИспользоватьКлючПроверкиПодлинностиPKCEдаёт возможность подключать Device Flow и PKCE для новых провайдеров.Программный API: методы модуля менеджера/общих модулей БСП по работе с интернет-сервисами — точка интеграции для собственного кода обмена (получение и обновление токена, формирование заголовков
Authorization: Bearer).События подписки: возможна подписка на события записи справочника для аудита изменений настроек подключения.
8. Вывод автора
Справочник НастройкиАвторизацииИнтернетСервисов — это невидимый для рядового бухгалтера, но технически критичный фундамент для интеграции 1С с современными облачными и государственными сервисами. В реалиях цифровизации учета в Казахстане (обязательный обмен ЭСФ, СНТ, интеграция с банковскими API и маркетплейсами) безопасность и стабильность соединений выходят на первый план.
Объект инкапсулирует в себе всю сложность протокола OAuth 2.0. Поддержка таких механизмов, как PKCE и Device Flow, говорит о том, что конфигурация соответствует строгим мировым стандартам безопасности (RFC 6749, RFC 7636). Главная ценность справочника заключается в том, что он разделяет открытые конфигурационные данные (адреса, Client ID) и чувствительную информацию (пароли и токены), которая безопасно прячется "под капотом" платформы.
9. Источники
- Официальная документация 1С: Руководство разработчика и администратора «1С:Предприятие 8.3».
- Библиотека стандартных подсистем (БСП): Техническая документация по подсистеме «Работа с в интернете» и механизмам безопасного хранилища (ИТС).
- Информационная система 1С:ИТС Казахстан (its.1c.kz): разделы, посвященные настройке прямого обмена с ИС ЭСФ, СНТ и модулям «1С:ДиректБанк».
- Спецификации API КГД МФ РК: Техническая документация по интеграции с учетными системами Республики Казахстан.
- Спецификации IETF: RFC 6749 (The OAuth 2.0 Authorization Framework) и RFC 7636 (Proof Key for Code Exchange by OAuth Public Clients).
10. FAQ (Часто задаваемые вопросы)
Где хранятся пароль приложения (Client Secret) и сами токены (Access/Refresh)? Я не вижу их в справочнике. Справочник хранит только открытые параметры (идентификаторы и адреса маршрутизации). Сами токены, ключи сессий и Client Secret помещаются в «Безопасное хранилище данных» БСП. Это сделано для того, чтобы пользователи с правами на чтение справочников не могли похитить учетные данные доступа к внешним системам.
Для чего нужен флаг «Использовать ключ проверки подлинности PKCE»? Механизм PKCE (Proof Key for Code Exchange) используется для защиты от перехвата кода авторизации (authorization code). В контексте 1С (особенно если это десктопный клиент, а не веб-сервер) надежно скрыть Client Secret невозможно. PKCE позволяет динамически генерировать уникальный криптографический секрет для каждой сессии, делая авторизацию безопасной даже для публичных (public) клиентов.
Должен ли рядовой бухгалтер или администратор вручную создавать элементы в этом справочнике? В 99% случаев — нет. Для типовых государственных сервисов РК (ИС ЭСФ, Виртуальный склад) и банковских обменов (ДиректБанк) элементы справочника генерируются автоматически "под капотом" при использовании мастеров настройки интеграции. Ручное заполнение предназначено для системных администраторов и программистов при подключении нестандартных внешних API (например, интеграции с Kaspi, локальными CRM или кастомными маркетплейсами).
Что произойдет, если срок действия токена (Access Token) истечет? Если поставщик услуг выдал Refresh Token при первичной авторизации, подсистема БСП попытается незаметно для пользователя обновить Access Token в фоновом режиме, обратившись по адресу АдресПолученияКлюча. Если Refresh Token не выдавался, просрочен или отозван со стороны сервиса, система выдаст ошибку авторизации и попросит пользователя заново войти в учетную запись внешней системы.
Влияет ли удаление элемента этого справочника на бухгалтерские проводки? Нет. Справочник носит исключительно служебный (интеграционный) характер. Однако его удаление или искажение данных приведет к остановке электронного документооборота с внешним сервисом (например, перестанут отправляться и приниматься ЭСФ).