Ir para o conteúdo
Localtonet Localtonet Painel

Criar um túnel TLS

Desktop v7.6+ Mobile v9.9+

Ajuda com esta página
Nesta página 10 seções
  1. TLS, HTTP ou TCP?
  2. Antes de começar
  3. Passos
  4. Abra a página TLS
  5. Escolha o tipo de URL, o dispositivo e a região
  6. Informe o endpoint
  7. Inicie o túnel
  8. O endpoint
  9. Modo SSL: quem cuida do certificado
  10. Configurações de um túnel TLS
  11. Exemplos
  12. Um servidor web com certificado próprio
  13. Um serviço que não é HTTP sobre TLS
  14. TLS na porta 443 para um serviço sem certificado
  15. No plano Grátis
  16. Solução de problemas
  17. Páginas relacionadas

Um túnel TLS encaminha o tráfego criptografado de um nome de host público, na porta 443, para um serviço TLS local. Por padrão, a conexão criptografada passa direto para o seu serviço, que apresenta o próprio certificado.

TLS, HTTP ou TCP? #

Os três podem publicar um serviço que usa criptografia. Eles diferem em quem guarda o certificado e na aparência do endereço público.

PerguntaTúnel HTTPTúnel TLSTúnel TCP
Endpoint públicoEndereço https:// sem portaNome de host na porta 443Nome de host e uma porta de servidor atribuída
Quem apresenta o certificadoLocaltonetPor padrão, o seu serviço. O Localtonet, se você escolher assim em Modo SSL.O Localtonet não adiciona certificado. O seu serviço faz o que já faz hoje.
Onde o TLS terminaNo servidor do LocaltonetNo seu serviço, no modo de passagem diretaOnde o seu protocolo o encerrar
ProtocolosHTTP e WebSocketQualquer protocolo que rode sobre TLSQualquer protocolo TCP
Opções de HTTP, como cabeçalhos, reescrita de caminho, Basic Auth, SSO, WAF e o inspetor de requisiçõesSimNãoNão
Tipos de URLSubdomínio aleatório, Subdomínio personalizado, Domínio personalizadoSubdomínio aleatório, Subdomínio personalizadoSubdomínio aleatório, Subdomínio personalizado
Limite de sessão no plano GrátisNenhum30 minutos por sessão30 minutos por sessão
  • Escolha HTTP para um site comum, uma API ou um receptor de webhook. É o que dá menos trabalho.
  • Escolha TLS quando o seu serviço precisa apresentar o próprio certificado, quando o tráfego deve permanecer criptografado até o seu dispositivo ou quando um protocolo que não é HTTP, sobre TLS, deve ficar acessível na porta 443.
  • Escolha TCP quando o protocolo não for TLS desde o primeiro byte ou quando os clientes não puderem enviar um nome de host. Um túnel TCP é endereçado pela porta; um túnel TLS, pelo nome de host.

Antes de começar #

  • Um cliente Localtonet atual, conectado com um AuthToken. A página TLS indica as versões mínimas: Desktop v7.6 e Mobile v9.9.
  • Um serviço local que fale TLS e tenha um certificado para o nome de host que os clientes vão usar. Se o seu serviço não tem certificado, veja HTTP ou troque o modo SSL, como descrito abaixo.
  • Para Subdomínio personalizado: saldo na sua conta.

Passos #

  1. Abra a página TLS #

    Abra Meus túneis › TLS e selecione Criar túnel TLS para abrir o formulário.

  2. Escolha o tipo de URL, o dispositivo e a região #

    Em Tipo de URL, selecione Subdomínio aleatório ou Subdomínio personalizado. Em Token do dispositivo, selecione o token usado pelo app Localtonet no seu dispositivo. Em Região do servidor, escolha uma região próxima ao seu dispositivo.

  3. Informe o endpoint #

    CampoO que informar
    Domíniolocalto.net ou um domínio que você adicionou em Gerenciador de DNS.
    SubdomínioSomente para Subdomínio personalizado: o nome na frente do domínio. São permitidos letras, dígitos e hifens.
    Endereço IP localEndereço do serviço no seu dispositivo. Use 127.0.0.1 para este dispositivo.
    Porta localA porta em que o seu serviço TLS escuta, por exemplo 443 ou 8443.

    Selecione Criar túnel.

  4. Inicie o túnel #

    Selecione o botão de iniciar na coluna Ações. A coluna URL mostra o nome de host, e a coluna Porta do servidor mostra 443. Os clientes se conectam a esse nome de host na porta 443.

O endpoint #

  • Todo túnel TLS é acessado na porta 443. A porta local pode ser qualquer uma.
  • O Localtonet encontra o seu túnel pelo nome de host que o cliente envia ao abrir a conexão TLS (SNI). Por isso, os clientes devem se conectar com o nome de host da coluna URL. Uma conexão ao endereço IP do servidor que não leve esse nome de host não chega ao seu túnel.
  • O nome de host continua o mesmo quando você para e inicia o túnel.

Modo SSL: quem cuida do certificado #

Abra as configurações do túnel e selecione Gerenciar ao lado de Modo SSL. A caixa de diálogo Modo SSL pergunta quem cuida do HTTPS deste túnel.

