> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка интеграции

> Подготовьте учетные данные поставщика, подключите поддерживаемую систему, включите потоки данных и убедитесь, что первая синхронизация выполнена успешно.

В этом руководстве описан общий порядок настройки интеграций, перечисленных в разделе **Настройки → Интеграции → Каталог**. Поля, разрешения и этапы аутентификации, специфичные для поставщика, описаны в руководстве по настройке, ссылка на которое размещена на карточке этого поставщика в разделе «Каталог».

## Предварительные требования

| Роль | Ответственность |
| - | - |
| [**Владелец программы**](/ru/reference/glossary#%D0%B2%D0%BB%D0%B0%D0%B4%D0%B5%D0%BB%D0%B5%D1%86-%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D1%8B) | Выбирает источник, подключает его в Living Security, включает потоки и проверяет результат |
| [**Системный администратор**](/ru/reference/glossary#%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D1%8B%D0%B9-%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80) | Создает или утверждает учетные данные и области доступа в исходной системе |

Эти роли может выполнять один и тот же человек. Пользователь, который вводит учетные данные в Living Security, должен иметь роль администратора, разрешающую управление интеграциями; не приглашайте администратора исходной системы в Living Security исключительно исходя из предположения, что существует узкая роль для настройки.

Перед началом работы:

* Выберите организацию и среду Living Security, к которым относится подключение.
* Откройте руководство поставщика в разделе «Каталог» и соберите сведения о необходимых областях доступа, URL-адресах перенаправления и требованиях к спискам разрешенных адресов.
* Если учетные данные создает и вводит разные люди, используйте принятый в вашей организации процесс передачи секретов.
* Никогда не отправляйте пароли, секреты клиента, закрытые ключи или значения ключей доступа по электронной почте или через обращение в службу поддержки.

## 1. Подготовка учетных данных поставщика

Откройте **Настройки → Интеграции → Каталог**, найдите поставщика и перед созданием учетных данных изучите его руководство по настройке.

Для аутентификации у поставщика могут использоваться согласие OAuth, токен API, идентификатор и секрет клиента, учетная запись службы или другой метод, поддерживаемый поставщиком. Создавайте только те учетные данные и области доступа, которые указаны в руководстве поставщика.

<Warning>
  Не копируйте разрешения от другого поставщика и не предоставляйте широкий
  доступ на запись «на всякий случай». Отсутствие необходимых разрешений
  обычно приводит к понятной ошибке 401 или 403, которую можно исправить;
  избыточные разрешения создают риск, которого можно избежать.
</Warning>

## 2. Подключение поставщика

<Steps>
  <Step title="Откройте каталог">
    Перейдите в **Настройки → Интеграции → Каталог** и выберите поставщика.
  </Step>

  <Step title="Начните подключение">
    Нажмите **Подключиться**. Пройдите процесс OAuth или заполните поля,
    запрошенные в диалоговом окне подключения. В руководстве поставщика
    объясняется, откуда брать каждое значение.
  </Step>

  <Step title="Завершите аутентификацию">
    При необходимости подтвердите экран согласия поставщика. После успешной аутентификации Living Security откроет новое подключение или отобразит его в списке **подключен**.
  </Step>
</Steps>

Если поставщик отклоняет аутентификацию, остановитесь и перед продолжением исправьте учетные данные, тенант, регион, URL-адрес перенаправления или разрешения в исходной системе.

## 3. Включение потоков данных

Откройте подключение в разделе **Настройки → Интеграции → подключен**. Living Security определяет шаблоны синхронизации, доступные для этого поставщика, и отображает их в виде потоков.

1. Изучите название и назначение каждого потока.
2. Включайте только те потоки, которые нужны вашей программе.
3. Оставляйте ненужные потоки приостановленными.
4. Чтобы запросить первый запуск, используйте **Синхронизировать сейчас**, если эта функция доступна.

Не все поставщики предлагают одинаковые потоки или элементы управления расписанием. Ориентируйтесь на элементы управления, показанные в подключении, и не ожидайте универсальной частоты, области, сопоставления полей, черновика или мастера активации.

## 4. Проверка первого запуска

Сама по себе аутентификация подключения не доказывает, что данные поступают.

<Steps>
  <Step title="Проверьте состояние подключения">
    Убедитесь, что подключение работает нормально и не запрашивает повторную авторизацию.
  </Step>

  <Step title="Проверьте состояние потока">
    Убедитесь, что нужный поток включен, а не приостановлен.
  </Step>

  <Step title="Изучите последний запуск">
    Откройте поток, ссылку на синхронизацию в подключении или **Настройки** → **Интеграции** → **Синхронизация**. Дождитесь успешного итогового результата и, если данные доступны, проверьте ошибки поставщика и количество записей.
  </Step>

  <Step title="Подтвердите наличие данных в downstream-системах">
    Откройте соответствующий раздел Living Security. Данные об идентичностях должны создать ожидаемых людей и идентичности в разделе «Сотрудники»; данные из источников безопасности должны отображаться в функции, описанной для данного поставщика.
  </Step>
</Steps>

При начальной настройке задачи Journey Map **Проверить поступление данных об идентичностях** и **Проверить поступление данных интеграции** выполняются на основе загруженных данных. Не заменяйте результаты этих проверок сохраненным подключением.

## Страница сведений о синхронизации

В разделе **Настройки** → **Интеграции** → **Синхронизация** откройте любую синхронизацию, чтобы просмотреть ее конфигурацию и историю запусков в одном месте.

На странице сведений отображается следующее:

| Раздел | Что включает |
| - | - |
| **Заголовок** | Название синхронизации, значок состояния и поставщик интеграции |
| **Статистика** | Модель, последняя синхронизация, завершенные запуски и общее количество записей |
| **История запусков** | Последние запуски с состоянием, временем и количеством записей |
| **Действия** | **Обновить**, **Пауза** / **Резюме** и **Синхронизировать сейчас** |

Используйте **Синхронизировать сейчас**, чтобы запустить синхронизацию немедленно, если она активна. Приостановленные синхронизации необходимо возобновить, прежде чем начнутся новые запуски по расписанию или вручную.

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

## Операции с подключением

На странице сведений о подключении доступны операции, поддерживаемые данной интеграцией:

| Операция | Результат |
| - | - |
| **Синхронизировать сейчас** | Запрашивает немедленный запуск для выбранного потока |
| **Приостановить поток** | Останавливает новые запуски этого потока, сохраняя подключение |
| **Приостановить соединение** | Останавливает поддерживаемую активность подключения без удаления конфигурации |
| **Резюме** | Возобновляет приостановленный поток или подключение |
| **Повторно авторизовать** | Повторяет аутентификацию после изменения учетных данных или согласия |
| **Удалить** | Удаляет конфигурацию подключения после подтверждения |

Удаление подключения не равнозначно удалению данных, уже полученных из него. Изучите руководство поставщика или обратитесь в службу поддержки, если порядок хранения данных влияет на ваше решение.

## Пользовательские источники с отправкой данных

Используйте **Custom Push Source** (пользовательский источник с отправкой данных), когда система сама отправляет данные в Living Security, а не опрашивается через коннектор из каталога.

1. Создайте источник в нижней части раздела **Каталог**.
2. Откройте его страницу сведений в области пользовательской отправки данных.
3. Выберите целевой поток.
4. Используйте **Загрузить CSV** для ручной пакетной загрузки или **Отправить через API** для автоматической отправки.
5. После отправки просмотрите файл или полезную нагрузку и проверьте историю запусков источника.

Полное описание конечной точки, аутентификации, полезной нагрузки, повторных попыток и проверки см. в разделе [Custom Push Source API](/ru/integrations/custom-push-source). Не делайте выводов об этих деталях на основе устаревшего руководства по интеграции Unify.

Средство загрузки на странице сведений об источнике принимает CSV-файл источника размером до 100 МБ. Перед загрузкой Панель управления разбивает его на стороне клиента на запросы размером не более 10 МБ и не более 10 000 строк каждый. Это специализированное средство загрузки для источника не связано с общей страницей **Интеграции → Загрузить** для шаблонов идентичностей и активности.

## Устранение неполадок

| Симптом | Что проверить |
| - | - |
| `401 Unauthorized` | Значение учетных данных, срок действия, отзыв, тенант поставщика и состояние повторной авторизации |
| `403 Forbidden` | Необходимая роль у поставщика, области доступа, согласие администратора и политика доступа в исходной системе |
| Подключение сразу завершается ошибкой | URL-адрес перенаправления, регион, URL источника, требования к сетевым спискам или спискам IP-адресов |
| Подключение работает нормально, но запусков нет | Необходимый поток включен, и поставщик предоставляет этот поток |
| Успешный запуск не возвращает записей | Учетная запись источника видит ожидаемый набор пользователей, и фильтры на стороне поставщика настроены правильно |
| Данные отображаются у другого человека | Атрибуты идентичности и псевдонимы согласованы во всех подключенных источниках |
| Данные перестали обновляться | Поток или подключение приостановлены, срок действия учетных данных истек или последний запуск завершился ошибкой |

При обращении в [службу поддержки Living Security](mailto:support@livingsecurity.com) укажите организацию, поставщика, название подключения, поток, время последнего запуска и отображаемую ошибку. Не указывайте секреты.

## См. также

<CardGroup cols={2}>
  <Card title="Обзор интеграций" icon="grid-2" href="/ru/integrations/overview">
    Справочник по разделам «подключен», «Каталог», «Синхронизация», «Действия» и «Загрузить».
  </Card>

  <Card title="Сопоставление данных" icon="arrows-left-right" href="/ru/integrations/managing/data-mapping">
    Сведения о поддерживаемых атрибутах и сопоставлениях, где они доступны.
  </Card>

  <Card title="Жизненный цикл интеграции" icon="route" href="/ru/integrations/managing/lifecycle">
    Управление существующей интеграцией: от повторной авторизации до удаления.
  </Card>

  <Card title="Начальная настройка для администратора" icon="circle-check" href="/ru/getting-started/onboarding">
    Выполните задачи по проверке данных об идентичностях и данных безопасности.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.