Skip to main content

Контрол панели интеграциясын жакшыртуу

Жалпы маалымат​

Enhance — бул күчтүү хостинг автоматташтыруу жана башкаруу мүмкүнчүлүктөрүн камсыз кылган заманбап контрол панэли. Бул интеграция Ultimate Multisite менен Enhance Control Panel ортосунда доменддердин автоматтык синхрондоосуна жана SSL сертификатын башкарылышына мүмкүндүк берет.

Байланыштуу талкуу: Коомдук кеңештер жана кошумча маалымат үчүн GitHub Талкуусу #265 сыяктуу жерди караңыз.

Функциялар​

  • Ultimate Multisiteде домендер картасы жасалганда домендөрдүн автоматтык синхрондоосу
  • DNS чечилгенде LetsEncrypt аркылуу SSL сертификатын автоматтык берүүсү
  • Субдомендерди колдонуу — субдомен режимде иштеп жаткан тармактар үчүн
  • Карталар өчүрүлгөнү домендөрдүн алынышы
  • API киргизүүлөрүн текшерүү үчүн байланышты сынап көрүү

Талаптар​

Системалык талаптар​

  • Enhance Control Panel орнотулган жана жеткиликтүү болушу керек
  • WordPress Multisite орнотулган жана Enhance серверде же ага туташкан
  • Apache вебсервери (Enhance учурда Apache конфигурацияларын колдойт; LiteSpeed Enterprise арзан баа менен жеткиликтүү)

API кирүү​

API токендерин түзүү үчүн Enhance Control Panel администраторлук укугуңуз болушу керек.

API киргизүүлөрүңүздү алуу​

1. API Токени түзүү​

  1. Администратор катары Enhance Control Panelге кириңиз
  2. менюдагы Settings (Жаңылатуулар) баскычына басыңыз
  3. Access Tokens (Кирүү токендери) бөлүмүнө өтүңүз
  4. Create Token (Токенди түзүү) баскычына басыңыз
  5. Токенге сүрөттөмөлүү аталыш бериңиз (мисалы, "Ultimate Multisite Интеграциясы")
  6. System Administrator (Система администратору) ролун тандаңыз
  7. Убакыт аякташы үчүн:
    • Токен эч качан убактысын өтпөсүн калтырсаңыз
    • Же кооптуулук максаты үчүн белгилүү бир мөөнөтү коюңуз
  8. Create (Чыгаруу) баскычына басыңыз

Создание завершено, и у вас будут отображены Access Token (Токен доступа) и Organization ID (Идентификатор организации). Сохраните их немедленно, так как токен будет показан только один раз.

2. Получение Идентификатора Организации (Get Your Organization ID)​

Идентификатор организации отображается на странице Access Tokens в синем информационном блоке с надписью "Org ID: {your_id}".

Идентификатор организации имеет формат UUID, который выглядит так: d8554b6d-5d0d-6719-009b-fec1189aa8f3

Вы также можете найти Идентификатор организации клиента, сделав следующее:

  1. Перейдите на страницу Customers (Клиенты).
  2. Нажмите Manage customer (Управление клиентом) для нужного клиента.
  3. Посмотрите на URL — Идентификатор организации это буквенно-цифровые символы после /customers/.

3. Получение Идентификатора Сервера (Get Your Server ID)​

Чтобы найти ваш Идентификатор сервера (он нужен для операций с доменом):

  1. В Enhance Control Panel перейдите в раздел Servers (Серверы).
  2. Нажмите на сервер, где установлен ваш WordPress.
  3. Идентификатор сервера (в формате UUID) будет виден либо в URL, либо в деталях сервера.
  4. Или вы можете использовать API для списка серверов:
curl -s -X GET https://your-enhance-panel.com/api/servers \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" | jq

Идентификатор сервера имеет формат UUID: 00000000-0000-0000-0000-000000000000

4. Получение URL API (Get Your API URL)​

Ваш URL API — это URL вашей Enhance Control Panel с добавлением /api/:

https://your-enhance-panel.com/api/

Важно: Путь /api/ обязателен. Распространенные ошибки включают:

  • Использование только домена без /api/.
  • Использование HTTP вместо HTTPS (для безопасности требуется HTTPS).

