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

Подготовка базы и подключение

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

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

  1. Убедитесь, что база «Управление IT-отделом 8» уже доступна через поддерживаемый веб-сервер.
  2. В конфигураторе проверьте, что опубликован основной HTTP-сервис API.
  3. Проверьте подключение тестовой учетной записью и запишите полный адрес сервиса, например https://company.ru/base/hs/api/v2/.

Путь сервиса определяется настройками публикации. Адрес кабинета и адрес API — разные адреса. Для предварительной проверки администратор может открыть https://company.ru/base/hs/api/v2/info и выполнить запрос тестовой учетной записью. Если сервер возвращает страницу веб-сервера вместо данных, проверьте основную публикацию.

Заполните config.json​

Откройте config.json в каталоге Личного кабинета рядом с index.html. Укажите полный URL основной публикации:

{
"apiUrl": "https://company.ru/base/hs/api/v2/",
"publicApiUrl": ""
}

Если настроены функции до входа, заполните publicApiUrl полным адресом публичного сервиса. Сохраните корректный JSON, завершающий / и кавычки. Не помещайте в файл пароль, токен или учетные данные пользователя.

Если кабинет и сервисы размещены на разных доменах или портах, настройте CORS для адреса кабинета и обработку предварительных запросов OPTIONS. Если возможно, используйте один протокол, сервер и порт. Для HTTPS установите сертификат, которому доверяют браузеры пользователей.

Предупреждение о ненастроенном публичном API на форме входа

Проверьте подключение​

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

Дополнительные функции и отдельная публикация описаны в статье «Публичный API и восстановление пароля».