Konradodocs
PołączeniaIntegracjeIntegracje serwerowePanele hostingowe

Enhance

Pozwól Konrado sprawdzać strony WWW, których dotyczą zgłoszenia, za pośrednictwem API Enhance.

Enhance
Panel hostingowy
Strony WWW, których dotyczy każde zgłoszenie

Po podłączeniu Enhance Konrado sprawdza strony WWW powiązane ze zgłoszeniem: miejsce na dysku, DNS, ustawienia poczty, błędy strony, kopie zapasowe, bazy danych i FTP. Działa wyłącznie w trybie odczytu. Nic w Twoim panelu się nie zmienia.

Łączysz się za pomocą tokenu dostępu Enhance. Na Twoich serwerach niczego się nie instaluje.

Połączenie
Bez instalacji
Token dostępu Enhance i ID Twojej organizacji.
Dostęp
Tylko odczyt
Konrado nigdy nie zmienia strony, skrzynki pocztowej ani ustawień.
Zakres
Jeden klient
Klient, który otworzył zgłoszenie, lub jeden klient resellera.
Narzędzia agenta
8 sprawdzeń
Strona WWW, DNS, poczta, błędy strony, kopie zapasowe, bazy danych, pliki i serwery.

Co czyta Konrado

Konrado wyszukuje konto w Enhance należące do klienta, który otworzył zgłoszenie, i odczytuje wyłącznie strony z tego konta.

Gdy zgłoszenie pochodzi od jednego z Twoich resellerów, Konrado może wyświetlić listę klientów tego resellera oraz ich strony, po czym odczytać tę, której dotyczy zgłoszenie.

DaneCo czyta Konrado
Strona WWW i dyskCzy strona jest aktywna, czy zawieszona, jej wersję PHP, wykorzystane i pozostałe miejsce na dysku, limity oraz zużycie w pakiecie, transfer w bieżącym miesiącu, a także każdą domenę wraz z jej certyfikatem SSL
DNSCzy każda domena wskazuje na Twój serwer, również gdy jej DNS znajduje się w Cloudflare lub u rejestratora, a także strefę DNS zapisaną w Enhance
Poczta e-mailAdresy, pojemność skrzynek, aliasy, przekierowania, catch-all, włączenie autorespondera, ustawienia spamu, parametry IMAP, POP i SMTP dla programu pocztowego, a dla każdej domeny poprawność DKIM i SPF wraz z kluczem publicznym DKIM
Błędy stronyNajnowsze wiersze dziennika błędów PHP strony oraz wersję WordPressa. Tylko do odczytu. Hasła i klucze w dzienniku są ukryte
Kopie zapasoweJakie kopie istnieją, kiedy każda z nich została wykonana, jej rozmiar oraz czy obejmuje pliki, bazy danych i pocztę
Bazy danychNazwę i rozmiar każdej bazy, jej użytkowników oraz uprawnienia poszczególnych użytkowników
PlikiKonta FTP i katalog, w którym każde z nich się otwiera, a także katalog główny (document root) każdej domeny
Stan serwerówCzy serwery obsługujące strony klienta działają, ile mają wolnego miejsca na dysku i czy czeka na nich aktualizacja

Daje to osiem sprawdzeń. Nie obejmują one adresów IP serwerów ani innych szczegółów wewnętrznych.

Pakiet w Enhance może zawierać kilka stron WWW. Konrado odczytuje stronę wskazaną w zgłoszeniu lub domenę przypisaną do usługi w WHMCS. Gdy klient ma kilka stron WWW i w żadnym z tych miejsc nie podano konkretnej, Konrado widzi listę domen i nie czyta żadnej z nich, dopóki nie dowie się, o którą chodzi.

Czego Konrado nie potrafi

Nie da sięDlaczego
Zmienić strony, skrzynki pocztowej, rekordu DNS, bazy danych, kopii zapasowej ani ustawieniaKonrado tylko czyta. Zmiany wprowadza się bezpośrednio w Enhance
Przywrócić lub pobrać kopii zapasowej ani sprawdzić zawartości bazy danychPołączenie Konrado z Enhance nie zawiera zapytań tego typu
Pokazać haseł, kluczy prywatnych ani linków logowaniaKonrado nigdy o nie nie prosi i usuwa wszystko, co znajdzie w danych zwróconych przez Enhance
Odczytać stron innego klientaKonrado odrzuca domenę spoza konta klienta ze zgłoszenia, zanim wyśle zapytanie do Enhance
Odczytać dzienników dostarczania pocztySą to pliki na serwerze pocztowym, a nie w API Enhance. Wiadomość o niedoręczeniu (bounce) wklejona do zgłoszenia jest nadal odczytywana
Wypisać katalogów ani odczytać plikówKonrado sprawdza, gdzie znajdują się pliki, a nie co zawierają
Odczytać błędów PHP starszych niż ostatnie 256 KB dziennikaEnhance zwraca wyłącznie ostatnie 256 KB dziennika błędów PHP strony
Model bezpieczeństwa

