Aktivacija HTTPS za varnejšo komunikacijo prek api-ja

Pregled

Ta priročnik opisuje potrebne korake za konfiguracijo vmesnika REST (swagger) v RetailForce Middleware za uporabo protokola HTTPS.

Predpogoji

• Dostop do gostitelja Windows
• Besedilni urejevalnik (npr. Notepad++ ali Visual Studio Code)

Navodila po korakih

1. Zaustavite storitev v sistemu Windows

1. Odprite upravitelja storitev sistema Windows:
   • Pritisnite Win + R, vpišite services.msc in pritisnite Enter
   • Druga možnost: prek Nadzorne plošče → Upravna orodja → Storitve
2. Na seznamu poiščite storitev RetailForce
3. Desno kliknite na storitev in izberite »Ustavi«

2. Uredite konfiguracijsko datoteko

1. Pojdite v namestitveni imenik:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Odprite datoteko appsettings.json z urejevalnikom besedil
3. Preverite, ali so naslednji parametri v razdelku »AppSettings« pravilno nastavljeni:

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

   Pomembno :

   • Preverite, ali sta oba UseHttps in UseHttpsRedirection nastavljena na true
   • Specifikacija poti za HttpsCertificateFilename je relativna glede na namestitveni imenik
   • V produkcijskih okoljih namesto »development.pfx« uporabite veljaven, zaupanja vreden certifikat

4. Shranite datoteko in zaprite urejevalnik

3. Zaženite storitev sistema Windows

1. Vrnite se v Upravitelja storitev sistema Windows
2. Poiščite storitev RetailForce
3. Z desnim gumbom miške kliknite na storitev in izberite »Začni«

4. Preverjanje

Po ponovnem zagonu storitve naj bi bile končne točke REST zdaj dostopne prek HTTPS:

1. Odprite spletni brskalnik
2. Pojdite na Swagger UI na naslovu:

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

3. Preverite, ali se v naslovni vrstici prikaže ikona ključavnice, ki označuje varno HTTPS-povezavo

Povzetek

Vmesnik REST je zdaj nastavljen za uporabo protokola HTTPS. Vsa zahtevka api bodo samodejno preusmerjena s protokola HTTP na HTTPS, kar izboljša varnost komunikacije in zagotavlja celovitost podatkov.

Ta članek je bil samodejno preveden.