Activarea HTTPS pentru o comunicare api mai sigură

Prezentare generală

Acest ghid descrie pașii necesari pentru configurarea interfeței REST (swagger) a RetailForce Middleware pentru utilizarea protocolului HTTPS.

Cerințe preliminare

• Acces la gazda Windows
• Editor de text (de exemplu, Notepad++ sau Visual Studio Code)

Ghid pas cu pas

1. Opriți serviciul Windows

1. Deschideți Managerul de servicii Windows:
   • Apăsați Win + R, tastați services.msc și apăsați Enter
   • Alternativ: prin Panoul de control → Instrumente administrative → Servicii
2. Găsiți serviciul RetailForce în listă
3. Faceți clic dreapta pe serviciu și selectați „Oprire”

2. Editați fișierul de configurare

1. Accesați directorul de instalare:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Deschideți fișierul appsettings.json cu un editor de text
3. Asigurați-vă că următorii parametri din secțiunea „AppSettings” sunt configurați corect:

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

   Important :

   • Asigurați-vă că ambele UseHttps și UseHttpsRedirection sunt setate la true
   • Specificația căii pentru HttpsCertificateFilename este relativă la directorul de instalare
   • Pentru mediile de producție, utilizați un certificat valid și de încredere în locul fișierului „development.pfx”

4. Salvați fișierul și închideți editorul

3. Porniți serviciul Windows

1. Reveniți la Managerul de servicii Windows
2. Găsiți serviciul RetailForce
3. Faceți clic dreapta pe serviciu și selectați „Pornire”

4. Verificare

După repornirea serviciului, punctele finale REST ar trebui să fie acum disponibile prin HTTPS:

1. Deschideți un browser web
2. Accesați Swagger UI la adresa:

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

3. Verificați dacă în bara de adrese este afișată o pictogramă în formă de lacăt, care indică o conexiune HTTPS securizată

Rezumat

Interfața REST este acum configurată să utilizeze HTTPS. Toate solicitările api vor fi redirecționate automat de la HTTP la HTTPS, ceea ce îmbunătățește securitatea comunicațiilor și asigură integritatea datelor.

Acest articol a fost tradus automat.