Header, riscrittura del percorso e opzioni HTTP
In questa pagina 11 sezioni
- Prima di iniziare
- Header HTTP
- Aggiungi un header
- Scegli il tipo di header
- Aggiungi l'header
- Salva
- Set pronti
- Header suggeriti
- Regole
- Header Host
- Riscrittura del percorso
- Imposta Riscrittura del percorso? su Sì
- Inserisci il percorso da aggiungere
- Salva
- Timeout HTTP
- Solo HTTPS?
- HTTP/3 attivo?
- Esempi
- Permettere a un'app web di un altro sito di chiamare la tua API
- Pubblicare un'app che si trova in un sotto-percorso
- Le stesse impostazioni tramite l'API
- Risoluzione dei problemi
- Pagine correlate
Cambia il modo in cui richieste e risposte HTTP attraversano un tunnel: aggiungi header fissi, imposta l'header Host che riceve il tuo servizio, anteponi un percorso a ogni richiesta, imposta il timeout della richiesta e scegli solo HTTPS o HTTP/3 per l'indirizzo pubblico.
Prima di iniziare #
- Un tunnel HTTP. Vedi HTTP / HTTPS.
- Le impostazioni si trovano nel pannello delle impostazioni del tunnel: apri I miei tunnel › HTTP e seleziona Impostazioni nella riga del tunnel.
| Impostazione | HTTP | Gateway MCP |
|---|---|---|
| Header | Sì | – |
| Riscrittura del percorso? | Sì | – |
| Timeout HTTP | Sì | Sì |
| Solo HTTPS? | Sì | Sì |
| HTTP/3 attivo? | Sì | Sì |
Nessuna di queste impostazioni riavvia il tunnel. Una modifica viene applicata al tunnel in esecuzione non appena la salvi.
Header HTTP #
Header › Gestisci apre la finestra Header HTTP. Aggiunge header fissi al traffico che attraversa il tunnel:
- Gli Header della richiesta raggiungono il tuo servizio locale a ogni richiesta.
- Gli Header della risposta raggiungono il visitatore a ogni risposta.
I valori vengono inviati esattamente come li digiti.
Aggiungi un header #
-
Scegli il tipo di header #
Seleziona Header della richiesta o Header della risposta in cima alla finestra. Ogni scheda mostra quanti header contiene.
-
Aggiungi l'header #
Seleziona Aggiungi header e compila Nome e Valore, oppure seleziona un nome sotto Suggerimenti per ottenere una riga con un valore iniziale sensato. Per un header che la finestra conosce, l'icona di informazioni nella riga ne spiega la funzione.
-
Salva #
Seleziona Salva. Per rimuovere un header, seleziona il pulsante di rimozione della sua riga, poi Salva.
Set pronti #
Nella scheda Header della risposta, i Set pronti aggiungono un gruppo di header in un solo passaggio. La finestra dice poi "NAME aggiunto. Controlla i valori, poi salva." Un set compila un header già presente nell'elenco solo se il suo valore è vuoto.
| Set | Header che aggiunge | Da usare per |
|---|---|---|
| Consenti CORS |
| Permette alle app web di altri siti di chiamare questo tunnel. |
| Header di sicurezza |
| HSTS, nosniff, protezione dai frame e referrer policy. |
| Disattiva la cache | Cache-Control: no-store | Impedisce a browser e proxy di mettere in cache le risposte. |
| Nascondi ai motori di ricerca | X-Robots-Tag: noindex, nofollow | Chiede ai motori di ricerca di non elencare questo indirizzo. |
Header suggeriti #
| Header | Tipo | Cosa dice la finestra a riguardo |
|---|---|---|
Host | Richiesta | Il tuo servizio riceve questo nome host al posto dell'indirizzo del tunnel. Utile quando un web server locale sceglie il sito in base al nome host. |
Authorization | Richiesta | Invia le stesse credenziali al tuo servizio a ogni richiesta. |
X-API-Key | Richiesta | Una chiave fissa per i servizi che ne aspettano una in un header. |
X-Forwarded-Proto | Richiesta | Dice alla tua app che i visitatori usano HTTPS, così costruisce link e reindirizzamenti https://. |
Origin | Richiesta | Alcuni servizi accettano solo richieste da un'origine nota. |
Access-Control-Allow-Origin | Risposta | Quali siti web possono chiamare questo tunnel da un browser. * consente qualsiasi sito. |
Access-Control-Allow-Credentials | Risposta | Permette ai browser di inviare i cookie. Non funziona insieme a Access-Control-Allow-Origin: *. |
Strict-Transport-Security | Risposta | Dice ai browser di usare sempre HTTPS per questo indirizzo. |
X-Frame-Options | Risposta | Impedisce ad altri siti di mostrare le tue pagine in un frame. |
Content-Security-Policy | Risposta | Controlla da dove le pagine possono caricare script, stili e immagini. Una policy rigida può rompere le pagine, quindi provala. |
Cache-Control | Risposta | no-store impedisce a browser e proxy di mettere in cache le risposte. |
X-Robots-Tag | Risposta | Chiede ai motori di ricerca di non elencare questo indirizzo. |
I suggerimenti includono anche User-Agent, Accept-Language e Cache-Control per le richieste, e Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy e Permissions-Policy per le risposte. Puoi digitare anche qualsiasi altro nome di header.
Regole #
- I nomi degli header possono contenere lettere, numeri e trattini, ad esempio
X-Api-Key, e possono essere lunghi fino a 256 caratteri. - Un nome può comparire una sola volta per scheda. Una seconda riga con lo stesso nome viene rifiutata con "NAME è già in questo elenco."
- Una riga ha bisogno di un nome. Una riga vuota viene ignorata al salvataggio.
Header Host #
Per impostazione predefinita il tuo servizio riceve l'indirizzo del tunnel come nome host di una richiesta. Per inviare un altro nome host, aggiungi l'header di richiesta Host nella finestra Header HTTP e imposta come valore il nome che il tuo servizio si aspetta, ad esempio localhost o shop.internal.
Usalo quando un web server locale sceglie il sito in base al nome host, come un virtual host di Apache o nginx, IIS con binding di host o un server di sviluppo che risponde solo per localhost. Vedi Virtual host per un esempio completo.
Riscrittura del percorso #
Una riscrittura del percorso aggiunge un percorso davanti a ogni richiesta prima che raggiunga il tuo servizio locale. I visitatori continuano a usare l'indirizzo breve.
-
Imposta Riscrittura del percorso? su Sì #
Si apre la finestra Riscrittura del percorso.
-
Inserisci il percorso da aggiungere #
Digitalo in Percorso da aggiungere, ad esempio
/apio/app/v2, oppure seleziona uno dei Percorsi comuni. Il percorso inizia con una barra; se la ometti, viene aggiunta per te. Il riquadro Esempio mostra il risultato per una richiesta di prova. -
Salva #
Seleziona Salva.
Con /api come percorso:
| Il visitatore apre | Il tuo servizio riceve |
|---|---|
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7 | /api/orders?id=7 |
Un tunnel ha un solo percorso, fino a 200 caratteri. Non può contenere spazi e non può essere solo /. Per rimuoverlo, imposta Riscrittura del percorso? su No e conferma Disattivare la riscrittura del percorso?: il percorso salvato viene rimosso e le richieste raggiungono il tuo servizio con il loro percorso originale.
Timeout HTTP #
Timeout HTTP › Gestisci apre la finestra Timeout della richiesta. Il timeout è il tempo per cui il tunnel attende che il tuo servizio risponda a una richiesta. Trascorso quel tempo, il visitatore riceve un errore di timeout.
| Voce | Valori |
|---|---|
| Timeout | Un numero intero da 1 a 600 secondi. Lascialo vuoto per il valore predefinito del server. |
| Preimpostazioni | Predefinito del server, 30 s, 1 min, 2 min, 5 min, 10 min |
Aumenta il timeout per report lenti, upload di grandi dimensioni o long polling. Scegli Predefinito del server per tornare al valore standard.
Solo HTTPS? #
Imposta Solo HTTPS? su Sì e conferma Attivare Solo HTTPS? per servire l'URL pubblico solo tramite HTTPS. Usalo per tutto ciò che gestisce accessi o dati personali, così nessuno raggiunge il tunnel tramite HTTP semplice.
HTTP/3 attivo? #
Imposta HTTP/3 attivo? su Sì per permettere ai client di raggiungere l'URL pubblico tramite HTTP/3. I client che non supportano HTTP/3 continuano a usare le versioni HTTP precedenti.
Esempi #
Permettere a un'app web di un altro sito di chiamare la tua API #
Il tuo front end gira su https://app.example.com e chiama un'API dietro un tunnel. Apri Header › Gestisci, vai su Header della risposta e seleziona Consenti CORS. Sostituisci il * di Access-Control-Allow-Origin con https://app.example.com se solo quel sito può chiamare l'API, poi seleziona Salva.
Pubblicare un'app che si trova in un sotto-percorso #
Il tuo application server serve l'app sotto /app/v2 e vuoi che i visitatori aprano il semplice indirizzo del tunnel. Attiva Riscrittura del percorso? e inserisci /app/v2. Un visitatore che apre /login raggiunge /app/v2/login sul tuo servizio.
Le stesse impostazioni tramite l'API #
Queste impostazioni sono disponibili anche sotto /api/v2/tunnels/<TUNNEL_ID>/: headers, host-header, path-rewrite, http-timeout, https-only e http3. Vedi API.
Risoluzione dei problemi #
"I nomi degli header possono contenere lettere, numeri e trattini, ad esempio X-Api-Key."
Il nome contiene un carattere non consentito in un nome di header, come uno spazio o i due punti. Inserisci in Nome solo il nome e il resto in Valore.
"Aggiungi un nome per questo header, oppure rimuovi la riga."
Una riga ha un valore ma nessun nome. Compila il nome oppure rimuovi la riga.
"Inserisci solo il percorso, senza http:// né il nome host."
Percorso da aggiungere accetta un percorso come /api, non un URL completo.
"Inserisci un numero intero da 1 a 600, oppure scegli Predefinito del server."
Il timeout deve essere compreso tra 1 e 600 secondi. Per un'operazione più lunga, rispondi prima alla richiesta e lascia che il client chieda il risultato in seguito.
Il mio header CORS non funziona con i cookie
Access-Control-Allow-Credentials non funziona insieme a Access-Control-Allow-Origin: *. Imposta Access-Control-Allow-Origin sull'origine esatta del sito che chiama.
Il mio servizio locale usa HTTPS e il tunnel mostra un errore
Non è un problema di header. Attiva SslStream attivo?, che dice al tunnel che il tuo servizio locale stesso usa HTTPS. Vedi Riferimento delle impostazioni.