cPanel

Pozwól Konrado sprawdzać konto hostingowe, którego dotyczy każde zgłoszenie, przez API WHM albo przez wtyczkę Konrado.

Panel hostingowy

Konto hostingowe przy każdym zgłoszeniu

Po podłączeniu cPanel Konrado sprawdza konto hostingowe, którego dotyczy zgłoszenie: pakiet, domeny, DNS, SSL, pocztę i zajęte miejsce na dysku. Konrado tylko czyta. Na Twoim serwerze nic się nie zmienia.

Serwer podłączasz na jeden z dwóch sposobów. Przez API Konrado czyta WHM za pomocą tokenu i niczego nie trzeba instalować. W metodzie Wtyczka Konrado uruchamiasz jedno polecenie jako root, a Konrado czyta też zaporę, CloudLinux i Imunify. API to obecny sposób. Wtyczka to starsza metoda: działa dalej tam, gdzie jest zainstalowana, ale nowy serwer podłącz przez API. Wybierz zakładkę poniżej: każda sekcja dopasuje się do Twojego wyboru.

API

Nic do instalowania

Token API WHM dla roota albo resellera.

Wtyczka Konrado

Starsza metoda

Jedno polecenie jako root. Dodaje dane z zapory, CloudLinux i Imunify.

Dostęp

Tylko odczyt

Konrado nigdy nie zmienia konta.

Agenci dostają

Sprawdzanie kont

Dla klienta, którego dotyczy każde zgłoszenie.

Co czyta Konrado

Dane	Jak pomagają
Konto	Pakiet, limity, wykorzystanie, domeny i właściciel konta
Strona	Katalogi główne, domeny dodatkowe, zaparkowane i subdomeny, rekordy DNS i dane SSL
Poczta	Skrzynki, przekierowania, autorespondery, filtry i zdarzenia doręczenia z ostatnich 24 godzin
Bazy danych	Bazy MySQL, ich użytkownicy i wersja serwera baz danych
Pliki	Krótka lista zawartości katalogu głównego i konta FTP
Kopie zapasowe	Kopie cPanel oraz kopie JetBackup 5, jeśli jest zainstalowany
Serwer	Obciążenie, dyski, usługi i zainstalowane komponenty. Tylko z tokenem roota

Token resellera czyta tylko konta, które należą do tego resellera. Token roota czyta wszystkie konta i sam serwer.

Dane	Jak pomagają
Konto i właściciel	Nazwa użytkownika, właściciel lub reseller, pakiet, limit miejsca, domeny i stan konta
Konfiguracja domen	Domena główna, domeny dodatkowe, zaparkowane i subdomeny, katalog główny, IP, strefa DNS, SSL i wersja PHP
Poczta	Skrzynki, przekierowania, autorespondery, rozmiar skrzynek, ostatnie logi doręczeń Exim, odbicia, odrzucenia, opóźnienia i kolejka poczty
Wykorzystanie	Dysk, transfer, obciążenie, usługi oraz historia CloudLinux (LVE), jeśli działa
Kopie zapasowe	Konta, kopie, pobrania, logi i alerty JetBackup 5, jeśli jest zainstalowany
Bezpieczeństwo	Stan adresu IP w CSF oraz wyniki Imunify360 lub ImunifyAV dotyczące złośliwego oprogramowania, skanów i WAF, jeśli działają

Czego Konrado nie potrafi

Nie da się	Dlaczego
Utworzyć, zawiesić, zmienić pakietu ani usunąć konta	Konrado czyta. Zmiany kont zostają w WHM albo w Twoim systemie rozliczeń
Zmienić DNS, poczty, PHP, SSL, plików, baz danych ani zadań cron	Konrado może je czytać, ale nie zmieniać
Przywrócić kopii, usunąć złośliwego oprogramowania, odblokować IP ani wyczyścić kolejki poczty	Dane o kopiach, bezpieczeństwie i poczcie służą tylko do diagnozy
Pokazać haseł, kluczy ani treści wiadomości	Dane poufne i prywatne wiadomości nigdy nie trafiają do odpowiedzi
Zajrzeć poza serwer	Problem u rejestratora, w CDN albo u innego dostawcy poczty trzeba sprawdzić osobno
Uruchamiać poleceń powłoki	Konrado korzysta ze stałych zapytań, nie z terminala
Czytać zapory, CloudLinux ani Imunify przez API	Te dane daje tylko wtyczka Konrado

