Aktivace protokolu HTTPS pro bezpečnější komunikaci přes API

Přehled

Tato příručka popisuje kroky nezbytné pro konfiguraci rozhraní REST (Swagger) middlewaru RetailForce pro použití protokolu HTTPS.

Předpoklady

• Přístup k hostitelskému počítači se systémem Windows
• Textový editor (např. Notepad++ nebo Visual Studio Code)

Podrobný návod

1. Zastavte službu Windows

1. Otevřete Správce služeb systému Windows:
   • Stiskněte Win + R, zadejte services.msc a stiskněte klávesu Enter
   • Alternativně: Přes Ovládací panely → Nástroje pro správu → Služby
2. V seznamu vyhledejte službu RetailForce
3. Klikněte pravým tlačítkem myši na službu a vyberte možnost „Zastavit“

2. Upravte konfigurační soubor

1. Přejděte do instalačního adresáře:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Otevřete soubor appsettings.json v textovém editoru
3. Ujistěte se, že jsou následující parametry v sekci „AppSettings“ správně nakonfigurovány:

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

   Důležité :

   • Ujistěte se, že jsou nastaveny obě hodnoty UseHttps i UseHttpsRedirection jsou nastaveny na true
   • Specifikace cesty pro HttpsCertificateFilename je relativní k instalačnímu adresáři
   • V produkčním prostředí použijte platný a důvěryhodný certifikát namísto souboru „development.pfx“

4. Uložte soubor a zavřete editor

3. Spusťte službu Windows

1. Vraťte se do Správce služeb systému Windows
2. Vyhledejte službu RetailForce
3. Klikněte pravým tlačítkem myši na službu a vyberte možnost „Spustit“

4. Ověření

Po restartování služby by měly být koncové body REST nyní dostupné přes HTTPS:

1. Otevřete webový prohlížeč
2. Přejděte na rozhraní Swagger UI na adrese:

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

3. Ověřte, zda se v adresním řádku zobrazuje ikona zámku, která označuje zabezpečené připojení HTTPS

Shrnutí

Rozhraní REST je nyní nakonfigurováno pro použití protokolu HTTPS. Všechny požadavky API budou automaticky přesměrovány z HTTP na HTTPS, což zvyšuje bezpečnost komunikace a zajišťuje integritu dat.

Tento článek byl přeložen automaticky.