cPanel і WHM

Токен API WHM, а не пароль і не вхід до cPanel. Ви створюєте його в самому WHM, і він передається як звичайний заголовок у кожному запиті агента.

• Хост: адреса WHM разом із https. Якщо не вказати порт, Provibr підставить 2087.
• Користувач WHM: обліковий запис, якому належить токен, зазвичай root.
• Токен API: створений у розділі Manage API Tokens усередині WHM і показаний лише один раз.
• Відбиток TLS: необовʼязковий, і на сервері cPanel його зазвичай залишають порожнім. Розділ нижче пояснює чому.

openssl s_client -connect <host>:2087 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Токен створюють у WHM, від імені того користувача, якому він належатиме. Provibr більше ніколи його не бачить після збереження: він один раз передається вашому агенту й запечатується в сховищі цього агента, а платформа зберігає лише назви полів.

1. 01Увійдіть до WHM як користувач, якому має належати токен, зазвичай root.
2. 02Відкрийте Development, а потім Manage API Tokens.
3. 03Створіть токен і дайте йому назву, з якої видно, що він належить Provibr, щоб потім упізнати його, коли захочете відкликати.
4. 04Скопіюйте токен, перш ніж залишити сторінку. WHM показує його один раз і більше показати не може; якщо втратили, доведеться створювати новий.

Порт 2087 зашифрований, і сервер cPanel зазвичай має сертифікат від публічного центру сертифікації, який панель поновлює сама, приблизно кожні девʼяносто днів. У цьому звичайному випадку поле відбитка залишається порожнім, і агент перевіряє сертифікат так само, як це зробив би браузер.

Заповнюйте його лише тоді, коли сервер показує сертифікат, за який не ручається жоден публічний центр сертифікації, а це на практиці означає власний внутрішній центр. Знімайте відбиток на хості агента, щоб зафіксувати саме те, що побачить агент, і знімайте його знову щоразу, коли цей сертифікат замінюють.

Їх немає. WHM сам вирішує, на якій машині опиниться обліковий запис і яку адресу він отримає, тож вибирати вам нічого. Вкладка налаштувань усе одно існує, бо саме там ви повторно надсилаєте облікові дані.

Пакет WHM — це власний опис облікового запису, який дає сама панель: дискова квота, місячний трафік, скільки піддоменів і поштових скриньок, який перелік можливостей. Це не тариф Provibr і не операційна система — це назва, на яку ми посилаємось, а її вміст може змінитися на вашому сервері непомітно для нас.

Сторінка інтеграції може прочитати перелік пакетів разом із їхнім вмістом, тож ви обираєте з того, що сервер справді має, а не набираєте назву з памʼяті. Пакети створюють у WHM; Provibr їх не створює.

Вебтариф закріплює один пакет на одній інтеграції й дає йому власну назву. Замовлення за тарифом має перевагу над вибором окремого пакета, а вибір окремого пакета лишається для випадків, які тариф не покриває.

Сервер cPanel застосовує дискові квоти лише тоді, коли файлова система, на якій живуть облікові записи, підтримує квоти. Без цього WHM приймає пакет, приймає число й не застосовує нічого.

Перевірка зʼєднання повідомляє про це. Вона читає облікові записи на сервері й каже, чи справді їхні квоти застосовуються, поруч із версією WHM і підрахунками. На сервері без облікових записів вимірювати нічого, і вона так і каже замість того, щоб вгадувати.

Це також причина, чому Provibr читає дискове обмеження з облікового запису, а не з пакета. Те, що повідомляє обліковий запис, — це те, що діє; число в пакеті — це те, що хтось мав на думці.

Увімкнення квот — це робота на сервері, а не в Provibr: файлову систему треба змонтувати з користувацькими квотами, а облікові записи переобчислити. Що саме для цього потрібно, залежить від файлової системи та від того, як установлено машину, тож звертайтеся до свого хостинг-провайдера або до документації cPanel.

Обліковий запис хостингу — це звичайний рядок сервера типу вебсервер. Його ідентифікатором є імʼя користувача cPanel, а основний домен, пакет, зайняте місце й трафік надходять із кожним опитуванням.

• Для створення облікового запису потрібні імʼя користувача, основний домен, контактна адреса, пакет і пароль.
• Імена користувачів дотримуються власного правила WHM: починаються з літери, далі літери та цифри, щонайбільше шістнадцять символів. Без дефісів і без підкреслень.
• Пароль ніде не записується. Лишається тільки той факт, що ви його надали; саме значення передається окремо.
• Далі можна призупинити, поновити, змінити пакет і видалити. Консолі немає, бо обліковий запис хостингу її не має.
• Жодному результату не вірять на слово. WHM підтверджує зміну сторінкою виводу процесу, а не новим станом, тож кожна зміна завершується повторним читанням облікового запису.

Вкладка імпорту показує облікові записи на панелі й дає змогу перенести до Provibr ті, які вам потрібні. Уже відомі облікові записи показані, але вибрати їх удруге не можна, тож ви бачите повну картину, а не відфільтровану.

Зайняте місце й трафік надходять зі звичайним опитуванням, тож обліковий запис отримує графік споживання без жодних додаткових вмикань. Трафік — це місячний підсумок, який сервер скидає сам, тому він показується числом біля облікового запису, а не лінією на графіку.

• Керування самим сервером не існує. Provibr створює, змінює та видаляє облікові записи на WHM, яким керуєте ви; служби, зони DNS, маршрутизація пошти й налаштування самої панелі лишаються там, де вони є.
• Консолі немає. Обліковий запис хостингу не є машиною, тож немає до чого приєднати термінал.
• Поштові скриньки, бази даних і DNS усередині облікового запису належать cPanel. Provibr створює обліковий запис і передає його; те, що відбувається всередині, стосується вашого клієнта й панелі.
• Облікові записи реселерів не змодельовані. Provibr спілкується з WHM як один оператор, а токен реселера бачить менший світ, ніж root, а цей випадок не вимірювався й тут не описаний.