Headers, padherschrijving en HTTP-opties
Op deze pagina 11 secties
- Voordat je begint
- HTTP-headers
- Een header toevoegen
- Kies het headertype
- Voeg de header toe
- Opslaan
- Kant-en-klare sets
- Voorgestelde headers
- Regels
- Host-header
- Pad herschrijven
- Zet Pad herschrijven? op Ja
- Voer het toe te voegen pad in
- Opslaan
- HTTP-time-out
- Alleen HTTPS?
- HTTP/3 actief?
- Voorbeelden
- Een webapp op een andere site je API laten aanroepen
- Een app publiceren die onder een subpad staat
- Dezelfde instellingen via de API
- Probleemoplossing
- Gerelateerde pagina's
Wijzig hoe HTTP-verzoeken en -antwoorden door een tunnel gaan: voeg vaste headers toe, bepaal de Host-header die je service ontvangt, zet een pad voor elk verzoek, stel de time-out van verzoeken in en kies voor het openbare adres alleen HTTPS of HTTP/3.
Voordat je begint #
- Een HTTP-tunnel. Zie HTTP / HTTPS.
- De instellingen staan in het instellingenpaneel van de tunnel: open Mijn tunnels › HTTP en kies Instellingen in de rij van de tunnel.
| Instelling | HTTP | MCP-gateway |
|---|---|---|
| Headers | Ja | – |
| Pad herschrijven? | Ja | – |
| HTTP-time-out | Ja | Ja |
| Alleen HTTPS? | Ja | Ja |
| HTTP/3 actief? | Ja | Ja |
Geen van deze instellingen herstart de tunnel. Een wijziging wordt op de draaiende tunnel toegepast zodra je opslaat.
HTTP-headers #
Headers › Beheren opent het dialoogvenster HTTP-headers. Daarmee voeg je vaste headers toe aan het verkeer dat door de tunnel gaat:
- Verzoekheaders bereiken je lokale service bij elk verzoek.
- Responsheaders bereiken de bezoeker bij elk antwoord.
Waarden worden precies verzonden zoals je ze typt.
Een header toevoegen #
-
Kies het headertype #
Kies bovenaan het dialoogvenster Verzoekheaders of Responsheaders. Elk tabblad toont hoeveel headers het bevat.
-
Voeg de header toe #
Kies Header toevoegen en vul Naam en Waarde in, of kies onder Suggesties een naam om een rij met een zinnige beginwaarde te krijgen. Bij een header die het dialoogvenster kent, legt het informatiepictogram in de rij uit wat de header doet.
-
Opslaan #
Kies Opslaan. Om een header te verwijderen, kies je de verwijderknop van de rij en daarna Opslaan.
Kant-en-klare sets #
Op het tabblad Responsheaders voegen Kant-en-klare sets in één stap een groep headers toe. Het dialoogvenster meldt dan "NAME toegevoegd. Controleer de waarden en sla daarna op." Een set vult een header die al in de lijst staat alleen in als de waarde ervan leeg is.
| Set | Headers die hij toevoegt | Gebruik het voor |
|---|---|---|
| CORS toestaan |
| Laat webapps op andere sites deze tunnel aanroepen. |
| Beveiligingsheaders |
| HSTS, nosniff, framebescherming en referrerbeleid. |
| Caching uitschakelen | Cache-Control: no-store | Voorkomt dat browsers en proxy's antwoorden cachen. |
| Verbergen voor zoekmachines | X-Robots-Tag: noindex, nofollow | Vraagt zoekmachines dit adres niet te vermelden. |
Voorgestelde headers #
| Header | Type | Wat het dialoogvenster erover zegt |
|---|---|---|
Host | Verzoek | Je service ontvangt deze hostnaam in plaats van het tunneladres. Handig wanneer een lokale webserver de site op hostnaam kiest. |
Authorization | Verzoek | Stuurt bij elk verzoek dezelfde inloggegevens naar je service. |
X-API-Key | Verzoek | Een vaste sleutel voor services die er een in een header verwachten. |
X-Forwarded-Proto | Verzoek | Vertelt je app dat bezoekers HTTPS gebruiken, zodat hij https://-links en omleidingen opbouwt. |
Origin | Verzoek | Sommige services accepteren alleen verzoeken van een bekende oorsprong. |
Access-Control-Allow-Origin | Respons | Welke websites deze tunnel vanuit een browser mogen aanroepen. * staat elke site toe. |
Access-Control-Allow-Credentials | Respons | Laat browsers cookies verzenden. Werkt niet samen met Access-Control-Allow-Origin: *. |
Strict-Transport-Security | Respons | Vertelt browsers om voor dit adres altijd HTTPS te gebruiken. |
X-Frame-Options | Respons | Voorkomt dat andere sites je pagina's in een frame tonen. |
Content-Security-Policy | Respons | Bepaalt waarvandaan pagina's scripts, stijlen en afbeeldingen mogen laden. Een strikt beleid kan pagina's laten stuklopen, dus test het. |
Cache-Control | Respons | no-store voorkomt dat browsers en proxy's antwoorden cachen. |
X-Robots-Tag | Respons | Vraagt zoekmachines dit adres niet te vermelden. |
De suggesties bevatten ook User-Agent, Accept-Language en Cache-Control voor verzoeken, en Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy en Permissions-Policy voor responsen. Je kunt ook elke andere headernaam typen.
Regels #
- Headernamen mogen letters, cijfers en streepjes bevatten, bijvoorbeeld
X-Api-Key, en mogen maximaal 256 tekens lang zijn. - Een naam mag één keer per tabblad voorkomen. Een tweede rij met dezelfde naam wordt geweigerd met "NAME staat al in deze lijst."
- Een rij heeft een naam nodig. Een lege rij wordt bij het opslaan genegeerd.
Host-header #
Standaard ontvangt je service het tunneladres als hostnaam van een verzoek. Om een andere hostnaam te verzenden, voeg je in het dialoogvenster HTTP-headers de verzoekheader Host toe en geef je die als waarde de naam die je service verwacht, bijvoorbeeld localhost of shop.internal.
Gebruik dit wanneer een lokale webserver de site op hostnaam kiest, zoals een virtuele host van Apache of nginx, IIS met hostbindingen, of een ontwikkelserver die alleen antwoordt voor localhost. Zie Virtuele hosts voor een volledig voorbeeld.
Pad herschrijven #
Een padherschrijving voegt een pad toe voor elk verzoek voordat het je lokale service bereikt. Bezoekers blijven het korte adres gebruiken.
-
Zet Pad herschrijven? op Ja #
Het dialoogvenster Pad herschrijven wordt geopend.
-
Voer het toe te voegen pad in #
Typ het in Toe te voegen pad, bijvoorbeeld
/apiof/app/v2, of kies een van de Veelgebruikte paden. Het pad begint met een schuine streep; als je die weglaat, wordt hij voor je toegevoegd. Het vak Voorbeeld toont het resultaat voor een voorbeeldverzoek. -
Opslaan #
Kies Opslaan.
Met /api als pad:
| Bezoeker opent | Je service krijgt |
|---|---|
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7 | /api/orders?id=7 |
Een tunnel heeft één pad, tot 200 tekens. Het mag geen spaties bevatten en mag niet alleen / zijn. Om het te verwijderen, zet je Pad herschrijven? op Nee en bevestig je Pad herschrijven uitschakelen?: het opgeslagen pad wordt verwijderd en verzoeken bereiken je service met hun oorspronkelijke pad.
HTTP-time-out #
HTTP-time-out › Beheren opent het dialoogvenster Time-out van verzoeken. De time-out is hoe lang de tunnel wacht tot je service een verzoek beantwoordt. Daarna krijgt de bezoeker een time-outfout.
| Onderdeel | Waarden |
|---|---|
| Time-out | Een geheel getal van 1 tot 600 seconden. Laat leeg voor de serverstandaard. |
| Voorinstellingen | Serverstandaard, 30 s, 1 min, 2 min, 5 min, 10 min |
Verhoog de time-out voor trage rapporten, grote uploads of long polling. Kies Serverstandaard om terug te gaan naar de standaardwaarde.
Alleen HTTPS? #
Zet Alleen HTTPS? op Ja en bevestig Alleen HTTPS inschakelen? om de openbare URL uitsluitend via HTTPS aan te bieden. Gebruik dit voor alles wat logins of persoonsgegevens bevat, zodat niemand de tunnel via gewoon HTTP bereikt.
HTTP/3 actief? #
Zet HTTP/3 actief? op Ja zodat clients de openbare URL via HTTP/3 kunnen bereiken. Clients die HTTP/3 niet ondersteunen, blijven de eerdere HTTP-versies gebruiken.
Voorbeelden #
Een webapp op een andere site je API laten aanroepen #
Je front-end draait op https://app.example.com en roept een API achter een tunnel aan. Open Headers › Beheren, ga naar Responsheaders en kies CORS toestaan. Vervang de * van Access-Control-Allow-Origin door https://app.example.com als alleen die site de API mag aanroepen, en kies daarna Opslaan.
Een app publiceren die onder een subpad staat #
Je applicatieserver biedt de app aan onder /app/v2 en je wilt dat bezoekers het gewone tunneladres openen. Zet Pad herschrijven? aan en voer /app/v2 in. Een bezoeker die /login opent, bereikt /app/v2/login op je service.
Dezelfde instellingen via de API #
Deze instellingen zijn ook beschikbaar onder /api/v2/tunnels/<TUNNEL_ID>/: headers, host-header, path-rewrite, http-timeout, https-only en http3. Zie API.
Probleemoplossing #
"Headernamen mogen letters, cijfers en streepjes bevatten, bijvoorbeeld X-Api-Key."
De naam bevat een teken dat in een headernaam niet is toegestaan, zoals een spatie of een dubbele punt. Voer in Naam alleen de naam in en de rest in Waarde.
"Voeg een naam toe voor deze header of verwijder de rij."
Een rij heeft een waarde maar geen naam. Vul de naam in of verwijder de rij.
"Voer alleen het pad in, zonder http:// en de hostnaam."
Toe te voegen pad accepteert een pad zoals /api, geen volledige URL.
"Voer een geheel getal van 1 tot 600 in, of kies Serverstandaard."
De time-out moet tussen 1 en 600 seconden liggen. Beantwoord bij een langere taak eerst het verzoek en laat de client het resultaat later opvragen.
Mijn CORS-header werkt niet met cookies
Access-Control-Allow-Credentials werkt niet samen met Access-Control-Allow-Origin: *. Stel Access-Control-Allow-Origin in op de exacte oorsprong van de aanroepende site.
Mijn lokale service gebruikt HTTPS en de tunnel toont een fout
Dat is geen headerprobleem. Schakel SslStream? in; dat vertelt de tunnel dat je lokale service zelf HTTPS gebruikt. Zie Instellingenreferentie.