Настройка (Configuration)​

Обязательные константы (Required Constants)​

Добавьте следующие константы в ваш файл wp-config.php:

Интеграция аркы аркы орнотуучу менен​

  1. WordPress администратордук панелинде Ultimate Multisite > Settings (Жаңылыктар) бөлүмүнө кириңиз.
  2. Integrations (Интеграциялар) табасына барыңыз.
  3. Enhance Control Panel Integration (Уюлдук башкаруу панети интеграциясы) дегенди таап, Configuration (Конфигурация) баскычын басыңыз.
  4. Уюлдук аркылуу сизге орнотуу боюнча көрсөтмөлөр берилет:
    • 1-кадам: Киришүү жана функциялардын көзөмөлдөөсү жөнүндө маалымат.
    • 2-кадам: API киргизүүлөрүңүздү (Токен, API URL, Сервер ID) киргизиңиз.
    • 3-кадам: Байланышты текшериңиз.
    • 4-кадам: Текшерүү жана активдештирүү.

Сиз төмөнкүлөрдү тандап койсоңуз болот:

  • Уюлдук аркылуу константаларды wp-config.php файлына автоматтык түрдө киргизүүгө уруксат бериңиз.
  • Константалардын аныктамаларын көчүрүп, аларды колдонууга өзүңүз кошуп койсоңуз болот.

Кошумча WordPress конфигурациясы​

