> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/knowledge-base/uvedomleniya-i-integracii/public-api/plugin-installer.md).

# Плагины

Готовые и установленные плагины, точные права, проверка, настройка и удаление

Система плагинов подключает внешние модули курсов, мерчантов, выплат, KYC, AML и других интеграций. Такой модуль может выполнять код, обрабатывать деньги и получать внешние секреты, поэтому устанавливать следует только проверенные пакеты.

В левом меню находится самостоятельный раздел **«Плагины»** с двумя экранами:

* **«Плагины» — «Установленные плагины»**;
* **«Плагины» — «Готовые плагины»**.

Установленный плагин может добавить собственную страницу или вкладку. Её название, иконка, счётчик и видимость определяются самим плагином и правами сотрудника. Если пункт исчез после отключения или удаления плагина, это ожидаемо; запись в «Готовых плагинах» при этом может остаться.

Доступ разделён по операциям. Не выдавайте сотруднику полный набор, если его задача ограничена проверкой пакета, настройкой или контролем состояния.

| Право                                                       | Что становится доступно                                               | Без права                                                |
| ----------------------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------- |
| «Просмотр плагинов» из блока «Базовое управление»           | Реестр, сведения пакета и безопасный предварительный просмотр         | Раздел и проверка пакета недоступны                      |
| «Установка и запуск плагинов» из блока «Базовое управление» | Установка, проверка состояния и запуск предусмотренного рабочего кода | Нельзя установить пакет или запустить проверку состояния |
| «Управление плагинами» из блока «Базовое управление»        | Включение, отключение, обычные настройки и секреты                    | Нельзя менять рабочее состояние и параметры              |
| «Миграции плагинов» из блока «Базовое управление»           | Выполнение ожидающих изменений данных                                 | Нельзя запустить миграцию                                |
| «Релизы и удаление плагинов» из блока «Базовое управление»  | Возврат к предыдущему выпуску и удаление                              | Нельзя откатить или удалить модуль                       |

«Просмотр плагинов» из блока «Базовое управление» является чувствительным правом, остальные четыре — критичными. Устаревшее право «Разрешить установку внешних модулей» из блока «Базовое управление» сохраняет полный доступ ко всем этим операциям для совместимости. В новых группах замените его минимальным набором разделённых прав.

Назначать такие права должен ответственный администратор, который сам имеет передаваемое право, доступ к управлению группами и право «Выдача важных прав» из блока «Пользователи и права». Проверяйте результат входом под тестовым сотрудником: отсутствие одного права должно скрывать или запрещать только соответствующую операцию.

## Готовые плагины

Экран **«Плагины» — «Готовые плагины»** показывает проверенные пакеты, поставленные вместе с системой или обновлением. Откройте сведения, проверьте назначение, автора, категорию, совместимость, запрошенные доступы и состояние источника.

Верхние вкладки фильтруют каталог по категориям; **«Все категории»** возвращает полный доступный список. Рядом с категорией показывается количество пакетов, а длинная строка категорий прокручивается стрелками. Таблица содержит колонки **«Плагин»**, **«Категория»**, **«Версия и автор»**, **«Готовность»** и **«Действия»**. Для следующей части каталога используйте пагинацию, а не поиск пакета в другой категории наугад.

В колонке «Готовность» различайте:

* **«Поставщик подтверждён»** и **«Поставщик не подтверждён»** — происхождение пакета;
* **«Подходит для этой версии системы»** — проверенная совместимость;
* **«Нужна проверка»** — карточку нужно открыть и изучить;
* **«Плагин сейчас недоступен»** — установить его из каталога нельзя.

Статус подтверждённого поставщика не заменяет проверку доступов и делового назначения. Нажмите **«Открыть сведения о плагине»** и проверьте сайт, поддержку, лицензию, версию, автора, блок **«Доступы плагина»** и **«Что будет сделано»**.

Нажатие «Установить» сначала открывает экран **«Проверка плагина»**. Установка начинается только после успешной проверки и отдельного подтверждения. Если плагин помечен как несовместимый или недоступный, не переносите его файлы вручную.

После удаления установленной копии готовый пакет остаётся в этом разделе и может быть установлен снова. Это ожидаемо: «Готовые плагины» — каталог доступных пакетов, а не список активных модулей.

Поставляемые источники курсов, например Rapira и 2328 Rates, устанавливайте именно из «Готовых плагинов», если они присутствуют в вашей поставке. После установки проверьте появление источника, загрузку пар и расчёт тестового направления. Не переносите их папки между серверами вручную.

## Установка своего пакета

Откройте **«Плагины» — «Установленные плагины»** и нажмите «Установить». Источником может быть ZIP-архив с компьютера или защищённая HTTPS-ссылка на ZIP. Для закрытой ссылки можно указать код доступа.

Дополнительно форма может запрашивать идентификатор папки, метку выпуска и способ первичной загрузки пар курсов:

* использовать режим, заданный разработчиком;
* проверить источник и загрузить пары;
* установить источник без первичной загрузки пар.

Для источника курсов выбор влияет на длительность установки и на то, появятся ли пары сразу после неё.

## Проверка до установки

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

Кнопка установки доступна только для пакета, который прошёл обязательную проверку. До продолжения убедитесь, что:

* тип пакета совпадает с выбранным типом;
* источник пакета доверенный;
* заявленные функции ожидаемы;
* нет блокирующих проблем совместимости;
* план установки не содержит неожиданных действий;
* создана актуальная резервная копия данных и конфигурации.

Не устанавливайте пакет только потому, что проверка разрешила продолжение: автоматическая проверка не подтверждает деловую надёжность разработчика.

## После установки

В реестре модулей видны назначение, источник, состояние, совместимость, результат проверки состояния, процесс импорта данных и сведения об установке. В зависимости от пакета доступны:

* включение и отключение;
* «Проверить работу»;
* настройка секретов;
* настройка обычных параметров;
* запуск ожидающих изменений данных;
* возврат к предыдущему выпуску;
* удаление.

### Состояние, готовность и связи

| Область         | Возможные значения                                                | Как читать                                      |
| --------------- | ----------------------------------------------------------------- | ----------------------------------------------- |
| «Статус»        | «Включен», «Отключен», «Ошибка», «Удален», «Откат»                | Текущее состояние установленной копии           |
| «Совместимость» | «Совместим», «Нужна проверка»                                     | Соответствие текущей системе                    |
| Связи           | «Связи готовы», «Нужен связанный плагин»                          | Выполнены ли зависимости и нет ли конфликта     |
| «Проверка»      | «Не проверялся», «Работает», «Есть предупреждение», «Не работает» | Последний результат действия «Проверить работу» |

«Включен» не означает, что внешний сервис доступен, а «Работает» не подтверждает финансовый сценарий. После проверки состояния выполните безопасный сквозной тест соответствующей функции.

Если показано **«Нужен связанный плагин»**, откройте сведения и подготовьте требуемую зависимость. Не включайте модуль обходным способом: порядок установки и возможные конфликты являются частью его условий работы.

Пустое поле секрета при сохранении не меняет уже сохранённое значение. Обычные параметры и секреты хранятся раздельно. Состав полей определяет сам пакет, поэтому проверяйте подписи, обязательность и ожидаемый формат в форме.

Если для области «Управление плагинами» включена защита, установка, включение, отключение, настройка, секреты, миграция, откат и удаление потребуют кода. При включённом согласовании несколькими администраторами установка, включение, отключение, секреты, миграция, откат и удаление также ожидают подтверждений. Обычное сохранение настроек защищается кодом, но не создаёт запрос согласования.

Установка может запустить фоновую загрузку данных. Следите за состоянием «Ожидает загрузки», «Загружаются данные», «Данные загружены» или «Ошибка загрузки» и за итогами созданных, обновлённых, пропущенных и ошибочных записей. Не включайте рабочее использование до завершения обязательного импорта.

Установленный плагин может объявить собственную страницу в разделе «Плагины», фоновое действие, событие, расписание или форму настроек. Собственная страница видна только при включённом исправном плагине и наличии предусмотренного им права. Отключение, ошибка или удаление плагина убирает его страницу из меню, не удаляя основной раздел плагинов.

## Безопасный ввод в работу

1. Сделайте резервную копию.
2. Проверьте пакет и план установки.
3. Установите модуль.
4. Сразу проверьте его текущий статус.
5. Заполните секреты и обычные настройки.
6. Выполните ожидающие изменения данных, если они показаны.
7. Дождитесь импорта.
8. Запустите проверку состояния.
9. Проведите тест без реальных средств.
10. Включите модуль и повторите сквозной тест.

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

Для мерчанта проверьте создание платежа и callback, для выплаты — ограниченную тестовую выплату, для KYC/AML — тестовый запрос и журнал, для источника курсов — пары, обновление и итоговый расчёт направления.

{% hint style="danger" %}
Возврат к предыдущему выпуску или удаление модуля не следует считать автоматическим возвратом всех внешних операций и изменений данных. Сначала остановите его использование и сохраните необходимые данные.
{% endhint %}

При откате список предлагает только сохранённые версии, отличные от текущей. Активный выпуск и повторно установленный архив той же версии не являются допустимым откатом. После восстановления предыдущей версии плагин остаётся отключённым: проверьте настройки, связи, изменения данных и состояние, затем включите его вручную.

Если после обновления исправный плагин ошибочно выглядит повреждённым, сначала нажмите «Обновить», откройте его сведения и выполните «Проверить работу». Не удаляйте модуль и не устанавливайте архив поверх него до проверки активной версии, файлов выпуска и журнала: удаление может убрать доступный путь возврата.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/knowledge-base/uvedomleniya-i-integracii/public-api/plugin-installer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.