HTTPS aktivacija za sigurniju API komunikaciju

Pregled

Ovaj vodič opisuje potrebne korake za konfiguraciju REST interfejsa (Swagger) RetailForce Middlewarea za korištenje HTTPS-a.

Preduvjeti

• Pristup Windows hostu
• Tekstni uređivač (npr. Notepad++ ili Visual Studio Code)

Vodič korak po korak

1. Zaustavite Windows servis

1. Otvorite Upravitelj usluga Windowsa:
   • Pritisnite Win + R, upišite services.msc i pritisnite Enter
   • Alternativno: Putem Kontrolne table → Administrativni alati → Usluge
2. Pronađite uslugu RetailForce na listi
3. Desni klik na uslugu i odaberite "Zaustavi"

2. Uredite konfiguracijsku datoteku

1. Idite u direktorij za instalaciju:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Otvorite datoteku appsettings.json u uređivaču tekstova
3. Provjerite da li su sljedeći parametri u odjeljku "AppSettings" ispravno konfigurisani:

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

   Važno :

   • Provjerite da li su oba UseHttps i UseHttpsRedirection su postavljene na true
   • Specifikacija puta za HttpsCertificateFilename je relativna u odnosu na direktorij instalacije
   • Za produkcijska okruženja koristite valjani, pouzdani certifikat umjesto "development.pfx"

4. Sačuvajte datoteku i zatvorite uređivač

3. Pokrenite Windows servis

1. Vratite se u Upravitelj usluga Windowsa
2. Pronađite servis RetailForce
3. Desni klik na servis i odaberite "Pokreni"

4. Verifikacija

Nakon ponovnog pokretanja usluge, REST krajnje tačke bi sada trebale biti dostupne putem HTTPS-a:

1. Otvorite web preglednik
2. Idite na Swagger UI na:

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

3. Provjerite da se u adresnoj traci prikazuje ikona lokota, što označava sigurnu HTTPS vezu

Sažetak

REST sučelje je sada konfigurirano za korištenje HTTPS-a. Svi API zahtjevi će se automatski preusmjeravati s HTTP-a na HTTPS, što poboljšava sigurnost komunikacije i osigurava integritet podataka.

Ovaj članak je automatski preveden.