Разработчикам / Обеспечение взаимодействия BOOCO с другими ИТ-системами

Введение

iFrame API можно использовать для интеграции BOOCO в корпоративные порталы и другие сайты. Например, если вы хотите отображать карту офиса на корпоративном портале, то iFrame API позволяет это сделать.

Для работы BOOCO iFrame API:

• BOOCO Astra (v 2.18.0 или новее) должен быть установлен и доступен по протоколу https;
• корпоративный сайт должен поддерживать авторизацию на основе JWT-токенов, которые подписываются открытым или закрытым ключом;
• для авторизации через iFrame API пользователи должны быть добавлены в BOOCO: необходимо настроить синхронизацию пользователей сервера BOOCO и службы каталогов или добавить пользователей в систему другим способом.

Чтобы интегрировать карту офиса и другие модули в корпоративный портал, выполните следующие шаги:

• Настройте микросервис bosql, чтобы он поддерживал внешнюю авторизацию, и передайте в него открытый или закрытый ключ (для проверки подписи токенов авторизации).
• На странице, которая будет отображать iFrame:
  • настройте политики контента;
  • добавьте iFrame;
  • вызовите метод для отправки JWT-токена и настройте регулярное обновление токенов;
  • вызовите метод для настройки отображения iFrame;
  • при необходимости можно переписать окна бронирования.

Настройка CSP (content security policy)

Если корпоративный портал (хост) использует политику безопасности контента (CSP), то необходимо дополнить его правила:

• в заголовок ответа (если используется) добавьте: Content-Security-Policy: frame-src https://<адрес сервера BOOCO>;

• в теге meta (если используется) укажите:

  <meta
  	http-equiv="Content-Security-Policy"
  	content="frame-src https://<адрес сервера BOOCO>;"
  >
  
  

Интеграция iFrame-модулей на страницу корпоративного портала

1. Вставьте iFrame в html-страницу корпоративного портала:

   <iframe src="https://<адрес сервера BOOCO>/iframe-module/**<module-name>**"/>
   

   Возможные значения module-name:

   • map — модуль карт офиса;
   • resources — модуль ресурсов.

2. Отправьте сообщение инициализации модуля.

   • Пример с картой офиса
   • Пример с ресурсами