Перейти к содержимому
База знаний Structura

Интеграции

Что это

Интеграция — это подключение Структуры к внешнему сервису, в котором лежат данные вашей компании: BIM-модели в Speckle, файлы в Nextcloud, планы работ в OpenProject. Для каждой интеграции в админке хранятся реквизиты подключения: адрес сервиса и секретный ключ (токен), по которому Структура с ним общается. Реквизиты в интерфейсе всегда показаны в замаскированном виде — видны только последние символы вида ••••a3f9, чтобы случайный взгляд через плечо не выдал секрет.

Когда нужно

  • Компания подключает новый Speckle-сервер для хранения BIM-моделей и нужно дать сотрудникам доступ к нему через Структуру.
  • В Nextcloud сменился токен (например, при ротации секретов раз в полгода), и нужно обновить его в Структуре, иначе синхронизация файлов перестанет работать.
  • Сервис временно остановлен или мигрирует — интеграцию надо приостановить, не удаляя реквизиты.
  • Контракт со сторонним подрядчиком закончился — интеграцию надо полностью удалить.

Как сделать

В админке откройте раздел Компания → Интеграции. В таблице видны все подключённые сервисы и их статус:

ДействиеКнопка / полеЧто происходит
Добавить новую интеграцию«Создать интеграцию»Открывается форма: тип сервиса (Speckle / Nextcloud / OpenProject), название, адрес, токен. После сохранения интеграция активна.
Обновить адрес или токен«Изменить» в строкеОткрывается форма с замаскированным токеном. Чтобы заменить — введите новый, старый перетрётся.
Приостановитьпереключатель «Активна»Реквизиты остаются, но Структура перестаёт ими пользоваться. Сотрудники видят сообщение «интеграция приостановлена».
Удалить полностью«Удалить»Опасное действие: интеграция и её реквизиты стираются. Требует подтверждения с вводом названия.

Keycloak (служба входа в систему) в этом списке не настраивается — он работает всегда и управляется на уровне всего продукта.

Что произойдёт после

  • При создании или активации интеграции сервис подключается сразу: сотрудники компании, у которых есть соответствующая роль, начинают видеть данные из внешнего сервиса в своих модулях (например, модели Speckle — в Studio).
  • При приостановке интерфейс продолжает показывать кэшированные данные, но новые запросы во внешний сервис не уходят. Восстановление — нажать тот же переключатель обратно.
  • При удалении интеграции существующие ссылки на её ресурсы в проектах остаются, но открываться перестают: появляется сообщение «источник данных недоступен».
  • Все изменения реквизитов попадают в Историю изменений — но сам токен в истории не сохраняется, только факт «токен заменён».

Что ещё посмотреть