Публичный API и восстановление пароля
Инструкция предназначена администратору 1С и веб-сервера. Она настраивает отдельный публичный сервис для списка имен при входе и восстановления пароля. Обе публикации должны обращаться к одной информационной базе.
Перед началом подготовьте рабочую основную публикацию, права администратора 1С и веб-сервера, почтовую отправку и согласованную тестовую учетную запись.
Создайте отдельного служебного пользователя
- В программе «Управление IT-отделом 8» откройте «Администрирование → Настройки пользователей и прав → Профили групп доступа».
- Создайте профиль, содержащий только роль «Публичные методы API».
- В «Группах доступа» создайте группу с этим профилем.
- Создайте отдельного пользователя с аутентификацией 1С и включите его только в эту группу. Проверьте, что у пользователя нет других ролей, в том числе унаследованных.
Эта учетная запись используется только публикацией. Ее пароль храните в защищенной конфигурации веб-сервера. Не помещайте его в config.json, файлы статического сайта или сообщения пользователям.
Подготовьте публичную публикацию
Создайте отдельную публикацию той же базы. К имени основной публикации добавьте _public, сохранив протокол, сервер, порт и родительский путь. Например, для основной публикации https://company.ru/base/ публичный адрес сервиса будет https://company.ru/base_public/hs/api_public/v2/.
- Создайте отдельный каталог публикации и подготовьте
default.vrdна основе рабочей публикации. - В
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. Анонимный доступ разрешайте только публичной публикации. Авторизацию основной публикации не меняйте.
Включите функции и задайте адрес
- В программе откройте «Администрирование → Сервис → Настройки параметров учета → Личный кабинет → Вход и восстановление доступа».
- Включите нужные функции: показ списка логинов и/или восстановление пароля.
- В
config.jsonукажите полный адрес публичной публикации вpublicApiUrl. Адрес основной публикации задается отдельно вapiUrl. - Если включили восстановление, настройте отправку почты и параметры кода по инструкции «Настройка восстановления пароля».
Проверьте публикацию
Проверьте публичный адрес по HTTPS. До входа проверьте список имен: в него попадают пользователи со стандартной аутентификацией 1С и установленным флажком «Показывать в списке выбора», кроме служебных, недействительных и помеченных на удаление записей. Если в базе больше 300 учетных записей с этим флажком и стандартной аутентификацией, список не возвращается; порог проверяется до исключения пользователей. Проверьте получение письма на согласованной тестовой учетной записи. Убедитесь, что публичная публикация не выдает защищенные данные основной API, а служебный пользователь не имеет лишних ролей.
При отказе 401/403 проверьте адрес, отдельную публикацию и назначенную ей учетную запись. Не расширяйте роли пользователя наугад. Основную публикацию и адреса базы подготовьте по статье «Подготовка базы и подключение».