Перейти к основному содержимому

Публичный API и восстановление пароля

Инструкция предназначена администратору 1С и веб-сервера. Она настраивает отдельный публичный сервис для списка имен при входе и восстановления пароля. Обе публикации должны обращаться к одной информационной базе.

Перед началом подготовьте рабочую основную публикацию, права администратора 1С и веб-сервера, почтовую отправку и согласованную тестовую учетную запись.

Создайте отдельного служебного пользователя​

  1. В программе «Управление IT-отделом 8» откройте «Администрирование → Настройки пользователей и прав → Профили групп доступа».
  2. Создайте профиль, содержащий только роль «Публичные методы API».
  3. В «Группах доступа» создайте группу с этим профилем.
  4. Создайте отдельного пользователя с аутентификацией 1С и включите его только в эту группу. Проверьте, что у пользователя нет других ролей, в том числе унаследованных.

Эта учетная запись используется только публикацией. Ее пароль храните в защищенной конфигурации веб-сервера. Не помещайте его в config.json, файлы статического сайта или сообщения пользователям.

Подготовьте публичную публикацию​

Создайте отдельную публикацию той же базы. К имени основной публикации добавьте _public, сохранив протокол, сервер, порт и родительский путь. Например, для основной публикации https://company.ru/base/ публичный адрес сервиса будет https://company.ru/base_public/hs/api_public/v2/.

  1. Создайте отдельный каталог публикации и подготовьте default.vrd на основе рабочей публикации.
  2. В default.vrd укажите имя публичной публикации в base. В ib сохраните подключение к той же базе и добавьте имя и пароль служебного пользователя.

Для серверной базы атрибут ib имеет такой вид. Замените значения в примере реквизитами своей базы и служебного пользователя:

ib="Srvr="СЕРВЕР_1С";Ref="ИМЯ_БАЗЫ";Usr="ApiPublic";Pwd="ПАРОЛЬ_СЛУЖЕБНОГО_ПОЛЬЗОВАТЕЛЯ";"

Секрет не копируйте в конфигурацию сайта. Проверьте экранирование и права чтения файла default.vrd.

Для файловой базы сохраните действующий параметр File. Затем в httpServices оставьте только публичный сервис:

<httpServices>
<service name="APIПубличный" rootUrl="api_public" enable="true"/>
</httpServices>

Не переносите в публичную публикацию остальные HTTP-сервисы, веб-сервисы или OData. Ограничьте чтение default.vrd и других файлов, где хранятся реквизиты служебной учетной записи.

Настройте адрес и каталог на веб-сервере по соответствующей инструкции: Apache в Windows, Apache в Ubuntu или Microsoft Internet Information Services. Анонимный доступ разрешайте только публичной публикации. Авторизацию основной публикации не меняйте.

Включите функции и задайте адрес​

  1. В программе откройте «Администрирование → Сервис → Настройки параметров учета → Личный кабинет → Вход и восстановление доступа».
  2. Включите нужные функции: показ списка логинов и/или восстановление пароля.
  3. В config.json укажите полный адрес публичной публикации в publicApiUrl. Адрес основной публикации задается отдельно в apiUrl.
  4. Если включили восстановление, настройте отправку почты и параметры кода по инструкции «Настройка восстановления пароля».

Проверьте публикацию​

Проверьте публичный адрес по HTTPS. До входа проверьте список имен: в него попадают пользователи со стандартной аутентификацией 1С и установленным флажком «Показывать в списке выбора», кроме служебных, недействительных и помеченных на удаление записей. Если в базе больше 300 учетных записей с этим флажком и стандартной аутентификацией, список не возвращается; порог проверяется до исключения пользователей. Проверьте получение письма на согласованной тестовой учетной записи. Убедитесь, что публичная публикация не выдает защищенные данные основной API, а служебный пользователь не имеет лишних ролей.

При отказе 401/403 проверьте адрес, отдельную публикацию и назначенную ей учетную запись. Не расширяйте роли пользователя наугад. Основную публикацию и адреса базы подготовьте по статье «Подготовка базы и подключение».