Instalacja, Konfiguracja i Zarządzanie 1
Spis Treści 1. O Module... 3 2. Instalacja... 4 3. Konfiguracja I Zarządzanie... 6 3.1. Strefa Klienta... 6 3.1.1. Zamówienie I Pierwszy Krok Konfiguracji... 6 3.1.2. Drugi Krok Konfiguracji Certyfikatu... 11 3.1.3. Zarządzanie Certyfikatem... 15 3.1.4. Odnowienie Certyfikatu... 19 3.2. Strefa Administratora... 20 3.2.1. Wznowienie Certyfikatu... 22 2
1. O Module Certum Certificates For WHMCS pozwala Ci odsprzedawać szeroki wachlarz certyfikatów wprost z twojej platformy WHMCS. Dodatkowo moduł pozwala na pełne zarządzanie certyfikatami wprost ze strefy klienta twojego WHMCSa. Funkcjonalności Strefy Klienta: Konfiguracja Certyfikatu Przeglądanie Detali Certyfikatu Przeglądanie Certyfikatu Przeglądanie Detali Kontaktu Wysłanie Certyfikatu Ponowna Próba Weryfikacji Certyfikatu Odnowienie Certyfikatu Zmiana Metody Potwierdzenia Anulowanie Certyfikatu Funkcjonalności Strefy Administratora: Stworzenie/Usunięcie Certyfikatu Przeglądanie Detali Certyfikatu Przeglądanie Certyfikatu Przeglądanie Detali Kontaktu Wysłanie Certyfikatu Ponowna Próba Weryfikacji Certyfikatu Odnowienie Certyfikatu Zmiana Metody Potwierdzenia Anulowanie Certyfikatu Informacje Ogólne: Wsparcie Dla WHMCS V5 I Nowszych 3
2. Instalacja W tej sekcji pokażemy Ci jak poprawnie zainstalować i skonfigurować nasz produkt. 1. Zacznij od ściągnięcia Certum Certificates For WHMCS. 2. Wgraj archiwum do głównego katalogu WHMCSa i rozpakuj je. Pliki powinny automatycznie pojawić się we właściwych lokalizacjach. 3. Jeśli korzystasz z innego szablonu niż default, skopiuj do niego pliki configurecertificate.tpl oraz configuressl2.php zawarte w twoj_whmcs/templates/default. Dodatkowo, usuń zawartość folderu templates_c. 4. Zaloguj się do strefy administratora swojego WHMCSa, przejdź do Setup Products/Services Products/Services i wciśnij Create a New Group. 5. Wypełnij pole Product Group Name (pod tą nazwą grupa będzie widoczna w systemie) a następnie zapisz zmiany wciskając Save Changes. 6. Następnie, wciśnij Create a New Product. Wybierz wcześniej stworzoną grupę produktów z menu rozwijanego Product Group. Wypełnij pole Product Name i wciśnij Save Changes. 7. Ustaw ceny typu recurring w zakładce Pricing. Więcej informacji na temat ustawiania cen produktów znajdziesz tutaj: http://docs.whmcs.com/products_and_services#pricing_tab 8. Przejdź do zakładki Module Settings tab i wybierz CERTUM_Certificates z menu rozwijanego Module Name. Wpisz detale dostępu do konta w pola Username i Password a następnie wciśnij Save Changes. 9. W kolejnym kroku wybierz certyfikat, który chcesz oferować swoim klientom w tym produkcie oraz wybierz metodę zatwierdzenia korzystając z menu rozwijanych Product i Approve Method. Dodatkowo, możesz zdefiniować limit domen oraz typ walidacji. Korzystając z pól wyboru możesz zezwolić na wildcardy, dodatkowe domeny oraz dodawanie domen. Potwierdź ustawienia produktu wciskając Save Changes. Product typ certyfikatu, który będzie oferowany w postaci tego produktu. Approve Method metoda weryfikacji certyfikatu. Additional Domains pozwala twojemu klientowi na zdefiniowanie 10 domen dla jednego certyfikatu. Domains Limit definiuje limit domen, które użytkownik może dodać do jednego certyfikatu. Zalecamy użytkowanie z włączoną opcją Allow To Add More Domains. Allow To Add More Domains umożliwia klientowi dodawanie domen do certyfikatu w 4
granicach zdefiniowanych w polu Domains Limit. Validation Type definiuje dokładność walidacji, możliwe opcje to basic(pobieżna) i advanced (bardzo dokładna). WildCard zaznaczenie tej opcji jest wymagane jdla certyfikatu typu WildCard. 10. Gratulacje, właśnie pomyślnie skonfigurowałeś Certum Certificates For WHMCS! Fig. 1: Przykładowe ustawienia produktu Certum Certificate For WHMCS. 5
3. Konfiguracja I Zarządzanie W tej sekcji pokażemy Ci możliwości konfiguracji i zarządzania Certum Certificates For WHMCS tak, by spełniał twoje wymagania. 3.1. Strefa Klienta Wszystkie informacje związane ze strefą klienta Certum Certificates For WHMCS znajdują się w tej sekcji. 3.1.1. Zamówienie I Pierwszy Krok Konfiguracji Zacznijmy od zamówienia wcześniej skonfigurowanego produktu. W tym kroku twój klient nie powinien wybierać domeny, dlatego też zalecamy odznaczenie Require Domain w konfiguracji produktu. Fig. 2: Zamawianie certyfikatu. 6
Kolejnym krokiem jaki twój klient musi podjąć jest konfiguracja certyfikatu. Wciśnij Click to configure certificate by kontynuować. Fig. 3: Strefa klienta Certum Certificates For WHMCS 7
Następnie, wypełnij wygenerowany wcześniej CSR oraz dane kontaktowe. Nie zapomnij o zapisaniu swojego prywatnego klucza wygenerowanego wraz z CSRem. Notka: Dane kontaktowe muszą zgadzać się z danymi użytymi przy generowaniu CSRa. 8
Fig. 4: Konfiguracja certyfikatu. Krok 1. Podawanie detali, część 2. Pole Verification Phone Number umożliwia subskrybentowi podanie numeru telefonu organizacji przez niego reprezentowanej. CERTUM oddzwoni na podany numer telefonu w celu przeprowadzenia weryfikacji. Jeśli pole zostanie pozostawione puste, CERTUM przeprowadzi weryfikację na podstawie nadesłanych dokumentów. 9
Dodatkowo, przewiń stronę w dół i upewnij się, że podane dane administracyjne są poprawne. Potwierdź poprzez kliknięcie Click to Continue. Fig. 5: Certificate configuration. Step 1. Providing details, part 2. 10
3.1.2. Drugi Krok Konfiguracji Certyfikatu Drugi krok zależy od typu certyfikatu, który twój klient zamówił. Poniżej przedstawimy je wszystkie, jeden po drugim. ID Certificate Ten typ certyfikatu nie przewiduje konfiguracji dodatkowych domen, dlatego też nie daje użytkownikowi żadnych możliwości konfiguracji w drugim kroku. Fig. 6: 2gi krok konfiguracji certyfikatu ID. SSL Certificate (Single Domain) Ten typ certyfikatu pozwala klientowi na wybór sposobu weryfikacji oraz zdefiniować czy certyfikat powinien być przypisany do strony z.www czy bez. 11
Fig. 7: 2gi krok konfiguracji certyfikatu SSL. SAN SSL Certificate (Multi Domain) Certyfikat SAN oferuje możliwość konfiguracji wielu domen. Twoi klienci mają możliwość konfiguracji wielu domen ale tylko jeśli opcja Additional Domains jest włączona. Domyślnie klient ma możliwość zdefiniowania 10 domen, dodatkowe domeny klient może zdefiniować jeśli w konfiguracji produktu włączysz opcje Allow To Add More Domains. 12
Fig. 8: 2gi krok konfiguracji certyfikatu SAN SSL. 13
WildCard SSL Certificate (Multi Domain) Konfiguracja certyfikatu WildCard jest podobna do konfiguracji certyfikatu na pojedyńczą domenę. Różnicą jest to, że certyfikat typu WildCard chroni wszystkie subdomeny domeny dla której certyfikat został stworzony. Fig. 9: 2gi krok konfiguracji certyfikatu WildCard SSL. Microsoft Code Signing Ten typ certyfikatu umożliwia twojemu klientowi cyfrowe podpisanie oprogramowania używanego w systemach Microsoft. Fig. 10: 2gi krok konfiguracji certyfikatu Microsoft Code Signing. 14
3.1.3. Zarządzanie Certyfikatem Twoi klienci mają możliwość pełnego zarządzania swoimi certyfikatami wprost z client area twojego WHMCSa. Jak możesz zobaczyć na poniższym zdjęciu, podstawowe informacje o certyfikacie są wyświetlone na głównej stronie produktu. Dodatkowo, twoi klienci mogą wyświetlić certyfikat oraz detale kontaktu dla którego certyfikat został skonfigurowany za pomocą odpowiadającym im przyciskom zaznaczonym na zdjęciu poniżej. Fig. 11: Produkt Certum Certificates For WHMCS w strefie klienta. 15
Na stronie certyfikatu klienci mogą zobaczyć swój certyfikat jak też zapisać go jako plik.cer używając w tym celu przycisku Save. Fig. 12: Strona certyfikatu w strefie klienta. 16
Strona kontaktu zawiera detale kontaktu podane podczas konfiguracji certyfikatu. Fig. 13: Strona z danymi kontaktowymi właściciela certyfikatu. 17
Korzystając z menu rozwijanego Management Actions twoi klienci mają dostęp do wcześniej pokazanych stron jak też do wysyłania certyfikatu, ponownej próby weryfikacji certyfikatu, przedłużenia działania certyfikatu, zmiany sposobu zatwierdzenia certyfikatu oraz anulowania certyfikatu. Send Certificate detale certyfikatu są wysyłane na email właściciela certyfikatu. Resend Notification Email email z weryfikacją certyfikatu jest wysyłany jeszcze raz. Renew Certificate przedłuża okres ważności certyfikatu. Request Cancellation zlecenie usunięcia certyfikatu. Change Approver Email pozwala na zmianę sposobu potwierdzenia certyfikatu. Ta opcja jest dostępna tylko dla niektórych certyfikatów. Fig. 14: Produkt w strefie klienta z wyświetlonymi dodatkowymi akcjami. 18
3.1.4. Odnowienie Certyfikatu Twój klient ma możliwość odnowienia swojego certyfikatu wprost ze strefy klienta twojego WHMCSa. Pamiętaj, że produkt musi korzystać z płatności recurring. Po wypełnieniu formularza i zweryfikowaniu go przez server, nowy certyfikat zostaje wyświetlony a certyfikat który wygasł staje się niedostępny. Wciśnij Renew Certificate w menu rozwijanym Management Actions by kontynuować. By wysłać żądanie przedłużenia ważności certyfikatu, wypełnij pola Serial Number oraz CSR lub pola PEM i CSR. Kod seryjny certyfikatu znajduje się między innymi na głównej stronie produktu. Fig. 15: Formularz odnowienia certyfikatu. 19
3.2. Strefa Administratora Wprost ze strefy administratora możesz zarządzać produktem swojego klienta. Na poniższym zdjęciu możesz zobaczyć strefe administartora poprawnie skonfigurowanego i zweryfikowanego produktu. Wszystkie akcje dostępne w strefie klienta są też dostępne ze strefy administratora. Dodatkowo, administrator ma możliwosć stworzenia oraz usunięcia certyfikatu. Fig. 16: Strefa administratora poprawnie skonfigurowanego produktu. 20
By wyświetlić certyfikat, wciśnij przycisk Details. Fig. 17: Certyfikat produktu wyświetlony w strefie administratora. 21
3.2.1. Wznowienie Certyfikatu Masz możliwość wznowienia certyfikatu wprost ze strefy administratora twojego WHMCSa. Pamiętaj, że opcja dostępna jest tylko z poziomu admina. Po wypełnieniu formularza i zweryfikowaniu go przez server, wznowiony certyfikat ponownie jest dostępny. By kontynuować, przejdź do zakładki Products/Services i wciśnij Reissue w podsekcji Module Commands. Na stronie pojawi się popup. By wysłać żądanie wznowienia certyfikatu, wypełnij pole CSR. Kod seryjny certyfikatu uzupełniany jest automatycznie. Fig. 18: Strefa administratora poprawnie skonfigurowanego produktu. 22
Fig. 19: Formularz wznowienia certyfikatu. 23