Trabalhando com SSL

Trabalhar com SSL durante o desenvolvimento pode ser necessário ao atuar em contextos que exigem segurança, como a maioria dos cenários de desenvolvimento web. O Sisk opera sobre o HttpListener, que não oferece suporte nativo a HTTPS, apenas HTTP. No entanto, existem soluções alternativas que permitem usar SSL no Sisk. Veja-as abaixo:

Através do Sisk.Cadente.CoreEngine #

• Disponível em: Linux, macOS, Windows
• Esforço: fácil

É possível usar o motor experimental Cadente em projetos Sisk, sem exigir configuração adicional no computador ou no projeto. Você precisará instalar o pacote Sisk.Cadente.CoreEngine em seu projeto para poder usar o servidor Cadente no servidor Sisk.

Para configurar SSL, você pode usar os métodos UseSsl e UseEngine do builder:

using var http = HttpServer.CreateBuilder()
    .UseEngine<CadenteHttpServerEngine>()
    .UseSsl(CertificateHelper.CreateTrustedDevelopmentCertificate("localhost"))

Nota: este pacote ainda está na fase experimental.

Através do IIS no Windows #

• Disponível em: Windows
• Esforço: médio

Se você está no Windows, pode usar o IIS para habilitar SSL no seu servidor HTTP. Para que isso funcione, é recomendável que você siga este tutorial antes, caso queira que sua aplicação escute em um host diferente de “localhost.”

Para que isso funcione, você deve instalar o IIS através dos recursos do Windows. O IIS está disponível gratuitamente para usuários do Windows e Windows Server. Para configurar SSL na sua aplicação, tenha o certificado SSL pronto, mesmo que seja autoassinado. Em seguida, você pode ver como configurar SSL no IIS 7 ou superior.

Através do mitmproxy #

• Disponível em: Linux, macOS, Windows
• Esforço: fácil

mitmproxy é uma ferramenta de proxy de interceptação que permite a desenvolvedores e testadores de segurança inspecionar, modificar e registrar o tráfego HTTP e HTTPS entre um cliente (como um navegador web) e um servidor. Você pode usar o utilitário mitmdump para iniciar um proxy SSL reverso entre seu cliente e sua aplicação Sisk.

1. Primeiro, instale o mitmproxy na sua máquina.
2. Inicie sua aplicação Sisk. Para este exemplo, usaremos a porta 8000 como a porta HTTP insegura.
3. Inicie o servidor mitmproxy para escutar na porta segura 8001:

mitmdump --mode reverse:http://localhost:8000/ -p 8001

E pronto! Você já pode acessar sua aplicação através de https://localhost:8001/. Sua aplicação não precisa estar em execução para você iniciar o mitmdump.

Alternativamente, você pode adicionar uma referência ao mitmproxy helper em seu projeto. Isso ainda requer que o mitmproxy esteja instalado em seu computador.

Pacote Sisk.SslProxy (descontinuado) #