# Настроить интеграцию ELMA365 с ELMA Cortex

> [HTML Version](cortex-integration-solution.html)

После того как вы установили ELMA Cortex, настройте связь с компанией ELMA365. Для этого:

1. [Загрузите в компанию ELMA365 решение для интеграции с ELMA Cortex](#install-solution).

2. [Настройте авторизацию пользователей в ELMA Cortex](#configure-oauth).

3. [Установите соединение с ELMA Cortex](#connect-to-system).

## Шаг 1. Загрузить решение для интеграции с ELMA Cortex

1. Запросите у вашего менеджера ELMA365 файл решения **Интеграция с ELMA Cortex**.

2. Перейдите в раздел **Администрирование > Решения**.

3. Нажмите в правом верхнем углу страницы **+ Решение** и выберите в появившемся окне опцию **Загрузить файл**.

4. Укажите файл решения формата **.e365**.

5. В открывшемся окне нажмите **Далее** и дождитесь окончания [импорта решения](upload-solution-file.md).

В составе решения в компанию загрузится модуль, который используется для интеграции компании ELMA365 с **ELMA Cortex**.

## Шаг 2. Настроить авторизацию пользователей в ELMA Cortex с помощью OAuth 2.0

На стороне ELMA365 нужно настроить авторизацию в **ELMA Cortex** по протоколу OAuth 2.0, чтобы:

- проверять права текущего пользователя — когда при работе AI‑агента и AI‑операции нужно совершить действие в системе, проверяется доступ к элементам приложений, кнопкам запуска процессов и т. п.;

- обеспечить вход администратора в **ELMA Cortex** — если вы используете [авторизацию с помощью ELMA365](cortex-auth-settings.md#system-auth).

Чтобы настроить авторизацию:

1. Откройте раздел **Администрирование > Модули** и выберите модуль **Интеграция с ELMA Cortex**.

2. Добавьте клиента OAuth 2.0. Для этого внизу страницы модуля разверните блок **Токены** и нажмите справа кнопку **+ Создать клиент OAuth2/OIDC**.

3. В открывшемся окне заполните поля:

**(cortex-integration-solution-1.png)**

- **Название\*** — задайте имя клиента;

- **Шаблон\* **— оставьте значение, установленное по умолчанию;

- **URI перенаправления\*** — введите путь к вашему серверу **ELMA Cortex** в формате: **https://<домен\_ELMA\_Cortex>/api/pub/v1/security/sessions/callback**. 

4. Нажмите **Сохранить**.

5. В открывшемся окне скопируйте и сохраните уникальный идентификатор и секрет приложения. Они нужны для настройки входа администратора в **ELMA Cortex**, если используется авторизация через ELMA365, а также для установки подключения к ELMA365 при создании AI‑агентов и AI‑операций.

6. Если вы [задаёте авторизацию администратора с помощью ELMA365](cortex-auth-settings.md#system-auth), перейдите к настройке файла переменных окружения и укажите уникальный идентификатор и секрет приложения.

## Шаг 3. Установить соединение с ELMA Cortex

После того как сервер **ELMA Cortex** установлен:

1. Войдите в **ELMA Cortex**. Данные для входа зависят от настроенного [способа авторизации](cortex-auth-settings.md):

- с помощью ELMA365 — введите свой логин и пароль из системы;

- с помощью ELMA Bot — укажите логин и пароль администратора ELMA Bot.

2. На левой панели нажмите значок ключа **(cortex-api-keys-icon.png) **для перехода к странице **API-ключи**.

3. Нажмите рядом с названием страницы значок плюса. 

4. В открывшемся окне задайте название ключа и укажите вид доступа **Интеграция**, затем нажмите **Добавить**.

5. Скопируйте сгенерированный ключ.

**(cortex-integration-solution-2.png)**

6. Перейдите в ELMA365 и откройте раздел **Администрирование > Токены**.

7. [Создайте токен](360016488452.md), указав в качестве пользователя администратора системы, и скопируйте его.

8. Откройте раздел **Администрирование > Модули** и выберите модуль **Интеграция с ELMA Cortex**.

9. На вкладке **Основное** заполните поля:

- **URL\*** — введите адрес вашего сервера **ELMA Cortex**;

- **API key\* **— вставьте API-ключ, скопированный из **ELMA Cortex**.

10. Нажмите** Переподключить**, чтобы установить соединение с сервером **ELMA Cortex**.

11. В поле **Токен ELMA365\*** вставьте токен, созданный в ELMA365.

12. Убедитесь, что интеграция работает корректно, нажав кнопку **Проверить соединение**.

**(cortex-integration-solution-3.png)**

13. В поле **Язык чата по умолчанию** выберите язык, на котором AI‑агенты общаются с пользователями: русский или английский.

14. Внизу страницы нажмите кнопку **Сохранить**.

Настройка интеграции с **ELMA Cortex** завершена. Теперь [подключите провайдеров больших языковых моделей](cortex-llm-providers.md), чтобы настраивать AI‑агентов, AI‑операции и умный поиск.