Cabeçalhos, reescrita de caminho e opções de HTTP
Nesta página 11 seções
- Antes de começar
- Cabeçalhos HTTP
- Adicionar um cabeçalho
- Escolha o tipo de cabeçalho
- Adicione o cabeçalho
- Salve
- Conjuntos prontos
- Cabeçalhos sugeridos
- Regras
- Cabeçalho Host
- Reescrever caminho
- Mude Reescrever caminho? para Sim
- Digite o caminho a adicionar
- Salve
- Tempo limite HTTP
- Somente HTTPS?
- HTTP/3 ativo?
- Exemplos
- Deixe um aplicativo web de outro site chamar a sua API
- Publique um aplicativo que fica em um subcaminho
- As mesmas configurações pela API
- Solução de problemas
- Páginas relacionadas
Altere como as requisições e respostas HTTP passam por um túnel: adicione cabeçalhos fixos, defina o cabeçalho Host que o seu serviço recebe, coloque um caminho na frente de toda requisição, defina o tempo limite da requisição e escolha somente HTTPS ou HTTP/3 para o endereço público.
Antes de começar #
- Um túnel HTTP. Veja HTTP / HTTPS.
- As configurações ficam no painel de configurações do túnel: abra Meus túneis › HTTP e selecione Configurações na linha do túnel.
| Configuração | HTTP | Gateway MCP |
|---|---|---|
| Cabeçalhos | Sim | – |
| Reescrever caminho? | Sim | – |
| Tempo limite HTTP | Sim | Sim |
| Somente HTTPS? | Sim | Sim |
| HTTP/3 ativo? | Sim | Sim |
Nenhuma dessas configurações reinicia o túnel. Uma alteração é aplicada ao túnel em execução assim que você a salva.
Cabeçalhos HTTP #
Cabeçalhos › Gerenciar abre a caixa de diálogo Cabeçalhos HTTP. Ela adiciona cabeçalhos fixos ao tráfego que passa pelo túnel:
- Os Cabeçalhos de requisição chegam ao seu serviço local em toda requisição.
- Os Cabeçalhos de resposta chegam ao visitante em toda resposta.
Os valores são enviados exatamente como você os digita.
Adicionar um cabeçalho #
-
Escolha o tipo de cabeçalho #
Selecione Cabeçalhos de requisição ou Cabeçalhos de resposta no alto da caixa de diálogo. Cada aba mostra quantos cabeçalhos ela contém.
-
Adicione o cabeçalho #
Selecione Adicionar cabeçalho e preencha Nome e Valor, ou selecione um nome em Sugestões para obter uma linha com um valor inicial adequado. Para um cabeçalho que a caixa de diálogo conhece, o ícone de informação na linha explica o que ele faz.
-
Salve #
Selecione Salvar. Para remover um cabeçalho, selecione o botão de remover da linha dele e depois Salvar.
Conjuntos prontos #
Na aba Cabeçalhos de resposta, os Conjuntos prontos adicionam um grupo de cabeçalhos de uma só vez. A caixa de diálogo então diz "NAME adicionado. Confira os valores e salve." Um conjunto só preenche um cabeçalho que já está na lista se o valor dele estiver vazio.
| Conjunto | Cabeçalhos que adiciona | Use para |
|---|---|---|
| Permitir CORS |
| Permite que aplicativos web de outros sites chamem este túnel. |
| Cabeçalhos de segurança |
| HSTS, nosniff, proteção contra frames e política de referrer. |
| Desativar cache | Cache-Control: no-store | Impede que navegadores e proxies façam cache das respostas. |
| Ocultar dos buscadores | X-Robots-Tag: noindex, nofollow | Pede aos mecanismos de busca que não listem este endereço. |
Cabeçalhos sugeridos #
| Cabeçalho | Tipo | O que a caixa de diálogo diz sobre ele |
|---|---|---|
Host | Requisição | Seu serviço recebe este nome de host no lugar do endereço do túnel. Útil quando um servidor web local escolhe o site pelo nome do host. |
Authorization | Requisição | Envia as mesmas credenciais ao seu serviço em toda requisição. |
X-API-Key | Requisição | Uma chave fixa para serviços que esperam uma em um cabeçalho. |
X-Forwarded-Proto | Requisição | Informa ao seu aplicativo que os visitantes usam HTTPS, para que ele monte links e redirecionamentos https://. |
Origin | Requisição | Alguns serviços só aceitam requisições de uma origem conhecida. |
Access-Control-Allow-Origin | Resposta | Quais sites podem chamar este túnel a partir de um navegador. * permite qualquer site. |
Access-Control-Allow-Credentials | Resposta | Permite que os navegadores enviem cookies. Não funciona junto com Access-Control-Allow-Origin: *. |
Strict-Transport-Security | Resposta | Diz aos navegadores para sempre usar HTTPS neste endereço. |
X-Frame-Options | Resposta | Impede que outros sites exibam suas páginas em um frame. |
Content-Security-Policy | Resposta | Controla de onde as páginas podem carregar scripts, estilos e imagens. Uma política rígida pode quebrar páginas, então teste-a. |
Cache-Control | Resposta | no-store impede que navegadores e proxies façam cache das respostas. |
X-Robots-Tag | Resposta | Pede aos mecanismos de busca que não listem este endereço. |
As sugestões também incluem User-Agent, Accept-Language e Cache-Control para requisições, e Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy e Permissions-Policy para respostas. Você também pode digitar qualquer outro nome de cabeçalho.
Regras #
- Os nomes de cabeçalho podem usar letras, números e hifens, por exemplo
X-Api-Key, e ter até 256 caracteres. - Um nome pode aparecer uma vez por aba. Uma segunda linha com o mesmo nome é recusada com "NAME já está nesta lista."
- Uma linha precisa de um nome. Uma linha vazia é ignorada ao salvar.
Cabeçalho Host #
Por padrão, o seu serviço recebe o endereço do túnel como o nome do host de uma requisição. Para enviar outro nome de host, adicione o cabeçalho de requisição Host na caixa de diálogo Cabeçalhos HTTP e defina o valor dele como o nome que o seu serviço espera, por exemplo localhost ou shop.internal.
Use isto quando um servidor web local escolhe o site pelo nome do host, como um virtual host do Apache ou do nginx, o IIS com associações de host ou um servidor de desenvolvimento que só responde por localhost. Veja Hosts virtuais para um exemplo completo.
Reescrever caminho #
Uma reescrita de caminho adiciona um caminho na frente de toda requisição antes que ela chegue ao seu serviço local. Os visitantes continuam usando o endereço curto.
-
Mude Reescrever caminho? para Sim #
A caixa de diálogo Reescrever caminho abre.
-
Digite o caminho a adicionar #
Digite-o em Caminho a adicionar, por exemplo
/apiou/app/v2, ou selecione um dos Caminhos comuns. O caminho começa com uma barra; se você omitir a barra, ela é adicionada para você. A caixa Exemplo mostra o resultado para uma requisição de amostra. -
Salve #
Selecione Salvar.
Com /api como caminho:
| O visitante abre | Seu serviço recebe |
|---|---|
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7 | /api/orders?id=7 |
Um túnel tem um caminho, com até 200 caracteres. Ele não pode conter espaços e não pode ser apenas /. Para removê-lo, mude Reescrever caminho? para Não e confirme Desativar a reescrita de caminho?: o caminho salvo é removido e as requisições chegam ao seu serviço com o caminho original.
Tempo limite HTTP #
Tempo limite HTTP › Gerenciar abre a caixa de diálogo Tempo limite da requisição. O tempo limite é quanto tempo o túnel espera que o seu serviço responda a uma requisição. Depois disso, o visitante recebe um erro de tempo limite.
| Item | Valores |
|---|---|
| Tempo limite | Um número inteiro de 1 a 600 segundos. Deixe vazio para usar o padrão do servidor. |
| Predefinições | Padrão do servidor, 30 s, 1 min, 2 min, 5 min, 10 min |
Aumente o tempo limite para relatórios lentos, uploads grandes ou long polling. Escolha Padrão do servidor para voltar ao valor padrão.
Somente HTTPS? #
Mude Somente HTTPS? para Sim e confirme Ativar somente HTTPS? para servir a URL pública apenas por HTTPS. Use isso para tudo que envolva logins ou dados pessoais, para que ninguém acesse o túnel por HTTP simples.
HTTP/3 ativo? #
Mude HTTP/3 ativo? para Sim para permitir que os clientes acessem a URL pública por HTTP/3. Os clientes que não oferecem suporte a HTTP/3 continuam usando as versões anteriores do HTTP.
Exemplos #
Deixe um aplicativo web de outro site chamar a sua API #
Seu front-end roda em https://app.example.com e chama uma API atrás de um túnel. Abra Cabeçalhos › Gerenciar, vá para Cabeçalhos de resposta e selecione Permitir CORS. Substitua o * de Access-Control-Allow-Origin por https://app.example.com se somente esse site puder chamar a API e depois selecione Salvar.
Publique um aplicativo que fica em um subcaminho #
Seu servidor de aplicativo serve o aplicativo em /app/v2 e você quer que os visitantes abram o endereço simples do túnel. Ative Reescrever caminho? e digite /app/v2. Um visitante que abre /login chega a /app/v2/login no seu serviço.
As mesmas configurações pela API #
Estas configurações também estão disponíveis em /api/v2/tunnels/<TUNNEL_ID>/: headers, host-header, path-rewrite, http-timeout, https-only e http3. Veja API.
Solução de problemas #
"Nomes de cabeçalho podem usar letras, números e hifens, por exemplo X-Api-Key."
O nome contém um caractere que não é permitido em um nome de cabeçalho, como um espaço ou dois-pontos. Digite apenas o nome em Nome e o restante em Valor.
"Dê um nome a este cabeçalho ou remova a linha."
Uma linha tem valor, mas não tem nome. Preencha o nome ou remova a linha.
"Informe apenas o caminho, sem http:// nem o nome do host."
Caminho a adicionar aceita um caminho como /api, não uma URL completa.
"Informe um número inteiro de 1 a 600 ou escolha Padrão do servidor."
O tempo limite deve ficar entre 1 e 600 segundos. Para uma tarefa mais longa, responda à requisição primeiro e deixe o cliente pedir o resultado depois.
Meu cabeçalho CORS não funciona com cookies
Access-Control-Allow-Credentials não funciona junto com Access-Control-Allow-Origin: *. Defina Access-Control-Allow-Origin como a origem exata do site que faz a chamada.
Meu serviço local usa HTTPS e o túnel mostra um erro
Isso não é um problema de cabeçalho. Ative HTTPS local?, que informa ao túnel que o seu próprio serviço local usa HTTPS. Veja Referência de configurações.