**Kongx** — это платформа для управления интерфейсом Kong, которая позволяет централизованно управлять конфигурацией шлюза в различных средах. Она предоставляет функции синхронизации конфигурации шлюза между средами, а также обладает стандартизированным управлением правами доступа, настройкой параметров, управлением средой и аудитом журналов.

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

Для получения подробной информации о том, как использовать Kongx, обратитесь к руководству пользователя на сайте Wiki: https://www.kancloud.cn/raoxiaoyan/kongx/1984321.

Также доступны следующие ресурсы:
* Frontend-страница Kongx-web: https://gitee.com/raoxy/kongx-web;
* Быстрый старт платформы: https://www.kancloud.cn/raoxiaoyan/kongx/1984323;
* Docker-развёртывание (поддерживается начиная с версии 3.0.0): https://www.kancloud.cn/raoxiaoyan/kongx/2055265;
* Документация по использованию визуального дизайна для создания конвейеров шлюзов: https://www.kancloud.cn/raoxiaoyan/kongx/2055265.

Демонстрация работы платформы доступна по адресу http://159.75.135.225/ с именем пользователя guest и паролем 123456.

По умолчанию используется пользователь admin с паролем 123456. После развёртывания системы рекомендуется перейти на страницу «Личные настройки» и изменить пароль.

**Скриншоты:**
* [Скриншот 1](docs/screen.png);
* [Скриншот 2](docs/kong%20shell.png);
* [Скриншот 3](docs/service2.png);
* Визуализация потока через шлюз (pipeline) (https://www.kancloud.cn/raoxiaoyan/kongx/2055265);
* Конфигурация потребителей (consumers) (https://www.kancloud.cn/raoxiaoyan/kongx/2055265);
* Сертификаты (certificate) (https://www.kancloud.cn/raoxiaoyan/kongx/2055265).

**Функции:**
* Управление Kong: Upstream, Service, Route, Plugin, Consumer, Certificates и Ca Certificates;
* Поддержка визуального проектирования потока через шлюзы;
* Синхронизация конфигурации Kong между различными средами для упрощения управления многосредовой конфигурацией;
* Системное управление с развитой системой управления правами доступа, включая управление пользователями, меню, ролями и группами пользователей;
* Параметрическое управление с хорошей расширяемостью для поддержки многосредовых и сервисных настроек, включая управление средами и параметрами;
* Аудит журналов с поддержкой синхронизации журналов и операционных журналов.

**Список плагинов Kong:**
* Официальные плагины Kong (https://docs.konghq.com/hub/);
* Плагины Canary (https://gitee.com/raoxy/kong-plugins-canary);
* Защита от атак Kong_injection (https://github.com/ror6ax/kong_injection).

**Лучшие практики Kong:**
* Интеграция Kong с Consul для самостоятельного обнаружения сервисов (https://www.kancloud.cn/raoxiaoyan/kongx/1984357);
* Применение плагинов Canary и их использование;
* Практика разработки плагинов для Kong;
* Мониторинг здоровья и прерывание работы Kong (https://www.kancloud.cn/raoxiaoyan/kongx/2044771);
* Поток через шлюзы Kong.

**RoadMap:**
1. Первоначальный план по адаптации Kongx к последующим версиям Kong (завершено автоматическое согласование с версиями 3.1.x);
2. Добавление интерфейса оболочки и визуального интерфейса управления (поддержка версии 2.0.1, завершено 18 ноября 2020 года);
3. Добавление графического интерфейса для проектирования потоков через шлюзы.

**Техническая поддержка:**
| Kongx Technical Support Group 1 | Сотрудничество |
| --- | --- |
| Номер группы: 980245072 (не заполнено) | Сканируйте QR-код для сотрудничества |

**Связь между Kongx и версиями Kong:**
| № | Версия Kongx | Версия Kong | Описание |
|---|---|---|---|
| 1 | 1.2.x | 1.2.x | Тестирование версии 1.2.x |
| 2 | 2.0.0 | 1.2.x, 1.3.x, 1.4.x, 1.5.x, 2.0.x | В настоящее время только тестирование на совместимость с версиями Kong 1.2.x и 1.3.x. Для версий 1.4.x и выше, а также для версии 1.3.x по сравнению с версией 1.2.x все основные функции доступны (см. сравнение различий) [https://www.kancloud.cn/raoxiaoyan/kongx/1991178] |
| 3 | 2.1.0 | 1.2.x, 1.3.x, 1.4.x, 1.5.x, 2.0.x | В настоящее время только тестирование на совместимость с версиями Kong 1.2.x и 1.3.x. Для версий 1.4.x и выше, а также для версии 1.3.x по сравнению с версией 1.2.x все основные функции доступны (см. сравнение различий) [https://www.kancloud.cn/raoxiaoyan/kongx/1991178]|

**Обновление:**
История обновлений (docs/upgrade.md).

**Ссылки:**
* Официальный сайт Kong (https://docs.konghq.com/1.2.x/admin-api/);
* Лучшие практики OpenResty (https://www.kancloud.cn/kancloud/openresty-best-practices/50428).