Aktywacja protokołu HTTPS w celu zapewnienia bezpieczniejszej komunikacji API

Przegląd

Niniejszy przewodnik opisuje kroki niezbędne do skonfigurowania interfejsu REST (swagger) RetailForce Middleware w celu korzystania z protokołu HTTPS.

Wymagania wstępne

• Dostęp do hosta z systemem Windows
• Edytor tekstu (np. Notepad++ lub Visual Studio Code)

Instrukcja krok po kroku

1. Zatrzymanie usługi systemu Windows

1. Otwórz Menedżera usług systemu Windows:
   • Naciśnij Win + R, wpisz services.msc i naciśnij klawisz Enter
   • Alternatywnie: poprzez Panel sterowania → Narzędzia administracyjne → Usługi
2. Znajdź usługę RetailForce na liście
3. Kliknij prawym przyciskiem myszy tę usługę i wybierz opcję „Zatrzymaj”

2. Edycja pliku konfiguracyjnego

1. Przejdź do katalogu instalacyjnego:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Otwórz plik appsettings.json za pomocą edytora tekstu
3. Upewnij się, że następujące parametry w sekcji „AppSettings” są poprawnie skonfigurowane:

   ...  
   "AppSettings": {
       "Secret": "****",
       "Portnumber": 7678,
       "PortnumberHttps": 7677,
       "UseHttps": true,
       "UseHttpsRedirection": true,
       "HttpsCertificateFilename": "development.pfx",
       "HttpsCertificatePassword": "changeme",
       "LogName": "RetailForce Fiscalisation",
       "LogEventLog": true,
       "LogLevelFilter": "Debug"
     }
   }
   

   Ważne :

   • Należy upewnić się, że zarówno UseHttps i UseHttpsRedirection są ustawione na true
   • Specyfikacja ścieżki dla HttpsCertificateFilename jest względna względem katalogu instalacyjnego
   • W środowiskach produkcyjnych należy użyć ważnego, zaufanego certyfikatu zamiast pliku „development.pfx”

4. Zapisz plik i zamknij edytor

3. Uruchom usługę systemu Windows

1. Wróć do Menedżera usług systemu Windows
2. Znajdź usługę RetailForce
3. Kliknij prawym przyciskiem myszy na usłudze i wybierz opcję „Uruchom”

4. Weryfikacja

Po ponownym uruchomieniu usługi punkty końcowe REST powinny być teraz dostępne za pośrednictwem protokołu HTTPS:

1. Otwórz przeglądarkę internetową
2. Przejdź do interfejsu Swagger UI pod adresem:

   https://[server-name]:7677/swagger/index.html

3. Sprawdź, czy w pasku adresu wyświetla się ikona kłódki, wskazująca na bezpieczne połączenie HTTPS

Podsumowanie

Interfejs REST został skonfigurowany do korzystania z protokołu HTTPS. Wszystkie żądania api będą automatycznie przekierowywane z protokołu HTTP na HTTPS, co zwiększa bezpieczeństwo komunikacji i zapewnia integralność danych.

Ten artykuł został przetłumaczony automatycznie.