Aktivácia protokolu HTTPS pre bezpečnejšiu komunikáciu cez api

Prehľad

Táto príručka popisuje kroky potrebné na konfiguráciu rozhrania REST (swagger) RetailForce Middleware na používanie protokolu HTTPS.

Predpoklady

• Prístup k hostiteľskému počítaču so systémom Windows
• Textový editor (napr. Notepad++ alebo Visual Studio Code)

Návod krok za krokom

1. Zastavte službu systému Windows

1. Otvorte Správcu služieb systému Windows:
   • Stlačte Win + R, napíšte services.msc a stlačte kláves Enter
   • Prípadne: cez Ovládací panel → Nástroje pre správu → Služby
2. V zozname vyhľadajte službu RetailForce
3. Kliknite pravým tlačidlom na službu a vyberte možnosť „Zastaviť“

2. Upravte konfiguračný súbor

1. Prejdite do inštalačného adresára:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Otvorte súbor appsettings.json v textovom editore
3. Uistite sa, že nasledujúce parametre v sekcii „AppSettings“ sú správne nakonfigurované:

   ...  
   "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é :

   • Uistite sa, že obidva UseHttps aj UseHttpsRedirection sú nastavené na true
   • Špecifikácia cesty pre HttpsCertificateFilename je relatívna voči inštalačnému adresáru
   • V produkčnom prostredí použite platný a dôveryhodný certifikát namiesto „development.pfx“

4. Uložte súbor a zatvorte editor

3. Spustite službu systému Windows

1. Vráťte sa do Správcu služieb systému Windows
2. Vyhľadajte službu RetailForce
3. Kliknite pravým tlačidlom na službu a vyberte možnosť „Spustiť“

4. Overenie

Po reštartovaní služby by mali byť koncové body REST dostupné cez HTTPS:

1. Otvorte webový prehliadač
2. Prejdite na rozhranie Swagger UI na adrese:

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

3. Overte, či sa v adresnom riadku zobrazuje ikona zámku, ktorá označuje zabezpečené HTTPS pripojenie

Zhrnutie

Rozhranie REST je teraz nakonfigurované na používanie protokolu HTTPS. Všetky požiadavky api budú automaticky presmerované z protokolu HTTP na HTTPS, čo zvyšuje bezpečnosť komunikácie a zabezpečuje integritu údajov.

Tento článok bol preložený automaticky.