Колкымдардын пикирине таянып ([Discussion #265]), сизге бул кошумча параметрлерди орнотуу керек болушу мүмкүн:

.htaccess Конфигурациясы​

Домен картасында көйгөйлөр тууласа:

  1. Оригинал Enhance .htaccess файлына өчүрүңүз.
  2. Адаптацияланган WordPress Multisite .htaccess файлы менен алмаштырыңыз.

Карталанган домендер аркылуу кукилерди туура башкаруу үчүн бул константаларды wp-config.php файлына кошуңуз:

define('COOKIE_DOMAIN', $_SERVER['HTTP_HOST']);
define('COOKIEPATH', '/');
define('ADMIN_COOKIE_PATH', '/');

Ал кандай иштейт?​

Домен карталганда​

  1. Пользователь Ultimate Multisite'тада кастомный домендиңи табигетке маптайт (же жаңы сайт поддомен режиминде түзүлсө).
  2. Интеграция Enhance API-сына POST сурагын жөнөтөт: /servers/{server_id}/domains.
  3. Enhance домени сиздин сервер конфигурацияңызга кошот.
  4. DNS сиздин серверге чектегенде, Enhance LetsEncrypt аркылуу SSL сертификатын автоматтык түрдө камсыз кылат.
  5. Домен HTTPS менен активдүү болот.

Домен алынса качан​

  1. Ultimate Multisite'та домен маптайт ажыратылат.
  2. Интеграция Enhance-га домендин ID'син табуу үчүн сурагын жөнөтөт.
  3. /servers/{server_id}/domains/{domain_id} дарылуу (DELETE) сурагы жөнөтүлөт.
  4. Enhance домени сиздин сервер конфигурацияңыздан алып салат.

DNS жана SSL текшерүү​

Ultimate Multisite'та киргизилген DNS жана SSL текшерүү бар:

  • Текшер аралыгын Domain Mapping Settingsде (көрсөткүч: 300 секунд/5 мүнөт) коюуга болот.
  • Система доменди активдүү деп белгилөө алдында DNS таралышын текшерет.
  • SSL сертификатын күчтүүлүгү автоматтык түрдө текшерилет.
  • Enhance SSL камсыздоо ишин автоматтык түрдө жүргүзбөйт, ошондуктан колдонуучу тараптан колу менен SSL конфигурациялоо талап кылынбайт.

Орноту текшерүү​

Байланышты сынап көрүү​

  1. Интеграция Wizard'ында Test Connection кадамын колдонуңуз.
  2. Плагин сиздин сервердеги домендерди тизмелөөгө аракет кылат.
  3. Ийгиликтүү билдирүү төмөнкүлөрдү тастыктайт:
    • API киргизүүлөрү туура
    • API URL'и жеткиликтүү
    • Server ID туура
    • Укуктар туура коюлган

Доменди маптандыktan кийин​

  1. Ultimate Multisite'та тест домени маптайт.
  2. Ultimate Multisite логдорун текшериңиз (Ultimate Multisite > Logs > integration-enhance).
  3. Enhance Control Panelде домен кошолуп жатканын текшериңиз:
    • Servers > Your Server > Domains багытына кириңиз.
    • Жаңы домен тизмеде пайда болушу керек.
  4. DNS таралышы болгондон кийин, SSL автоматтык түрдө камсыз кылынганды текшериңиз.

Кырдаалды Араалануу (Troubleshooting)​

API Байланышы Керектенбейт​

Катаал: "Enhance API'сине тута албады"

  • WU_ENHANCE_API_URL аягында /api/ болуп бүткөнүн текшериңиз.
  • HTTPS колдонуп жатканыңызга, HTTP эмес экенине шилетме.
  • Enhance панелинде сиздин WordPress серверден жеткиликтүү экенин текшериңиз.
  • Байланышты токтотуучу Firewall эрежелери жокпу жетектеңиз.

Катаал: "Enhance API Токени табылган жок"

  • WU_ENHANCE_API_TOKEN wp-config.php файлында аныкталганды текшериңиз.
  • Токен Enhance-де өчүрүлбөй же убактысы өтпөй калганын текшериңиз.
  • Токен маанисинде жазуу каталары бар экенин текшериңиз.

Катаал: "Сервер ID конфигурацияланбайт"

  • WU_ENHANCE_SERVER_ID wp-config.php файлында аныкталганды текшериңиз.
  • Сервер ID туура UUID форматында экенин текшериңиз.
  • Сервердин Enhance панелинде бар экенин тастырыңыз.

Домен Койлучы Эмес​

Логдорду текшериңиз:

  1. Ultimate Multisite > Logs бөлүмүнө кириңиз.
  2. integration-enhance боюнча фильтрдеп көрүңүз.
  3. Маселени көрсөткөн ката билдирүүлөрүн издеңиз.

Көрсөтүлгөн себептер:

  • Домен аты туура эмес форматта болушу мүмкүн.
  • Домен Enhance-де алдын ала бар болушу мүмкүн.
  • API укуктары жетишсиз болушу мүмкүн (токендө Система Администратор (System Administrator) ролу бардыгын текшериңиз).
  • Сервер ID Enhance-деги чыныгы сервер менен дал келбеши мүмкүн.

SSL Сertifikat Маселелери​

SSL колдонулуп берилбейт:

  • DNS сиздин сервердин IP дарегине багытталганын текшериңиз.
  • Домен туура чексилдиребиши керек экенин текшериңиз: nslookup yourdomain.com
  • Enhance SSL колдонуп бериши үчүн DNS чексилдириши керек.
  • SSL колдонуу адатта DNS таралышынан кийин 5-10 мүнөт келет.
  • SSL-ге тиешелүү каталарды Enhance Control Panel логдорунда текшериңиз.

Enhance-те колдонулган врувардык (Manual) SSL чексилдириши:

  1. Servers > Your Server > Domains бөлүмүнө кириңиз.
  2. Домени таап, анын SSL статусун текшериңиз.
  3. Керектүү болсо, SSL колдонуп беришни врувардык түрдө ишке киргизе аласыз.

DNS Чексилдирилиш Интервалы​

Домендер же SSL сертификаттар активдерип узак убарышы бар болсо:

  1. Ultimate Multisite > Settings > Domain Mapping-ге кириңиз.
  2. DNS Check Interval орнотусун таап алыңыз.
  3. Дефолт 300 секунддан төмөн баага (минималдуу: 10 секунд) өзгөртүңүз.
  4. Эскертүү: Төмөнкү аралыктар аркылуу көбүрөөк текшерүү жүргүзүлөт, бирок сервердин жүктөмү жогору болушу мүмкүн.

Аутентификация каталары​

HTTP 401/403 каталары:

  • Enhance-те API токенинди жаңылаңыз (Regenerate your API token in Enhance).
  • Токенде System Administrator ролу бар экенин текшериңиз.
  • Токенунун өтүп кетпеге регистриленгенди текшериңиз.
  • Ушул токенде туура Уюм ID (Organization ID) колдонулганын камсыздаңыз (бирок ал URL-де адатта талап кылынбайт).

Журналды талдоо​

Толук журналдарды активдериңиз:

// Кошуңуз wp-config.php файлына кошуңуз, бул көбүрөөк багттоо үчүн керек
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

Андан кийин журналдарды төмөндөгү жерлерден текшериңиз:

  • Ultimate Multisite журналдары: Ultimate Multisite > Logs
  • WordPress багттоо журналы: wp-content/debug.log
  • Enhance панелиндеги журналдар: Enhance'тин административдик интерфейшинде жеткиликтүү болот

API Референси​

Аутентификация​

Бардык API сураныштары Bearer токени аркылуу аутентификациядан өтөт:

Authorization: Bearer YOUR_TOKEN_HERE

Колдонулган Көрсөткүчтөр (Endpoints)​

Серверлер тизмелөө:

GET /servers

Сервердөгү домендерди тизмелөө:

GET /servers/{server_id}/domains

Домен кошуу:

POST /servers/{server_id}/domains
Body: {"domain": "example.com"}

Доменү өчүрүү:

DELETE /servers/{server_id}/domains/{domain_id}

Толук API Документациясы​

Толук API документациясы: https://apidocs.enhance.com

Ички иш-чаралар (Best Practices)​

Коопсуздук (Security)​

  • API токендерин эч качан версия контролдо киргизбеңиз
  • Токендерди wp-config.php файлына сактаңыз, аны Git'тен алып салуу керек
  • Туура укуктарды бар токендерди колдонуңуз (толук интеграция үчүн Система Администратору)
  • Продукциялык чөйрөлөр үчүн токендүн созулуп кетүү мөөнөттөрүн белгилеңиз
  • Токендерди үзгүлтүксүз алмаштырыңыз

Аткаруу (Performance)​

  • Артыкчылыктуу API чакырууларды азайтуу үчүн стандарттык DNS текшерүү аралыгын (300 секунд) колдонуңуз
  • Чоң масштабдуу домен операцияларын жүргүзүп жатканда Enhance сервердин ресурстарын көзөмөлдөңүз
  • Көптөн бир эле учурда көптөгөн домендерди мапполоо керек болсо, домендерди катардан ишке киргизүүнү карап көрүңүз

Көзөмөл (Monitoring)​

  • Интеграция каталарын аныктоо үчүн Ultimate Multisite логдорун үзгүлтүксүз текшериңиз
  • Домендердин ишке киргизилишинин каталарын көзөмөлдөө системасын орнотосуз
  • SSL сертификаттары туура жаратылып жатканын текшериңиз
  • Enhance сервердин жогорку деңгээли жана домендердин чектөөлөрүн көзөмөлдөңүз

Кошумча булактар (Additional Resources)​

Колдоо (Support)​

Эгерде көйгөйлөргө туш келсеңиз:

  1. Жогорудагы Ойлонуу (Troubleshooting) бөлүмүн текшериңиз
  2. Ultimate Multisite логдорун карап чыгыңыз
  3. GitHub Талкуусуна кайрылыңыз
  4. Панельге тиешелүү маселелер үчүн Enhance колдоо кызматына кайрылыңыз
  5. Коомдук жардам алуу үчүн кылдат каталык логдор менен жаңы талкуу жаратыңыз

Эскертүүлөр (Notes)​

  • Бул интеграция только для псевдонимов доменов; Enhance автоматически управляет SSL.
  • Интеграция поддерживает как сопоставление пользовательских доменов, так и сайты на основе поддоменов.
  • Автоматическое создание поддомена www можно настроить в настройках сопоставления доменов (Domain Mapping).
  • На данный момент Enhance поддерживает конфигурации Apache (доступна LiteSpeed Enterprise).
  • Удаление домена из Ultimate Multisite удалит его из Enhance, но связанные с ним SSL-сертификаты могут не быть удалены сразу.