Konrado łączy się z Enhance przez HTTPS za pomocą jednego tokenu dostępu, który możesz usunąć w dowolnym momencie. Po zapisaniu tokenu konsola pokazuje tylko jego ostatnie znaki.

  • Enhance nie ma roli tylko do odczytu dla tokenu. Konrado potrafi wysyłać do Enhance wyłącznie zapytania odczytujące. Nie może wprowadzić żadnej zmiany.
  • Działają wyłącznie adresy https://, a certyfikat TLS musi być ważny.
  • Adres musi prowadzić do publicznego IP. Konrado odrzuca pule prywatne, pętlę zwrotną (loopback) i inne zakresy wewnętrzne.
  • Konrado korzysta z ośmiu stałych sprawdzeń i pobiera listę klientów resellera. Nie potrafi wykonać w panelu niczego innego.
Przykładowe pytania w zgłoszeniach
  • "Na mojej stronie wyświetla się komunikat o zapełnieniu dysku. Ile miejsca zostało w moim pakiecie?"
  • "Domena została przeniesiona i strona się nie ładuje. Czy wskazuje na Wasz serwer?"
  • "Jak skonfigurować pocztę na telefonie?"
  • "Moje wiadomości trafiają do spamu. Czy dla mojej domeny jest skonfigurowany DKIM?"
  • "Na mojej stronie pojawia się błąd krytyczny. Co jest napisane w dzienniku błędów PHP?"
  • "Czy mam kopię zapasową sprzed wczoraj?"

Zanim zaczniesz

  • Enhance pod publicznym adresem HTTPS z ważnym certyfikatem, na porcie 443, chyba że podasz inny.
  • Dostęp do Twojej głównej organizacji w panelu Enhance w celu utworzenia tokenu dostępu.
  • Jeśli panel znajduje się za zaporą sieciową lub WAF, zezwól na adresy IP Konrado.
  • WHMCS podłączony do Konrado, z hostingiem Enhance sprzedawanym przez oficjalny moduł Enhance dla WHMCS. Konrado wyszukuje klienta przez tę usługę, dlatego serwer usługi musi mieć taką samą nazwę hosta lub adres IP jak Adres Enhance. Nie trzeba instalować niczego więcej: addon Konrado przesyła już wszystko, co potrzebne.

Oficjalny moduł zapisuje adres e-mail klienta jako nazwę użytkownika usługi. Konrado wyszukuje konto klienta w Enhance po tym adresie e-mail, więc zamówienia bez domeny również działają.

Podłączanie

Utwórz token dostępu

W panelu Enhance utwórz token dostępu w swojej głównej organizacji, wybierając rolę Support. To najbardziej ograniczona rola, która pozwala na wykonanie wszystkich ośmiu sprawdzeń. Skopiuj cały token: jego ID, znak podkreślenia oraz część tajną. Sama część tajna nie zadziała.

Z rolą Support Konrado nie może wyszukać strony po samej domenie. Token z rolą SuperAdmin lub Sysadmin na to pozwala i również działa.

Podczas tworzenia tokenu ogranicz go także do adresów IP Konrado (zobacz listę) i ustaw datę wygaśnięcia, jeśli Twoja konfiguracja na to pozwala. Po wygaśnięciu tokenu Konrado przestanie odczytywać Enhance do momentu wklejenia nowego.

Znajdź ID swojej organizacji

Konrado potrzebuje ID Twojej głównej organizacji w Enhance. Jest to ta sama wartość, o którą oficjalny moduł Enhance dla WHMCS pyta jako serwerowy Username. W WHMCS otwórz swój serwer Enhance i skopiuj jego Username.

Połącz w Konrado

Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację i wybierz Enhance.