OpçãoO que aconteceUse quando
Meu serviço cuida do HTTPSPassagem direta (pass-through). O tráfego criptografado passa direto para o seu serviço, que precisa apresentar o próprio certificado para este domínio. O Localtonet não o descriptografa.Você precisa de um certificado próprio ou de criptografia de ponta a ponta. Um novo túnel TLS começa neste modo.
O Localtonet cuida do HTTPSO Localtonet fornece e renova o certificado. Nada para configurar do seu lado. O Localtonet encerra a conexão TLS e encaminha o tráfego descriptografado ao seu serviço.O seu serviço não tem certificado, mas os clientes precisam acessá-lo com TLS na porta 443.

Selecione Salvar. Se o túnel estiver em execução, ele reinicia com o novo modo, então o app Localtonet precisa estar conectado.

A configuração SSL/TLS local? pertence ao segundo modo. Ative-a quando o Localtonet cuida do HTTPS e o seu serviço local ainda espera uma conexão TLS. Deixe-a desativada no modo de passagem direta, em que a conexão TLS do visitante já chega ao seu serviço sem alterações.

Configurações de um túnel TLS #

ConfiguraçãoO que fazSaiba mais
Modo SSLEscolha o SSL gerenciado pelo Localtonet ou passe o tráfego TLS direto para o seu próprio serviço.Esta página, acima
SSL/TLS local?Ative o TLS quando o seu serviço local o usa.Esta página, acima
Conexão legada?Experimente se o túnel não conseguir se conectar pelo método normal.Referência de configurações
IP do túnelVeja os endereços IPv4 e IPv6 do servidor.Referência de configurações
Restrição de IPControle quais endereços IP de clientes podem acessar este túnel.Controle de acesso
Data de expiração, Limites de velocidade, Limite de banda, Uso de banda, Tráfego de bandaPare o túnel em uma data, limite a velocidade, limite os dados, zere o contador de dados e veja o tráfego ao longo do tempo.Limites e expiração
Log de requisições, Log de atividades, Saúde do túnelVeja as conexões feitas ao túnel, as inicializações, paradas e alterações de configuração dele, e as verificações de saúde.Logs e inspeção
ArgumentosEnvie este túnel por uma rede específica do seu dispositivo.Seleção de rede
Porta de saídaUse portas de saída fixas para a conexão do app Localtonet com o servidor, para firewalls restritivos.Portas
Nota do túnelSalve uma nota privada para ajudar a identificar este túnel.Referência de configurações
Balanceamento de cargaDistribua o tráfego entre dispositivos ou use um destino de backup.Balanceamento de carga

Um túnel TLS não tem configuração de porta do servidor nem porta reservada. A porta é sempre 443.

Exemplos #

Um servidor web com certificado próprio #

O seu servidor web escuta em 127.0.0.1:443 e tem um certificado para secure.example.com. Você adicionou example.com no Gerenciador de DNS e a sua conta tem saldo.

CampoValor
Tipo de URLSubdomínio personalizado
Subdomíniosecure
Domínioexample.com
Endereço IP local127.0.0.1
Porta local443

Inicie o túnel e abra https://secure.example.com. O navegador mostra o certificado do seu próprio servidor. Você pode verificar qual certificado é apresentado com o OpenSSL:

Terminal
openssl s_client -connect <TUNNEL_HOST>:443 -servername <TUNNEL_HOST>

Um serviço que não é HTTP sobre TLS #

Um message broker no seu dispositivo aceita conexões TLS na porta local 8883. Crie um túnel TLS com Porta local 8883. Os clientes então se conectam ao nome de host do túnel na porta 443 com o TLS ativado. O cliente precisa enviar o nome de host (SNI), o que as bibliotecas TLS fazem quando você se conecta por nome.

TLS na porta 443 para um serviço sem certificado #

Crie o túnel para a porta simples do seu serviço, abra Modo SSL e selecione O Localtonet cuida do HTTPS. Os clientes se conectam com TLS e recebem um certificado do Localtonet. O seu serviço continua recebendo tráfego sem criptografia.

No plano Grátis #

Os túneis TLS param após 30 minutos no plano Grátis. Selecione Iniciar para começar outra sessão, se ainda houver banda mensal. O nome de host não muda. Veja Planos e saldo.

Solução de problemas #

Os clientes mostram um aviso de certificado

No modo de passagem direta, os clientes veem o certificado do seu próprio serviço. Ele precisa ser válido para o nome de host do túnel e confiável para o cliente. Instale um certificado correspondente no seu serviço ou troque Modo SSL para O Localtonet cuida do HTTPS.

A conexão fecha logo depois de abrir

No modo de passagem direta, o seu serviço local precisa responder ele mesmo ao handshake TLS. Se o serviço na porta local fala HTTP simples ou TCP simples, troque Modo SSL para O Localtonet cuida do HTTPS ou use um túnel HTTP ou TCP. Verifique também se SSL/TLS local? está desativado no modo de passagem direta.

"Inicie ou atualize o app Localtonet."

Não foi possível iniciar o túnel no dispositivo. Os túneis TLS exigem o Localtonet Desktop v7.6 ou Mobile v9.9, ou posterior. Atualize o cliente na página Downloads e inicie o túnel de novo.

"Verifique a conexão do dispositivo."

Você salvou Modo SSL ou outra configuração que reinicia um túnel em execução enquanto o app Localtonet estava offline. Conecte o app e salve de novo, ou pare o túnel primeiro.

"Você precisa comprar saldo para usar este recurso."

Subdomínio personalizado exige saldo. Use Subdomínio aleatório ou adicione saldo em Saldo.

O túnel parou depois de meia hora

Esse é o limite de sessão do plano Grátis. O túnel parado mostra Sessão encerrada na lista. Inicie-o de novo ou adicione saldo para remover o limite.

Suporte