Activation du protocole HTTPS pour une communication API plus sécurisée

Présentation

Ce guide décrit les étapes nécessaires à la configuration de l’interface REST (Swagger) du RetailForce Middleware pour l’utilisation du protocole HTTPS.

Prérequis

• Accès à l’hôte Windows
• Éditeur de texte (par exemple, Notepad++ ou Visual Studio Code)

Guide étape par étape

1. Arrêtez le service Windows

1. Ouvrez le Gestionnaire de services Windows :
   • Appuyez sur Win + R, tapez services.msc puis appuyez sur Entrée
   • Autre possibilité : via le Panneau de configuration → Outils d'administration → Services
2. Recherchez le service RetailForce dans la liste
3. Cliquez avec le bouton droit de la souris sur le service et sélectionnez « Arrêter »

2. Modifier le fichier de configuration

1. Accédez au répertoire d'installation :

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Ouvrez le fichier appsettings.json à l’aide d’un éditeur de texte
3. Vérifiez que les paramètres suivants, dans la section « AppSettings », sont correctement configurés :

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

   Important :

   • Vérifiez que les deux UseHttps et UseHttpsRedirection soient correctement définis sur true
   • La spécification du chemin d’accès pour HttpsCertificateFilename est relative au répertoire d'installation
   • Dans les environnements de production, utilisez un certificat valide et de confiance à la place de « development.pfx »

4. Enregistrez le fichier et fermez l’éditeur.

3. Démarrez le service Windows

1. Revenez au Gestionnaire des services Windows
2. Recherchez le service RetailForce
3. Cliquez avec le bouton droit sur le service et sélectionnez « Démarrer »

4. Vérification

Une fois le service redémarré, les points de terminaison REST doivent désormais être accessibles via HTTPS :

1. Ouvrez un navigateur Web
2. Accédez à l’interface Swagger UI à l’adresse suivante :

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

3. Vérifiez qu’une icône en forme de cadenas s’affiche dans la barre d’adresse, indiquant une connexion HTTPS sécurisée

Résumé

L'interface REST est désormais configurée pour utiliser le protocole HTTPS. Toutes les requêtes API seront automatiquement redirigées de HTTP vers HTTPS, ce qui renforce la sécurité des communications et garantit l'intégrité des données.

Cet article a été traduit automatiquement.