Okno Enhance z polami Nazwa integracji, Adres Enhance, ID organizacji i Token dostępu
PoleCo wpisać
Nazwa integracjiNazwa dla Twojego zespołu, na przykład Enhance UK
Adres EnhanceAdres panelu, na przykład https://panel.example.com. Jeśli go pominiesz, użyty zostanie port 443
ID organizacjiID Twojej głównej organizacji
Token dostępuToken z Enhance

Kliknij Testuj połączenie. Konrado sprawdza trzy rzeczy:

  1. Czy podany adres odpowiada jak panel Enhance.
  2. Czy ID organizacji istnieje w tym panelu.
  3. Czy token ma uprawnienia do odczytu Twoich klientów.

Zielony komunikat potwierdza poprawność tokenu i pokazuje wersję Enhance. Jeśli token pozwala na więcej, niż Konrado potrzebuje, żółty komunikat poniżej informuje, że wystarczy token z rolą Support. Kliknij Połącz.

Sprawdź, czy działa

Panel widnieje na stronie Integracje ze statusem Połączono. W polu Typ widnieje Enhance, a pod nim wersja Enhance. Konrado testuje połączenie ponownie co godzinę. Po otwarciu wiersza w zakładce Narzędzia zobaczysz listę ośmiu sprawdzeń.

Następnie otwórz zgłoszenie od klienta, którego hosting działa na tym panelu, i zapytaj o jego stronę WWW. Szkic może zawierać nazwę strony klienta, ilość miejsca na dysku lub stan DNS.

Aby później zmienić token, otwórz wiersz, kliknij Zmień obok pola Token dostępu, wklej nowy i kliknij Zapisz.

Jeśli coś nie działa

Otwórz dany wiersz na stronie Integracje. W przypadku połączenia, które przestało działać, pojawi się status Nie działa, wskazówka, co sprawdzić, oraz dokładny błąd w sekcji Szczegóły techniczne.

Co widziszCo zrobić
Enhance URL must use HTTPS.Wpisz pełny adres https://. Zwykłe HTTP nie działa
Enhance URL cannot contain credentials, query parameters, or a fragment.Wpisz wyłącznie adres, na przykład https://panel.example.com
This address does not answer like an Enhance control panel.Wpisz adres panelu, do którego się logujesz
Enhance found no organization with this id.Sprawdź Adres Enhance. Następnie skopiuj ponownie ID swojej głównej organizacji, zgodnie z opisem w sekcji Znajdź ID swojej organizacji
Paste the whole Enhance access token: its id, an underscore and the secret.Skopiuj token jeszcze raz, w całości. Sama część tajna nie działa
This access token cannot read this organization's customers.Podaj ID swojej głównej organizacji, a nie klienta. Następnie utwórz w niej token z rolą Support
Enhance refused this access token.Wklej cały token: jego ID, znak podkreślenia oraz część tajną. Upewnij się, że token nie wygasł i nie został usunięty
Enhance does not allow this access token from Konrado's IP address.Dodaj adresy IP Konrado do listy dozwolonych adresów IP tokenu (zobacz listę)
Enhance TLS verification failed.Zainstaluj ważny certyfikat dla nazwy hosta panelu wraz z pełnym łańcuchem certyfikatów
The Enhance API is temporarily unavailable.Upewnij się, że panel działa, że Adres Enhance jest prawidłowy oraz że zapora sieciowa lub WAF wpuszcza adresy IP Konrado
The Enhance API request timed out.Upewnij się, że panel odpowiada przez HTTPS oraz że zapora sieciowa lub WAF wpuszcza adresy IP Konrado (zobacz listę)
Blocked: target resolves to a private/internal addressUżyj publicznej nazwy hosta. Konrado odrzuca adresy prywatne i wewnętrzne
Połączono, ale odpowiedzi nigdy nie wspominają o stronie klientaSprawdź, czy usługa w WHMCS znajduje się na serwerze o nazwie hosta lub IP panelu oraz czy jej nazwa użytkownika to adres e-mail konta klienta w Enhance. Konrado niczego nie odczyta, jeśli żaden klient lub więcej niż jeden ma taki adres e-mail w Enhance

Usuń integrację

Otwórz Ustawienia obszaru roboczegoIntegracje, rozwiń menu wiersza (trzy kropki) i wybierz Usuń. Następnie usuń token dostępu w Enhance.

Aby wstrzymać działanie integracji i zachować ustawienia, wybierz zamiast tego opcję Rozłącz.

Ostatnia aktualizacja:

Na tej stronie