Attivazione HTTPS per una comunicazione API più sicura – RetailForce

Panoramica

La presente guida descrive i passaggi necessari per configurare l’interfaccia REST (Swagger) del RetailForce Middleware per l’utilizzo del protocollo HTTPS.

Prerequisiti

Accesso all’host Windows
Editor di testo (ad es. Notepad++ o Visual Studio Code)

Guida passo passo

1. Interrompere il servizio Windows

Aprire Gestione servizi di Windows:
- Premere Win + R, digitare services.msc e premere Invio
- In alternativa, è possibile accedere tramite Pannello di controllo → Strumenti di amministrazione → Servizi.
Individuare il servizio RetailForce nell'elenco
Fare clic con il pulsante destro del mouse sul servizio e selezionare "Interrompi".

2. Modificare il file di configurazione

Acceda alla directory di installazione:

C:\Program Files\RetailForce\Fiscal Webservice

Aprire il file appsettings.json con un editor di testo
Verificare che i seguenti parametri nella sezione "AppSettings" siano configurati correttamente:
```
...  
"AppSettings": {
    "Secret": "****",
    "Portnumber": 7678,
    "PortnumberHttps": 7677,
    "UseHttps": true,
    "UseHttpsRedirection": true,
    "HttpsCertificateFilename": "development.pfx",
    "HttpsCertificatePassword": "changeme",
    "LogName": "RetailForce Fiscalisation",
    "LogEventLog": true,
    "LogLevelFilter": "Debug"
  }
}
```
Importante :
- Verificare che entrambi UseHttps e UseHttpsRedirection siano impostati su true
- La specifica del percorso per HttpsCertificateFilename è relativo alla directory di installazione
- Per gli ambienti di produzione, utilizzare un certificato valido e attendibile anziché "development.pfx".
Salvi il file e chiuda l’editor

3. Avviare il servizio Windows

Tornare al Gestore dei servizi di Windows
Individuare il servizio RetailForce
Fare clic con il pulsante destro del mouse sul servizio e selezionare "Avvia".

4. Verifica

Dopo il riavvio del servizio, gli endpoint REST dovrebbero ora essere esposti tramite HTTPS:

Aprire un browser web

Acceda alla Swagger UI all’indirizzo:

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

Verifichi che nella barra degli indirizzi sia visualizzata l’icona di un lucchetto, a indicare una connessione HTTPS sicura

Riepilogo

L’interfaccia REST è ora configurata per utilizzare HTTPS. Tutte le richieste API verranno automaticamente reindirizzate da HTTP a HTTPS, migliorando la sicurezza delle comunicazioni e garantendo l’integrità dei dati.

Questo articolo è stato tradotto automaticamente.