Активиране на HTTPS за по-сигурна комуникация чрез api – RetailForce

Общ преглед

Настоящото ръководство описва необходимите стъпки за конфигуриране на REST интерфейса (swagger) на RetailForce Middleware за използване на HTTPS.

Предварителни условия

Достъп до Windows хоста
Текстов редактор (например Notepad++ или Visual Studio Code)

Ръководство стъпка по стъпка

1. Спрете Windows услугата

Отворете мениджъра на услугите на Windows:
- Натиснете Win + R, въведете services.msc и натиснете Enter
- Алтернативно: Чрез „Контролен панел“ → „Административни инструменти“ → „Услуги“
Намерете услугата RetailForce в списъка
Кликнете с десния бутон върху услугата и изберете „Спиране“

2. Редактиране на конфигурационния файл

Отидете в инсталационната директория:
- ```
C:\Program Files\RetailForce\Fiscal Webservice
```
Отворете файла appsettings.json с текстов редактор
Уверете се, че следните параметри в секцията „AppSettings“ са конфигурирани правилно:
```
...  
"AppSettings": {
    "Secret": "****",
    "Portnumber": 7678,
    "PortnumberHttps": 7677,
    "UseHttps": true,
    "UseHttpsRedirection": true,
    "HttpsCertificateFilename": "development.pfx",
    "HttpsCertificatePassword": "changeme",
    "LogName": "RetailForce Fiscalisation",
    "LogEventLog": true,
    "LogLevelFilter": "Debug"
  }
}
```
Важно :
- Уверете се, че и двете UseHttps и UseHttpsRedirection са зададени на true
- Пътят за HttpsCertificateFilename е относителен спрямо инсталационната директория
- За производствени среди използвайте валиден, доверен сертификат вместо „development.pfx“
Запазете файла и затворете редактора

3. Стартирайте услугата на Windows

Върнете се към Управление на услугите на Windows
Намерете услугата RetailForce
Кликнете с десния бутон върху услугата и изберете „Стартирай“

4. Проверка

След рестартиране на услугата REST крайните точки вече трябва да са достъпни чрез HTTPS:

Отворете уеб браузър

Отидете в Swagger UI на адрес:

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

Уверете се, че в адресната лента се показва икона на катинар, което показва, че връзката е защитена чрез HTTPS

Обобщение

REST интерфейсът вече е конфигуриран да използва HTTPS. Всички api заявки автоматично ще бъдат пренасочвани от HTTP към HTTPS, което подобрява сигурността на комуникацията и гарантира целостта на данните.

Тази статия е преведена автоматично.