Instalacja - Magento

Aby rozpocząć korzystanie z DockRay w Magento, utwórz projekt w DockRay, skopiuj jego token i wygeneruj prywatny klucz API. Token identyfikuje projekt, a klucz prywatny służy do uwierzytelniania instalacji Magento.

Nie masz jeszcze projektu? Przeczytaj instrukcję Zakładanie konta i pierwszego projektu, a następnie wróć do tej dokumentacji, aby zainstalować integrację.

Wymagania systemowe

Integracja DockRay jest przeznaczona dla sklepów opartych na Magento Open Source lub Adobe Commerce w wersji 2.4.4 lub nowszej, a także dla Mage-OS. Wymagane jest środowisko PHP 8.1 lub nowsze.

Pakiet jest dystrybuowany przez Composer pod nazwą dockcodes/dock-ray-magento. Przed instalacją sprawdź dostępność aktualnego wydania w odpowiednim kanale dystrybucji.

Instalacja DockRay w Magento przez Composer

Połącz się z serwerem sklepu i przejdź do katalogu głównego Magento. Następnie wykonaj poniższe polecenia, aby zainstalować pakiet, włączyć moduł i zaktualizować konfigurację aplikacji.

composer require dockcodes/dock-ray-magento
bin/magento module:enable DockCodes_DockRay
bin/magento setup:upgrade

# W trybie produkcyjnym wykonaj również:


bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Po zakończeniu instalacji moduł DockRay będzie dostępny w panelu administracyjnym Magento. W środowisku produkcyjnym wykonuj polecenia zgodnie z procedurą wdrożeniową sklepu.

Konfiguracja tokenu i klucza prywatnego

Połącz instalację Magento z utworzonym projektem DockRay. W panelu administracyjnym przejdź do Sklepy → Konfiguracja → DockRay → Monitoring i wprowadź token projektu oraz klucz prywatny.

Jeśli nie chcesz przechowywać klucza prywatnego w bazie danych, możesz zapisać oba poświadczenia w konfiguracji środowiska za pomocą poniższych poleceń:

bin/magento config:set --lock-env dockray/connection/token TWOJ_TOKEN_PROJEKTU
bin/magento config:set --lock-env dockray/connection/private_key TWOJ_KLUCZ_PRYWATNY

Zastąp TWOJ_TOKEN_PROJEKTU tokenem projektu, a TWOJ_KLUCZ_PRYWATNY wygenerowanym kluczem API. Po zapisaniu wartości za pomocą opcji --lock-env odpowiednie pola są zablokowane w panelu administracyjnym i korzystają z wartości zapisanych w konfiguracji środowiska.

Sprawdzenie integracji w panelu Magento

Po zapisaniu poświadczeń otwórz DockRay → Overview. Na tym ekranie sprawdzisz stan połączenia z DockRay, dostępne funkcje modułu i informacje o ostatnim raporcie podatności. Możesz również wysłać zdarzenie testowe, aby sprawdzić, czy integracja działa prawidłowo.

Do ustawień integracji wrócisz przez pozycję DockRay → Settings w menu administracyjnym Magento. Sekcja Overview służy do przeglądania stanu integracji, a Settings umożliwia zarządzanie konfiguracją.

Weryfikacja po instalacji

Przed uruchomieniem monitoringu upewnij się, że token i klucz prywatny pochodzą z tego samego projektu DockRay. Sprawdź również, czy klucz nie został umieszczony w repozytorium ani w publicznie dostępnym kodzie aplikacji.

Następnie skonfiguruj środowisko, wybierz zakres raportowania i wyślij zdarzenie testowe. Gdy potwierdzisz prawidłowe działanie integracji, możesz włączyć raportowanie dla ruchu produkcyjnego.

Co dalej?

Po instalacji zapoznaj się z instrukcją monitorowania podatności aplikacji w DockRay, aby skonfigurować kontrolę znanych luk bezpieczeństwa i sprawdzać raporty dotyczące komponentów Magento.