Criar um túnel TLS
Desktop v7.6+ Mobile v9.9+
Nesta página 10 seções
- TLS, HTTP ou TCP?
- Antes de começar
- Passos
- Abra a página TLS
- Escolha o tipo de URL, o dispositivo e a região
- Informe o endpoint
- Inicie o túnel
- O endpoint
- Modo SSL: quem cuida do certificado
- Configurações de um túnel TLS
- Exemplos
- Um servidor web com certificado próprio
- Um serviço que não é HTTP sobre TLS
- TLS na porta 443 para um serviço sem certificado
- No plano Grátis
- Solução de problemas
- 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.
| Pergunta | Túnel HTTP | Túnel TLS | Túnel TCP |
|---|---|---|---|
| Endpoint público | Endereço https:// sem porta | Nome de host na porta 443 | Nome de host e uma porta de servidor atribuída |
| Quem apresenta o certificado | Localtonet | Por 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 termina | No servidor do Localtonet | No seu serviço, no modo de passagem direta | Onde o seu protocolo o encerrar |
| Protocolos | HTTP e WebSocket | Qualquer protocolo que rode sobre TLS | Qualquer protocolo TCP |
| Opções de HTTP, como cabeçalhos, reescrita de caminho, Basic Auth, SSO, WAF e o inspetor de requisições | Sim | Não | Não |
| Tipos de URL | Subdomínio aleatório, Subdomínio personalizado, Domínio personalizado | Subdomínio aleatório, Subdomínio personalizado | Subdomínio aleatório, Subdomínio personalizado |
| Limite de sessão no plano Grátis | Nenhum | 30 minutos por sessão | 30 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 #
-
Abra a página TLS #
Abra Meus túneis › TLS e selecione Criar túnel TLS para abrir o formulário.
-
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.
-
Informe o endpoint #
Campo O que informar Domínio localto.netou um domínio que você adicionou em Gerenciador de DNS.Subdomínio Somente para Subdomínio personalizado: o nome na frente do domínio. São permitidos letras, dígitos e hifens. Endereço IP local Endereço do serviço no seu dispositivo. Use 127.0.0.1para este dispositivo.Porta local A porta em que o seu serviço TLS escuta, por exemplo 443ou8443.Selecione Criar túnel.
-
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ção | O que acontece | Use quando |
|---|---|---|
| Meu serviço cuida do HTTPS | Passagem 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 HTTPS | O 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ção | O que faz | Saiba mais |
|---|---|---|
| Modo SSL | Escolha 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únel | Veja os endereços IPv4 e IPv6 do servidor. | Referência de configurações |
| Restrição de IP | Controle 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 banda | Pare 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únel | Veja 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 |
| Argumentos | Envie este túnel por uma rede específica do seu dispositivo. | Seleção de rede |
| Porta de saída | Use portas de saída fixas para a conexão do app Localtonet com o servidor, para firewalls restritivos. | Portas |
| Nota do túnel | Salve uma nota privada para ajudar a identificar este túnel. | Referência de configurações |
| Balanceamento de carga | Distribua 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.
| Campo | Valor |
|---|---|
| Tipo de URL | Subdomínio personalizado |
| Subdomínio | secure |
| Domínio | example.com |
| Endereço IP local | 127.0.0.1 |
| Porta local | 443 |
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:
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.