HTTPS-aktivering for mere sikker api-kommunikation

Oversigt

Denne vejledning beskriver de nødvendige trin til at konfigurere REST-grænsefladen (swagger) i RetailForce Middleware til at bruge HTTPS.

Forudsætninger

• Adgang til Windows-værten
• Teksteditor (f.eks. Notepad++ eller Visual Studio Code)

Trin-for-trin-vejledning

1. Stop Windows-tjenesten

1. Åbn Windows-tjenestestyring:
   • Tryk på Win + R, skriv services.msc og tryk på Enter
   • Alternativt: Via Kontrolpanel → Administration → Tjenester
2. Find tjenesten RetailForce på listen
3. Højreklik på tjenesten, og vælg "Stop"

2. Rediger konfigurationsfilen

1. Naviger til installationsmappen:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Åbn filen appsettings.json med en teksteditor
3. Sørg for, at følgende parametre i afsnittet "AppSettings" er konfigureret korrekt:

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

   Vigtigt :

   • Sørg for, at begge UseHttps og UseHttpsRedirection er indstillet til true
   • Stispecifikationen for HttpsCertificateFilename er relativ i forhold til installationsmappen
   • I produktionsmiljøer skal du bruge et gyldigt, betroet certifikat i stedet for "development.pfx"

4. Gem filen, og luk editoren

3. Start Windows-tjenesten

1. Gå tilbage til Windows-tjenesteadministratoren
2. Find tjenesten RetailForce
3. Højreklik på tjenesten, og vælg "Start"

4. Verifikation

Efter genstart af tjenesten bør REST-endpunkterne nu være tilgængelige via HTTPS:

1. Åbn en webbrowser
2. Gå til Swagger UI på:

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

3. Kontroller, at der vises et låsikon i adresselinjen, hvilket angiver en sikker HTTPS-forbindelse

Resumé

REST-grænsefladen er nu konfigureret til at bruge HTTPS. Alle api-anmodninger omdirigeres automatisk fra HTTP til HTTPS, hvilket forbedrer kommunikationssikkerheden og sikrer dataintegriteten.

Denne artikel er oversat automatisk.