Дополнения

Дополнение — это отдельная программа, которая работает рядом с вашей панелью: магазин, продающий ваши тарифы, бот, который сообщает пользователям, что их учётная запись скоро истечёт, ваш собственный отчёт. Эта страница объясняет, что такое дополнение и что ему разрешено, и указывает на дополнения, которые публикует Nexora.

Что такое дополнение

Дополнение — это самостоятельная программа со своим интерфейсом и своей базой. Оно работает как служба или контейнер на вашем сервере, часто на сервере самой панели, и общается с панелью только по сети.

Панель никогда не выполняет код дополнения. Она устанавливает дополнение, запуская его собственный скрипт установки, а затем работает с ним по HTTPS, как с любой другой программой.
Панель никогда не хранит данные дополнения. Заказы, кошельки, привязки чатов, журналы сообщений — всё это лежит в базе дополнения. Резервируйте его средствами дополнения, а не панели.
Панель никогда не показывает страницы дополнения внутри своих. Она хранит ссылку на интерфейс дополнения, и вы открываете его в отдельной вкладке.

Удаление дополнения из панели отзывает его доступ. То, что хранит само дополнение, остаётся на его сервере, поэтому при повторной регистрации оно всё найдёт.

Что панель даёт дополнению

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

Что	Для чего
API-токен	Вызовы API панели, ограниченные правами, которые запрашивает манифест, каждое с указанной причиной. У токена также есть лимит запросов, который показывается до одобрения.
Подписка на события	Вебхук на стороне дополнения, получающий запрошенные им события, например создание или истечение пользователя; каждая доставка подписана.
Проверка состояния	Панель раз в минуту обращается к пути проверки состояния дополнения и помечает его Не отвечает, когда оно перестаёт отвечать.
Ссылка на интерфейс	В строке дополнения на странице Дополнения есть Открыть — она открывает собственный интерфейс дополнения в новой вкладке.

Токен и вебхук появляются в разделах Токены API и Вебхуки с пометкой, что они принадлежат дополнению, и изменить или удалить их можно только на странице Дополнения. Приостановка дополнения останавливает оба сразу. Повседневная работа с зарегистрированным дополнением (состояние, приостановка, обновления, которые просят больше) описана на странице «Дополнения»; почему всё устроено именно так — в Платформа дополнений.

Обновления никогда тихо не расширяют доступ

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

Насколько доверять дополнению

Каталог дополнений на addons.nexora-panel.org относит каждое дополнение к одному из трёх уровней:

Уровень	Кто сделал	Как можно установить
Официальное	Nexora. Манифест подписан ключом Nexora.	Панелью на её сервере, по SSH или командой, которую вы запускаете
Проверенное	Другой разработчик, проверено Nexora. Манифест подписан ключом разработчика, за который ручается каталог. Экран одобрения называет разработчика.	Так же, как официальное
Неофициальное	Другой разработчик, внесено в каталог только после лёгкой проверки.	Командой, которую вы запускаете, с предупреждением на карточке и на экране одобрения

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

WARNING

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