Model bezpieczeństwa

Konrado łączy się z WHM przez HTTPS za pomocą jednego tokenu API, który możesz w każdej chwili unieważnić. Nigdy nie wpisuj hasła do WHM w Konrado. Po zapisaniu tokenu konsola pokazuje tylko jego ostatnie znaki.

Działają tylko adresy https://, a certyfikat TLS musi być ważny.
Adres musi prowadzić do publicznego IP. Konrado odrzuca adresy prywatne, pętli zwrotnej i inne wewnętrzne zakresy.
Konrado ogranicza rozmiar każdej odpowiedzi i najpierw usuwa z niej dane poufne.
Konrado korzysta z siedmiu stałych zapytań. Nie może wywołać żadnej innej funkcji WHM.

Model bezpieczeństwa

Polecenie instalacji zawiera klucz, który łączy serwer z Twoją organizacją, więc traktuj je jak hasło. Konrado łączy się potem z wtyczką na porcie 8000, domyślnym. Otwórz ten port dla adresów IP Konrado i dla nikogo więcej.

Przykładowe pytania w zgłoszeniach

"example.com przestała działać po zmianie DNS. Czy jest na właściwym koncie i w dobrym katalogu głównym?"
"Poczta w webmailu dla sales@example.com jest pusta. Czy ta skrzynka istnieje na serwerze?"
"Wiadomości z example.com wracają. Czy w logach doręczeń jest coś, co można podać w odpowiedzi?"
"AutoSSL nie działa dla domeny dodatkowej. Czy dane domeny i certyfikatu to wyjaśniają?"
"Na koncie skończyło się miejsce. Zajmują je pliki, poczta, bazy danych, kopie czy logi?"
"Klient mówi, że ta domena jest jego, ale dane rozliczeń się nie zgadzają. Czy jest na koncie resellera?"

Zanim zaczniesz

cPanel & WHM 110 lub nowszy. Działanie Konrado sprawdziliśmy w całości na wersji 11.134.
WHM pod publicznym adresem HTTPS z ważnym certyfikatem, na porcie 2087, chyba że podasz inny.
Konto roota lub resellera w WHM, które może utworzyć token API.
Jeśli WHM stoi za zaporą, wpuść adresy IP Konrado na port WHM.
Podłączony helpdesk, a w systemie rozliczeń usługa hostingowa klienta. Konrado znajduje konto przez tę usługę, więc jej serwer musi mieć tę samą nazwę hosta lub IP co adres WHM.

Dostęp SSH jako root do serwera cPanel, z curl, unzip i systemd.
Dostęp serwera do internetu. Instalator pobiera wtyczkę i zgłasza się do app.konrado.ai.
Port 8000 otwarty dla adresów IP Konrado (zobacz listę).
Podłączony helpdesk, a w systemie rozliczeń usługa hostingowa klienta. Konrado znajduje konto przez tę usługę, więc jej serwer musi mieć tę samą nazwę hosta lub IP co serwer, na którym instalujesz wtyczkę.

Podłączanie

Utwórz token API w WHM

Zaloguj się do WHM na konto roota lub resellera, z którego ma korzystać Konrado. Otwórz Development › Manage API Tokens i kliknij Generate Token. Wpisz nazwę, na przykład konrado, i wybierz czas ważności zgodny z tym, jak często zmieniasz dane dostępowe. W polu Whitelisted IPs wpisz adresy IP Konrado (zobacz listę) albo zostaw je puste, żeby token działał z każdego adresu.

Formularz Generate API Token w WHM z nazwą tokenu, wyborem czasu ważności i polem Whitelisted IPs

Zezwól na uprawnienia do odczytu

W sekcji Privileges odznacz wszystko, czego Konrado nie potrzebuje, i zaznacz te uprawnienia:

Uprawnienie WHM	Wartość w API
Account Summary	`acct-summary`
Basic System Information	`basic-system-info`
Basic WHM Functions	`basic-whm-functions`
Perform cPanel API and UAPI functions through the WHM API	`cpanel-api`
Manage DNS Records	`manage-dns-records`
MySQL Information	`mysql-info`
SSL Information	`ssl-info`
Track Email	`track-email`
List Accounts	`list-accts`
View Server Status	`status`
View Server Information	`stats`

