Saltar para o conteúdo
VpnHood!

VpnHood! SERVER

Use um nome de domínio e um certificado fidedigno

De origem, o servidor apresenta um certificado autoassinado com um nome fictício. Dê-lhe um nome de domínio seu, com um certificado de uma autoridade certificadora, e uma ligação a ele parece uma visita a um site comum.

O que isso muda

As apps verificam o certificado como um browser faz, pela autoridade que o assinou e pelo nome que contém, por isso as chaves criadas depois da alteração continuam a funcionar quando o certificado é renovado.

No entanto, um domínio não esconde o servidor: aponta para o endereço IP do servidor, e as chaves continuam a conter esse endereço. Para manter os seus utilizadores ligados quando o endereço for bloqueado, coloque o servidor atrás de um proxy reverso, o que exige primeiro este certificado.

Antes de começar

  • Um domínio ou subdomínio que controle, como server1.example.com. Use um único nome, não um wildcard, e um que não diga VPN: as apps enviam-no em claro no início de cada ligação, onde a rede o pode ler.
  • Um registo DNS que o aponte diretamente para o IP de ligação do servidor: um registo A, e um registo AAAA se o servidor tiver um endereço IPv6. Para colocar a Cloudflare à frente do servidor, termine primeiro esta página e só depois ative o proxy da Cloudflare.

Num servidor independente

Um servidor independente não consegue obter um certificado sozinho. Obtenha um para o domínio junto de uma autoridade certificadora, como ficheiro PFX com a chave privada, e coloque-o no lugar de /opt/VpnHoodServer/storage/access/certificates/default.pfx, com o mesmo nome.

Depois, coloque a palavra-passe do ficheiro em SslCertificatesPassword e defina IsValidHostName como true, ambos em FileAccessManager no /opt/VpnHoodServer/storage/appsettings.json. Uma instalação nova não tem este ficheiro: crie-o, e a partir daí o servidor usa-o em vez das definições com que foi instalado.

O ficheiro completo, com a palavra-passe do seu certificado no lugar da do exemplo

{
  "FileAccessManager": {
    "SslCertificatesPassword": "your-pfx-password",
    "IsValidHostName": true
  },
  "ServerConfig": {
    "LogAnonymizer": true,
    "AddListenerIpsToNetwork": "*"
  },
  "LogLevel": "Information"
}

O servidor obtém o domínio do próprio certificado, por isso não há nenhuma definição para ele.

Reinicie o servidor com sudo systemctl restart VpnHoodServer, ou com sudo docker restart VpnHoodServer no Docker. Com uma palavra-passe errada, não inicia, e o log indica The server could not start.

As chaves criadas antes da alteração deixam de funcionar, pois esperam o certificado antigo. Volte a mostrar cada uma delas e dê a nova chave aos seus utilizadores: as opções e a utilização da chave mantêm-se. O ID de uma chave é o nome do respetivo ficheiro em /opt/VpnHoodServer/storage/access, sem .token2.

Liste as chaves e depois mostre uma de novo pelo seu ID

sudo ls /opt/VpnHoodServer/storage/access | sed -n "s/\.token2$//p"
sudo /opt/VpnHoodServer/vhserver print 2b9d4a6e-1c3f-4e8a-9b7d-5f0e8c2a1d34

No Docker, execute o mesmo através de sudo docker exec VpnHoodServer /app/vhsupervisor, tal como para vhserver gen.

As novas chaves contêm o domínio e já não dependem do próprio certificado, por isso continuam a funcionar quando o renovar: coloque o novo ficheiro no lugar e reinicie o servidor.

Use um nome à sua escolha, sem domínio

Sem domínio, um servidor independente pode ainda assim substituir o seu nome fictício. Um certificado autoassinado pode ter qualquer nome, mesmo um que não lhe pertença, pois as apps aceitam-no pela impressão digital que está na chave e nunca procuram o nome. No entanto, esconde menos do que um certificado fidedigno, e o nome de um site real pode fazer mais mal do que bem: a página Que certificado deve o seu servidor usar? explica porquê.

No servidor, crie um certificado, com o nome escolhido em vez de api.example.com nos dois sítios, e coloque-o no lugar de /opt/VpnHoodServer/storage/access/certificates/default.pfx. Não tem palavra-passe, por isso deixe SslCertificatesPassword fora das suas definições e mantenha IsValidHostName em false, o valor predefinido.

Válido por dez anos: um novo certificado tem uma nova impressão digital e, por isso, exige novas chaves

openssl req -x509 -newkey rsa:2048 -nodes -days 3650 -subj "/CN=api.example.com" -addext "subjectAltName=DNS:api.example.com" -keyout server.key -out server.crt
openssl pkcs12 -export -inkey server.key -in server.crt -out default.pfx -passout pass:
sudo cp default.pfx /opt/VpnHoodServer/storage/access/certificates/default.pfx
rm server.key server.crt default.pfx

Reinicie o servidor com sudo systemctl restart VpnHoodServer, ou com sudo docker restart VpnHoodServer no Docker. As chaves criadas antes da alteração deixam de funcionar, pois contêm a impressão digital do certificado antigo: volte a mostrar cada uma delas e dê a nova chave aos seus utilizadores.

Liste as chaves e depois mostre uma de novo pelo seu ID

sudo ls /opt/VpnHoodServer/storage/access | sed -n "s/\.token2$//p"
sudo /opt/VpnHoodServer/vhserver print 2b9d4a6e-1c3f-4e8a-9b7d-5f0e8c2a1d34

No Docker, execute o mesmo através de sudo docker exec VpnHoodServer /app/vhsupervisor, tal como para vhserver gen.

Próximos passos