SSL no Studio

Este texto foi traduzido usando IA. Se você quiser ver o texto original em inglês, clique aqui.

O WordPress Studio inclui suporte para HTTPS, permitindo que você crie sites com conexões seguras que se assemelham mais aos ambientes de produção. Esse recurso torna sua experiência de desenvolvimento local mais realista e ajuda a identificar possíveis problemas que podem ocorrer apenas com HTTPS.

Visão geral

O recurso de suporte a SSL no WordPress Studio permite:

• Criar sites com HTTPS habilitado
• Usar domínios personalizados com certificados SSL adequados
• Gerenciamento automático de certificados
• Compatibilidade com navegadores sem avisos de segurança (quando confiável)

Como funciona

O WordPress Studio implementa o suporte a SSL por meio dos seguintes componentes:

• Autoridade Certificadora (CA): O Studio cria sua própria Autoridade Certificadora que assina certificados para seus sites locais.
• Certificados de domínio: Cada site com HTTPS habilitado recebe seu próprio certificado assinado pela CA.
• Confiança do certificado: O sistema ajuda você a confiar no certificado em seu sistema operacional.
• Redirecionamento HTTPS: O tráfego é automaticamente redirecionado de HTTP para HTTPS em sites com SSL habilitado.

Habilitando HTTPS para um site

Observe que o HTTPS requer um domínio personalizado, pois não pode ser usado com o endereço localhost padrão.

Para habilitar HTTPS em um site novo ou existente:

1. Comece criando um novo site ou editando um site existente usando o botão “Editar site” na aba Configurações.
2. Se estiver criando um novo site, ative “Configuração avançada” no modal que aparece.
3. Marque a opção “Usar domínio personalizado“.
4. Se você ainda não tiver fornecido um, insira um domínio (deve terminar com .local) ou use o gerado automaticamente.
5. Marque a opção “Habilitar HTTPS“.

6. Clique no botão “Adicionar site” ou Salvar, dependendo se você está criando um novo site ou editando um existente. 
7. Quando solicitado, dê sua permissão para que o WordPress Studio modifique o arquivo hosts do sistema. O Studio configurará todo o restante automaticamente. 
8. Para conexões HTTPS, uma autoridade certificadora raiz será gerada e instalada. No MacOS, você precisará instalar o certificado manualmente para evitar avisos do navegador. Consulte o guia abaixo para mais detalhes.
9. Acesse seu site usando o domínio personalizado.

Confiança de certificado por plataforma

Windows

No Windows, o WordPress Studio adiciona automaticamente a CA ao armazenamento de confiança do sistema. Esse processo requer privilégios de administrador, então você poderá ver um prompt de Controle de Conta de Usuário (UAC) ao habilitar HTTPS.

MacOS

No macOS, você precisa confiar manualmente na CA. Para isso, encontre o arquivo de certificado que o Studio instala automaticamente no seu sistema:

1. Acesse a aba Configurações do site com SSL habilitado.
2. Clique no link “Confiar no Certificado” em Detalhes do Site.

3. Isso abrirá a pasta contendo o arquivo de certificado (studio-ca.crt). Clique duas vezes no arquivo para instalar o certificado e abrir automaticamente a ferramenta Acesso às Chaves no seu computador.
4. Localize o certificado WordPress Studio CA. Você pode filtrar os itens pela palavra studio.

5. Clique duas vezes no certificado e expanda a seção Confiança.
6. Defina “Secure Sockets Layer(SSL)” como “Confiar Sempre.” Você pode deixar todas as outras configurações como estão.

7. Feche a caixa de diálogo e digite sua senha para confirmar.

Depois que o certificado for confiável, seu navegador o reconhecerá e indicará que seus sites HTTPS são seguros.

Linux

No Linux, o Studio importa automaticamente a autoridade certificadora (CA) raiz para o pacote do sistema, bancos de dados NSS de usuário da família Chromium e bancos de dados NSS de perfis existentes do Firefox (instalações via apt, Snap e Flatpak) quando você clica em Confiar no Certificado. A maioria dos usuários não precisará dos passos abaixo.

Use este procedimento alternativo apenas se a confiança automática não tiver funcionado.

Firefox (GUI)

1. Abra about:preferences#privacy.
2. Role até Certificados e clique em Ver Certificados….

3. Mude para a aba Autoridades e clique em Importar….

4. Selecione ~/.studio/certificates/studio-ca.crt.

5. Marque Trust this CA to identify websites (Confiar nesta CA para identificar sites) e clique em OK.

6. Feche completamente e reabra o Firefox.

Chromium / Chrome / Brave / Edge (CLI)

Instale o certutil caso ele ainda não esteja disponível:

sudo apt install libnss3-tools

Importe a CA no banco de dados NSS do usuário:

certutil -d sql:$HOME/.pki/nssdb -A -t 'C,,' -n 'WordPress Studio CA' -i ~/.studio/certificates/studio-ca.crt

Para o Snap-Chromium, use o caminho do banco de dados NSS específico do Snap:

certutil -d sql:$HOME/snap/chromium/current/.pki/nssdb -A -t 'C,,' -n 'WordPress Studio CA' -i ~/.studio/certificates/studio-ca.crt

Feche completamente o navegador e reabra-o após a importação.

Solução de problemas

Avisos de segurança do navegador

Se você vir avisos de segurança do navegador ao visitar seu site com HTTPS habilitado:

• Certifique-se de que você confiou no certificado WordPress Studio CA no seu sistema.
• Reinicie o navegador após confiar no certificado.
• Limpe o cache do navegador se os avisos persistirem.