Nigdy nie zezwalaj na tworzenie, usuwanie i zawieszanie kont, zmianę haseł, restart usług, Manage API Tokens ani Create User Session. Konrado ich nie potrzebuje.

Sprawdzenie Serwer wymaga uprawnień roota. W WHM może to oznaczać All Features (all), co daje tokenowi pełny dostęp roota, choć Konrado tylko czyta. Wybierz token resellera, chyba że potrzebujesz stanu serwera. Token roota chroń listą adresów IP i regularnie go wymieniaj.

Zapisz i skopiuj token

Kliknij Save. WHM pokazuje token tylko raz. Skopiuj go do menedżera haseł. Jeśli go zgubisz, unieważnij go i utwórz nowy.

Lista API Tokens w WHM z nowym tokenem i dozwolonymi adresami IP

Podłącz w Konrado

Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację i wybierz cPanel. W sekcji Jak Konrado ma łączyć się z tym serwerem? opcja Token API jest już wybrana.

Okno cPanel: Token API wybrany zamiast Wtyczki Konrado, a pod nim pola Nazwa integracji, Adres WHM, Nazwa użytkownika i Token API

Pole	Co wpisać
Nazwa integracji	Nazwa dla Twojego zespołu, na przykład `WHM EU`
Adres WHM	Adres WHM, na przykład `https://panel.example.com:2087`. Jeśli pominiesz port, użyty zostanie 2087. Nie wpisuj portu cPanel 2083
Nazwa użytkownika	Konto roota lub resellera, które utworzyło token
Token API	Token z WHM

Kliknij Testuj połączenie. Zielone pole potwierdza token i pokazuje wersję cPanel. Kliknij Podłącz.

Wtyczka to starsza metoda podłączania. Serwery już podłączone w ten sposób działają dalej. Dla nowego serwera wybierz zakładkę API, chyba że potrzebujesz danych z zapory, CloudLinux lub Imunify, które czyta tylko wtyczka.

Wybierz wtyczkę. Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację i wybierz cPanel. W pytaniu Jak Konrado ma łączyć się z tym serwerem? wybierz Wtyczka Konrado. Okno pokazuje trzy kroki i polecenie instalacji.

Uruchom polecenie jako root. Zaloguj się na serwer cPanel przez SSH jako root. Kliknij przycisk kopiowania obok polecenia i wklej je w sesji. Okno ukrywa Twój klucz na ekranie, ale skopiowane polecenie go zawiera, więc traktuj je jak hasło. Klucz działa przez 24 godziny, na dowolnej liczbie serwerów.

