Vai al contenuto
Localtonet Localtonet Dashboard

Header, riscrittura del percorso e opzioni HTTP

Aiuto su questa pagina
In questa pagina 11 sezioni
  1. Prima di iniziare
  2. Header HTTP
  3. Aggiungi un header
  4. Scegli il tipo di header
  5. Aggiungi l'header
  6. Salva
  7. Set pronti
  8. Header suggeriti
  9. Regole
  10. Header Host
  11. Riscrittura del percorso
  12. Imposta Riscrittura del percorso? su Sì
  13. Inserisci il percorso da aggiungere
  14. Salva
  15. Timeout HTTP
  16. Solo HTTPS?
  17. HTTP/3 attivo?
  18. Esempi
  19. Permettere a un'app web di un altro sito di chiamare la tua API
  20. Pubblicare un'app che si trova in un sotto-percorso
  21. Le stesse impostazioni tramite l'API
  22. Risoluzione dei problemi
  23. 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.
ImpostazioneHTTPGateway MCP
HeaderSì–
Riscrittura del percorso?Sì–
Timeout HTTPSì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 #

  1. Scegli il tipo di header #

    Seleziona Header della richiesta o Header della risposta in cima alla finestra. Ogni scheda mostra quanti header contiene.

  2. 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.

  3. 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.

SetHeader che aggiungeDa usare per
Consenti CORS
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Permette alle app web di altri siti di chiamare questo tunnel.
Header di sicurezza
  • Strict-Transport-Security: max-age=31536000; includeSubDomains
  • X-Content-Type-Options: nosniff
  • X-Frame-Options: SAMEORIGIN
  • Referrer-Policy: strict-origin-when-cross-origin
HSTS, nosniff, protezione dai frame e referrer policy.
Disattiva la cacheCache-Control: no-storeImpedisce a browser e proxy di mettere in cache le risposte.
Nascondi ai motori di ricercaX-Robots-Tag: noindex, nofollowChiede ai motori di ricerca di non elencare questo indirizzo.

Header suggeriti #

HeaderTipoCosa dice la finestra a riguardo
HostRichiestaIl 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.
AuthorizationRichiestaInvia le stesse credenziali al tuo servizio a ogni richiesta.
X-API-KeyRichiestaUna chiave fissa per i servizi che ne aspettano una in un header.
X-Forwarded-ProtoRichiestaDice alla tua app che i visitatori usano HTTPS, così costruisce link e reindirizzamenti https://.
OriginRichiestaAlcuni servizi accettano solo richieste da un'origine nota.
Access-Control-Allow-OriginRispostaQuali siti web possono chiamare questo tunnel da un browser. * consente qualsiasi sito.
Access-Control-Allow-CredentialsRispostaPermette ai browser di inviare i cookie. Non funziona insieme a Access-Control-Allow-Origin: *.
Strict-Transport-SecurityRispostaDice ai browser di usare sempre HTTPS per questo indirizzo.
X-Frame-OptionsRispostaImpedisce ad altri siti di mostrare le tue pagine in un frame.
Content-Security-PolicyRispostaControlla da dove le pagine possono caricare script, stili e immagini. Una policy rigida può rompere le pagine, quindi provala.
Cache-ControlRispostano-store impedisce a browser e proxy di mettere in cache le risposte.
X-Robots-TagRispostaChiede 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.

  1. Imposta Riscrittura del percorso? su Sì #

    Si apre la finestra Riscrittura del percorso.

  2. Inserisci il percorso da aggiungere #

    Digitalo in Percorso da aggiungere, ad esempio /api o /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.

  3. Salva #

    Seleziona Salva.

Con /api come percorso:

Il visitatore apreIl 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.

VoceValori
TimeoutUn numero intero da 1 a 600 secondi. Lascialo vuoto per il valore predefinito del server.
PreimpostazioniPredefinito 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.

Supporto