Naar de inhoud
Localtonet Localtonet Dashboard

Headers, padherschrijving en HTTP-opties

Hulp bij deze pagina
Op deze pagina 11 secties
  1. Voordat je begint
  2. HTTP-headers
  3. Een header toevoegen
  4. Kies het headertype
  5. Voeg de header toe
  6. Opslaan
  7. Kant-en-klare sets
  8. Voorgestelde headers
  9. Regels
  10. Host-header
  11. Pad herschrijven
  12. Zet Pad herschrijven? op Ja
  13. Voer het toe te voegen pad in
  14. Opslaan
  15. HTTP-time-out
  16. Alleen HTTPS?
  17. HTTP/3 actief?
  18. Voorbeelden
  19. Een webapp op een andere site je API laten aanroepen
  20. Een app publiceren die onder een subpad staat
  21. Dezelfde instellingen via de API
  22. Probleemoplossing
  23. 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.
InstellingHTTPMCP-gateway
HeadersJa–
Pad herschrijven?Ja–
HTTP-time-outJaJa
Alleen HTTPS?JaJa
HTTP/3 actief?JaJa

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 #

  1. Kies het headertype #

    Kies bovenaan het dialoogvenster Verzoekheaders of Responsheaders. Elk tabblad toont hoeveel headers het bevat.

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

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

SetHeaders die hij toevoegtGebruik het voor
CORS toestaan
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Laat webapps op andere sites deze tunnel aanroepen.
Beveiligingsheaders
  • 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, framebescherming en referrerbeleid.
Caching uitschakelenCache-Control: no-storeVoorkomt dat browsers en proxy's antwoorden cachen.
Verbergen voor zoekmachinesX-Robots-Tag: noindex, nofollowVraagt zoekmachines dit adres niet te vermelden.

Voorgestelde headers #

HeaderTypeWat het dialoogvenster erover zegt
HostVerzoekJe service ontvangt deze hostnaam in plaats van het tunneladres. Handig wanneer een lokale webserver de site op hostnaam kiest.
AuthorizationVerzoekStuurt bij elk verzoek dezelfde inloggegevens naar je service.
X-API-KeyVerzoekEen vaste sleutel voor services die er een in een header verwachten.
X-Forwarded-ProtoVerzoekVertelt je app dat bezoekers HTTPS gebruiken, zodat hij https://-links en omleidingen opbouwt.
OriginVerzoekSommige services accepteren alleen verzoeken van een bekende oorsprong.
Access-Control-Allow-OriginResponsWelke websites deze tunnel vanuit een browser mogen aanroepen. * staat elke site toe.
Access-Control-Allow-CredentialsResponsLaat browsers cookies verzenden. Werkt niet samen met Access-Control-Allow-Origin: *.
Strict-Transport-SecurityResponsVertelt browsers om voor dit adres altijd HTTPS te gebruiken.
X-Frame-OptionsResponsVoorkomt dat andere sites je pagina's in een frame tonen.
Content-Security-PolicyResponsBepaalt waarvandaan pagina's scripts, stijlen en afbeeldingen mogen laden. Een strikt beleid kan pagina's laten stuklopen, dus test het.
Cache-ControlResponsno-store voorkomt dat browsers en proxy's antwoorden cachen.
X-Robots-TagResponsVraagt 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.

  1. Zet Pad herschrijven? op Ja #

    Het dialoogvenster Pad herschrijven wordt geopend.

  2. Voer het toe te voegen pad in #

    Typ het in Toe te voegen pad, bijvoorbeeld /api of /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.

  3. Opslaan #

    Kies Opslaan.

Met /api als pad:

Bezoeker opentJe 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.

OnderdeelWaarden
Time-outEen geheel getal van 1 tot 600 seconden. Laat leeg voor de serverstandaard.
VoorinstellingenServerstandaard, 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.

Support