Ativação de HTTPS para uma comunicação api mais segura

Visão geral

Este guia descreve os passos necessários para configurar a interface REST (swagger) do RetailForce Middleware para utilizar HTTPS.

Pré-requisitos

• Acesso ao anfitrião Windows
• Editor de texto (por exemplo, Notepad++ ou Visual Studio Code)

Guia passo a passo

1. Parar o serviço do Windows

1. Abra o Gestor de Serviços do Windows:
   • Prima Win + R, digite services.msc e prima Enter
   • Em alternativa: através do Painel de Controlo → Ferramentas Administrativas → Serviços
2. Encontre o serviço RetailForce na lista
3. Clique com o botão direito do rato no serviço e selecione «Parar»

2. Editar o ficheiro de configuração

1. Navegue até ao diretório de instalação:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Abra o ficheiro appsettings.json com um editor de texto
3. Certifique-se de que os seguintes parâmetros na secção «AppSettings» estão configurados corretamente:

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

   Importante :

   • Certifique-se de que ambos UseHttps e UseHttpsRedirection estejam definidos como true
   • A especificação do caminho para HttpsCertificateFilename é relativa ao diretório de instalação
   • Em ambientes de produção, utilize um certificado válido e fiável em vez de «development.pfx»

4. Guarde o ficheiro e feche o editor

3. Inicie o serviço do Windows

1. Volte ao Gestor de Serviços do Windows
2. Localize o serviço RetailForce
3. Clique com o botão direito do rato no serviço e selecione «Iniciar»

4. Verificação

Após reiniciar o serviço, os pontos finais REST deverão agora estar disponíveis através de HTTPS:

1. Abra um navegador da Web
2. Aceda à Swagger UI em:

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

3. Verifique se é apresentado um ícone de cadeado na barra de endereços, indicando uma ligação HTTPS segura

Resumo

A interface REST está agora configurada para utilizar HTTPS. Todos os pedidos à api serão automaticamente redirecionados de HTTP para HTTPS, o que melhora a segurança da comunicação e garante a integridade dos dados.

Este artigo foi traduzido automaticamente.