HTTPS-aktiválás a biztonságosabb api-kommunikáció érdekében

Áttekintés

Ez az útmutató bemutatja a RetailForce Middleware REST-interfészének (swagger) HTTPS-re történő konfigurálásához szükséges lépéseket.

Előfeltételek

• Hozzáférés a Windows-géphez
• Szövegszerkesztő (pl. Notepad++ vagy Visual Studio Code)

Lépésről lépésre

1. Állítsa le a Windows-szolgáltatást

1. Nyissa meg a Windows Szolgáltatáskezelőt:
   • Nyomja meg a Win + R, írja be services.msc , majd nyomja meg az Enter billentyűt
   • Vagy: Vezérlőpult → Felügyeleti eszközök → Szolgáltatások
2. Keresse meg a listában a RetailForce szolgáltatást
3. Kattintson a jobb gombbal a szolgáltatásra, és válassza a „Leállítás” lehetőséget

2. A konfigurációs fájl szerkesztése

1. Keresse meg a telepítési könyvtárat:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Nyissa meg a fájlt appsettings.json egy szövegszerkesztővel
3. Győződjön meg arról, hogy az „AppSettings” szakaszban a következő paraméterek helyesen vannak beállítva:

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

   Fontos :

   • Győződjön meg arról, hogy mindkettő UseHttps és UseHttpsRedirection beállítva legyen true
   • A HttpsCertificateFilename a telepítési könyvtárhoz viszonyított
   • Termelési környezetben a „development.pfx” helyett érvényes, megbízható tanúsítványt használjon

4. Mentse el a fájlt, majd zárja be a szerkesztőt

3. Indítsa el a Windows-szolgáltatást

1. Térjen vissza a Windows Szolgáltatásokkezelőbe
2. Keresse meg a RetailForce szolgáltatást
3. Kattintson a jobb gombbal a szolgáltatásra, és válassza az „Indítás” lehetőséget

4. Ellenőrzés

A szolgáltatás újraindítása után a REST végpontok már elérhetőknek kell lenniük HTTPS-en keresztül:

1. Nyisson meg egy webböngészőt
2. Lépjen a Swagger UI oldalára:

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

3. Ellenőrizze, hogy a címsorban megjelenik-e a lakat ikon, amely a biztonságos HTTPS-kapcsolatot jelzi

Összefoglalás

A REST-felület most már HTTPS használatára van beállítva. Minden api-kérés automatikusan átirányításra kerül HTTP-ről HTTPS-re, ami javítja a kommunikáció biztonságát és biztosítja az adatok integritását.

Ezt a cikket automatikusan lefordították.