HTTPS-aktivering för säkrare api-kommunikation

Översikt

Denna guide beskriver de steg som krävs för att konfigurera REST-gränssnittet (swagger) i RetailForce Middleware för användning av HTTPS.

Förutsättningar

• Åtkomst till Windows-värden
• Textredigerare (t.ex. Notepad++ eller Visual Studio Code)

Steg-för-steg-guide

1. Stäng av Windows-tjänsten

1. Öppna Windows-tjänsthanteraren:
   • Tryck på Win + R, skriv services.msc och tryck på Enter
   • Alternativt: Via Kontrollpanelen → Administrationsverktyg → Tjänster
2. Leta reda på tjänsten RetailForce i listan
3. Högerklicka på tjänsten och välj "Stoppa"

2. Redigera konfigurationsfilen

1. Gå till installationskatalogen:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Öppna filen appsettings.json med en textredigerare
3. Se till att följande parametrar i avsnittet "AppSettings" är korrekt konfigurerade:

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

   Viktigt :

   • Se till att båda UseHttps och UseHttpsRedirection är inställda på true
   • Sökvägsangivelsen för HttpsCertificateFilename är relativ till installationskatalogen
   • I produktionsmiljöer ska du använda ett giltigt, betrott certifikat istället för "development.pfx"

4. Spara filen och stäng redigeraren

3. Starta Windows-tjänsten

1. Gå tillbaka till Windows-tjänstehanteraren
2. Leta reda på tjänsten RetailForce
3. Högerklicka på tjänsten och välj "Start"

4. Verifiering

Efter att tjänsten har startats om bör REST-ändpunkterna nu vara tillgängliga via HTTPS:

1. Öppna en webbläsare
2. Gå till Swagger UI på:

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

3. Kontrollera att en låsikon visas i adressfältet, vilket indikerar en säker HTTPS-anslutning

Sammanfattning

REST-gränssnittet är nu konfigurerat för att använda HTTPS. Alla api-förfrågningar omdirigeras automatiskt från HTTP till HTTPS, vilket förbättrar kommunikationssäkerheten och säkerställer dataintegriteten.

Den här artikeln har översatts automatiskt.