bash <(curl -s https://repo.konrado.ai/init.sh) --api-key=YOUR_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install --platform=cpanel

Odpowiedz instalatorowi. Pyta o kilka ustawień, każde ma wartość domyślną: naciśnij Enter, aby ją zachować. Liczą się dwie odpowiedzi. Aby później aktualizować wtyczkę z konsoli, odpowiedz Yes na pytanie Do you want to be able to upgrade this plugin through the Konrado panel? Adres serwera, który proponuje, na przykład http://203.0.113.10:8000/mcp, to adres, pod którym Konrado łączy się z wtyczką.

Poczekaj na połączenie. Okno pokazuje Nasłuchiwanie serwera… i sprawdza co 5 sekund. Gdy wtyczka się zgłosi, pokazuje Połączono pomyślnie i adres serwera. Kliknij Gotowe. Okno możesz zamknąć wcześniej: serwer pojawi się na liście, gdy się połączy. Ponowne uruchomienie polecenia jest bezpieczne.

Sprawdź, czy działa

Serwer widnieje na stronie Integracje ze stanem Połączono. W kolumnie Typ jest cPanel · API, a pod spodem wersja cPanel. Konrado sprawdza połączenie ponownie co godzinę. Otwórz wiersz: zakładka Narzędzia pokazuje siedem zapytań.

Zakładka Narzędzia podłączonego serwera cPanel: siedem zapytań tylko do odczytu, od cpanel_get_client_account do cpanel_get_server_status, każde oznaczone jako odczyt

Żeby później zmienić token, otwórz wiersz, kliknij Zmień obok pola Token API, wklej nowy token i kliknij Zapisz.

Serwer jest na stronie Integracje ze statusem Połączono. Jego Typ to cPanel · Wtyczka, z wersją wtyczki pod spodem. Wiersz nazywa się cpanel Server: kliknij go, aby zmienić nazwę. Ponowne uruchomienie polecenia instalacji przywraca tę nazwę. Konrado sprawdza połączenie co godzinę.

Jeśli coś nie działa

Otwórz wiersz na stronie Integracje. Serwer, który przestał działać, ma stan Nie działa, podpowiedź, co sprawdzić, i dokładny błąd w sekcji Szczegóły techniczne.

Co widzisz	Co zrobić
cPanel WHM URL must use HTTPS.	Wpisz pełny adres `https://`. Zwykłe HTTP nie działa
cPanel WHM URL cannot contain credentials, query parameters, or a fragment.	Wpisz tylko adres i port, na przykład `https://panel.example.com:2087`
cPanel TLS verification failed.	Zainstaluj ważny certyfikat dla nazwy hosta WHM, z pełnym łańcuchem
cPanel rejected the configured WHM API token.	Sprawdź, czy token utworzył podany użytkownik, czy skopiowano go w całości i czy nie wygasł ani nie został unieważniony
This cPanel token cannot read that capability.	Zezwól na uprawnienia podane wyżej albo sprawdź, czy konto należy do tego resellera
The cPanel API request timed out.	Sprawdź, czy WHM odpowiada na swoim porcie i czy zapora wpuszcza adresy IP Konrado (zobacz listę)
Adres wskazuje na sieć prywatną	Użyj publicznej nazwy hosta. Konrado odrzuca adresy prywatne i wewnętrzne
Brak stanu serwera	Stan serwera wymaga tokenu roota
Brak kopii zapasowych	Sprawdź uprawnienia tokenu oraz to, czy JetBackup 5 jest zainstalowany, jeśli oczekujesz jego kopii
Konrado sprawdza złe konto	Sprawdź, czy usługa ze zgłoszenia w systemie rozliczeń jest na tym serwerze

Co widzisz	Co zrobić
Polecenie od razu się zatrzymuje	Uruchom je jako root bezpośrednio na serwerze cPanel
Komunikat Nasłuchiwanie serwera… się nie zmienia	Sprawdź, czy instalator skończył bez błędów i czy serwer łączy się z `app.konrado.ai` przez HTTPS. Po 2 minutach okno pokazuje Trwa dłużej niż zwykle? z tymi samymi wskazówkami
Brak danych z panelu	Sprawdź, czy na serwerze działa cPanel i czy w konsoli wybrano cPanel
Konrado sprawdza złe konto	Sprawdź, czy usługa ze zgłoszenia w systemie rozliczeń jest na tym serwerze

Krok instalacji pokazuje Błąd połączenia. Podaje adres serwera i przyczynę. Sprawdź obie usługi wtyczki, przeczytaj ich ostatnie logi i uruchom je ponownie:

systemctl status   konrado-server.service konrado-root.service
journalctl         -u konrado-server.service -u konrado-root.service --since "15 minutes ago" --no-pager
systemctl restart  konrado-server.service konrado-root.service
systemctl enable   konrado-server.service konrado-root.service
ss -ltnp | grep ':8000'

Ostatni wiersz pokazuje, czy wtyczka nasłuchuje na porcie 8000. Konrado musi mieć dostęp do tego portu: zezwól na adresy IP Konrado w swojej zaporze. Potem uruchom polecenie instalacji ponownie.

Usuń integrację

Otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza (trzy kropki) i wybierz Usuń. Potem unieważnij token w WHM w sekcji Development › Manage API Tokens.

Żeby tylko wstrzymać integrację i zachować ustawienia, wybierz zamiast tego Odłącz.

Odinstaluj wtyczkę z serwera, a potem otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza (trzy kropki) i wybierz Usuń.

Żeby tylko wstrzymać integrację i zachować ustawienia, wybierz zamiast tego Odłącz.

Na tej stronie