HTTPS aktivacija za sigurniju API komunikaciju

Pregled

Ovaj vodič opisuje potrebne korake za konfiguraciju REST sučelja (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 sustava Windows:
   • Pritisnite Win + R, upišite services.msc i pritisnite Enter
   • Alternativno: Putem Upravljačke ploče → Administrativni alati → Usluge
2. Pronađite uslugu RetailForce na popisu
3. Desnom tipkom miša kliknite na uslugu i odaberite "Zaustavi"

2. Uređivanje konfiguracijske datoteke

1. Idite u direktorij za instalaciju:

   • C:\Program Files\RetailForce\Fiscal Webservice

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

   ...  
   "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 su oba UseHttps i UseHttpsRedirection su postavljeni 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. Spremite datoteku i zatvorite uređivač

3. Pokrenite Windows servis

1. Vratite se u Upravitelj usluga sustava Windows
2. Pronađite uslugu RetailForce
3. Desnom tipkom miša kliknite na uslugu i odaberite "Pokreni"

4. Verifikacija

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

1. Otvorite web-preglednik
2. Idite na Swagger korisničko sučelje na adresi:

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

3. Provjerite je li u adresnoj traci prikazana ikona lokota, što označava sigurnu HTTPS vezu

Sažetak

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

Ovaj je članak automatski preveden.