Activación de HTTPS para una comunicación API más segura

Resumen

Esta guía describe los pasos necesarios para configurar la interfaz REST (Swagger) del RetailForce Middleware para utilizar HTTPS.

Requisitos previos

• Acceso al host de Windows
• Editor de texto (por ejemplo, Notepad++ o Visual Studio Code)

Guía paso a paso

1. Detenga el servicio de Windows

1. Abra el Administrador de servicios de Windows:
   • Pulse Win + R, escriba services.msc y presione Intro
   • Alternativamente, acceda mediante el Panel de control → Herramientas administrativas → Servicios.
2. Localice el servicio RetailForce en el listado
3. Haga clic con el botón secundario del ratón en el servicio y seleccione «Detener».

2. Editar el archivo de configuración

1. Acceda al directorio de instalación:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Abra el archivo appsettings.json con un editor de texto
3. Asegúrese de que los siguientes parámetros de la sección «AppSettings» estén configurados correctamente:

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

   Importante :

   • Asegúrese de que tanto UseHttps y UseHttpsRedirection se encuentran establecidos en true
   • La especificación de la ruta de HttpsCertificateFilename es relativa al directorio de instalación
   • En entornos de producción, utilice un certificado válido y de confianza en lugar de «development.pfx».

4. Guarde el archivo y cierre el editor.

3. Inicie el servicio de Windows

1. Vuelva al Administrador de servicios de Windows
2. Busque el servicio RetailForce
3. Haga clic con el botón secundario del ratón en el servicio y seleccione «Iniciar».

4. Verificación

Tras reiniciar el servicio, los puntos finales REST deberían estar ya disponibles a través de HTTPS:

1. Abra un navegador web
2. Acceda a la Swagger UI en:

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

3. Compruebe que aparece un icono de candado en la barra de direcciones, lo que indica una conexión HTTPS segura

Resumen

La interfaz REST ya está configurada para utilizar HTTPS. Todas las solicitudes a la API se redirigirán automáticamente de HTTP a HTTPS, lo que mejora la seguridad de las comunicaciones y garantiza la integridad de los datos.

Este artículo ha sido traducido automáticamente.