HTTPS aktivieren für sichere API-Kommunikation

Übersicht

Diese Anleitung beschreibt die notwendigen Schritte, um die REST-Schnittstelle (Swagger) der Middleware über HTTPS zu konfigurieren.

Voraussetzungen

• Zugriff auf den Windows-Host
• Texteditor (z. B. Notepad++ oder Visual Studio Code)

Schritt-für-Schritt-Anleitung

1. Windows-Dienst beenden

1. Öffnen Sie die Windows-Dienstverwaltung:
   • Drücken Sie Win + R, geben Sie services.msc ein und drücken Sie Enter
   • Alternativ: Über die Systemsteuerung → Verwaltung → Dienste
2. Suchen Sie in der Liste nach dem RetailForce-Dienst
3. Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie "Beenden"

2. Konfigurationsdatei bearbeiten

1. Navigieren Sie zum Installationsverzeichnis:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Öffnen Sie die Datei appsettings.json mit einen Texteditor
3. Stellen Sie sicher, dass folgende Parameter korrekt konfiguriert sind:

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

4. Speichern Sie die Datei und schließen Sie den Editor

3. Windows-Dienst starten

1. Kehren Sie zur Windows-Dienstverwaltung zurück
2. Suchen Sie den RetailForce-Dienst
3. Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie "Starten"

4. Überprüfung

Nach dem Neustart des Dienstes sollten die REST-Endpunkte nun über HTTPS verfügbar sein:

1. Öffnen Sie einen Webbrowser
2. Navigieren Sie zur Swagger-UI unter:

   https://localhost:7677/swagger/index.html

3. Vergewissern Sie sich, dass in der Adressleiste ein Schlosssymbol angezeigt wird, was eine sichere HTTPS-Verbindung anzeigt

Zusammenfassung

Die REST-Schnittstelle ist nun über HTTPS konfiguriert. Alle API-Anfragen werden automatisch von HTTP auf HTTPS umgeleitet, was die Sicherheit der Kommunikation verbessert und die Datenintegrität gewährleistet.