Zum Inhalt springen
Localtonet Localtonet Dashboard

Header, Pfad-Umschreibung und HTTP-Optionen

Hilfe zu dieser Seite
Auf dieser Seite 11 Abschnitte
  1. Bevor Sie beginnen
  2. HTTP-Header
  3. Einen Header hinzufügen
  4. Den Header-Typ wählen
  5. Den Header hinzufügen
  6. Speichern
  7. Fertige Sets
  8. Vorgeschlagene Header
  9. Regeln
  10. Host-Header
  11. Pfad umschreiben
  12. „Pfad umschreiben?“ auf Ja stellen
  13. Den hinzuzufügenden Pfad eingeben
  14. Speichern
  15. HTTP-Timeout
  16. Nur HTTPS?
  17. HTTP/3 aktiv?
  18. Beispiele
  19. Eine Web-App auf einer anderen Website Ihre API aufrufen lassen
  20. Eine App veröffentlichen, die unter einem Unterpfad liegt
  21. Dieselben Einstellungen über die API
  22. Fehlerbehebung
  23. Verwandte Seiten

Ändern Sie, wie HTTP-Anfragen und -Antworten durch einen Tunnel laufen: Fügen Sie feste Header hinzu, legen Sie den Host-Header fest, den Ihr Dienst erhält, setzen Sie einen Pfad vor jede Anfrage, stellen Sie das Anfrage-Timeout ein und wählen Sie für die öffentliche Adresse nur HTTPS oder HTTP/3.

Bevor Sie beginnen #

  • Ein HTTP-Tunnel. Siehe HTTP / HTTPS.
  • Die Einstellungen finden Sie im Einstellungspanel des Tunnels: Öffnen Sie Meine Tunnel › HTTP und wählen Sie in der Zeile des Tunnels Einstellungen.
EinstellungHTTPMCP-Gateway
HeaderJa–
Pfad umschreiben?Ja–
HTTP-TimeoutJaJa
Nur HTTPS?JaJa
HTTP/3 aktiv?JaJa

Keine dieser Einstellungen startet den Tunnel neu. Eine Änderung wird auf den laufenden Tunnel angewendet, sobald Sie sie speichern.

HTTP-Header #

Header › Verwalten öffnet den Dialog HTTP-Header. Er fügt dem Datenverkehr, der durch den Tunnel läuft, feste Header hinzu:

  • Request-Header erreichen Ihren lokalen Dienst bei jeder Anfrage.
  • Response-Header erreichen den Besucher bei jeder Antwort.

Werte werden genau so gesendet, wie Sie sie eingeben.

Einen Header hinzufügen #

  1. Den Header-Typ wählen #

    Wählen Sie oben im Dialog Request-Header oder Response-Header. Jeder Tab zeigt, wie viele Header er enthält.

  2. Den Header hinzufügen #

    Wählen Sie Header hinzufügen und füllen Sie Name und Wert aus, oder wählen Sie unter Vorschläge einen Namen, um eine Zeile mit einem sinnvollen Startwert zu erhalten. Bei einem Header, den der Dialog kennt, erklärt das Info-Symbol in der Zeile, was er bewirkt.

  3. Speichern #

    Wählen Sie Speichern. Um einen Header zu entfernen, wählen Sie die Entfernen-Schaltfläche seiner Zeile und dann Speichern.

Fertige Sets #

Auf dem Tab Response-Header fügen Fertige Sets eine Gruppe von Headern in einem Schritt hinzu. Der Dialog meldet dann „NAME hinzugefügt. Prüfen Sie die Werte und speichern Sie dann.“ Ein Set füllt einen Header, der bereits in der Liste steht, nur aus, wenn dessen Wert leer ist.

SetHinzugefügte HeaderGeeignet für
CORS erlauben
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Erlaubt Web-Apps auf anderen Websites, diesen Tunnel aufzurufen.
Sicherheits-Header
  • 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, Frame-Schutz und Referrer-Policy.
Caching ausschaltenCache-Control: no-storeVerhindert, dass Browser und Proxys Antworten zwischenspeichern.
Vor Suchmaschinen verbergenX-Robots-Tag: noindex, nofollowBittet Suchmaschinen, diese Adresse nicht aufzulisten.

Vorgeschlagene Header #

HeaderTypWas der Dialog dazu sagt
HostRequestIhr Dienst erhält diesen Hostnamen statt der Tunneladresse. Nützlich, wenn ein lokaler Webserver die Website anhand des Hostnamens auswählt.
AuthorizationRequestSendet bei jeder Anfrage dieselben Zugangsdaten an Ihren Dienst.
X-API-KeyRequestEin fester Schlüssel für Dienste, die einen in einem Header erwarten.
X-Forwarded-ProtoRequestTeilt Ihrer App mit, dass Besucher HTTPS verwenden, damit sie https://-Links und Weiterleitungen erzeugt.
OriginRequestManche Dienste akzeptieren nur Anfragen von einem bekannten Origin.
Access-Control-Allow-OriginResponseWelche Websites diesen Tunnel aus einem Browser aufrufen dürfen. * erlaubt jede Website.
Access-Control-Allow-CredentialsResponseErlaubt Browsern, Cookies zu senden. Funktioniert nicht zusammen mit Access-Control-Allow-Origin: *.
Strict-Transport-SecurityResponseWeist Browser an, für diese Adresse immer HTTPS zu verwenden.
X-Frame-OptionsResponseVerhindert, dass andere Websites Ihre Seiten in einem Frame anzeigen.
Content-Security-PolicyResponseSteuert, von wo Seiten Skripte, Stile und Bilder laden dürfen. Eine strenge Richtlinie kann Seiten beschädigen, testen Sie sie daher.
Cache-ControlResponseno-store verhindert, dass Browser und Proxys Antworten zwischenspeichern.
X-Robots-TagResponseBittet Suchmaschinen, diese Adresse nicht aufzulisten.

Die Vorschläge enthalten außerdem User-Agent, Accept-Language und Cache-Control für Anfragen sowie Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy und Permissions-Policy für Antworten. Sie können auch jeden anderen Header-Namen eingeben.

Regeln #

  • Header-Namen dürfen Buchstaben, Ziffern und Bindestriche enthalten, zum Beispiel X-Api-Key, und bis zu 256 Zeichen lang sein.
  • Ein Name darf pro Tab einmal vorkommen. Eine zweite Zeile mit demselben Namen wird mit „NAME ist bereits in dieser Liste.“ abgelehnt.
  • Eine Zeile braucht einen Namen. Eine leere Zeile wird beim Speichern ignoriert.

Host-Header #

Standardmäßig erhält Ihr Dienst die Tunneladresse als Hostnamen einer Anfrage. Um einen anderen Hostnamen zu senden, fügen Sie im Dialog HTTP-Header den Request-Header Host hinzu und setzen Sie seinen Wert auf den Namen, den Ihr Dienst erwartet, zum Beispiel localhost oder shop.internal.

Nutzen Sie das, wenn ein lokaler Webserver die Website anhand des Hostnamens auswählt, etwa ein Apache- oder nginx-Virtual-Host, IIS mit Host-Bindungen oder ein Entwicklungsserver, der nur auf localhost antwortet. Ein vollständiges Beispiel finden Sie unter Virtual Hosts.

Pfad umschreiben #

Eine Pfad-Umschreibung setzt einen Pfad vor jede Anfrage, bevor sie Ihren lokalen Dienst erreicht. Besucher verwenden weiterhin die kurze Adresse.

  1. „Pfad umschreiben?“ auf Ja stellen #

    Der Dialog Pfad umschreiben öffnet sich.

  2. Den hinzuzufügenden Pfad eingeben #

    Geben Sie ihn unter Hinzuzufügender Pfad ein, zum Beispiel /api oder /app/v2, oder wählen Sie einen der Gängige Pfade. Der Pfad beginnt mit einem Schrägstrich; lassen Sie ihn weg, wird er für Sie ergänzt. Das Feld Beispiel zeigt das Ergebnis für eine Beispielanfrage.

  3. Speichern #

    Wählen Sie Speichern.

Mit /api als Pfad:

Besucher öffnetIhr Dienst erhält
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7/api/orders?id=7

Ein Tunnel hat einen Pfad mit bis zu 200 Zeichen. Er darf keine Leerzeichen enthalten und nicht nur / sein. Um ihn zu entfernen, stellen Sie Pfad umschreiben? auf Nein und bestätigen Sie Pfad-Umschreibung ausschalten?: Der gespeicherte Pfad wird entfernt, und Anfragen erreichen Ihren Dienst mit ihrem ursprünglichen Pfad.

HTTP-Timeout #

HTTP-Timeout › Verwalten öffnet den Dialog Anfrage-Timeout. Das Timeout ist die Zeit, die der Tunnel auf die Antwort Ihres Dienstes auf eine Anfrage wartet. Danach erhält der Besucher einen Timeout-Fehler.

ElementWerte
TimeoutEine ganze Zahl von 1 bis 600 Sekunden. Leer lassen für den Server-Standard.
VorgabenServer-Standard, 30 s, 1 min, 2 min, 5 min, 10 min

Erhöhen Sie das Timeout für langsame Berichte, große Uploads oder Long Polling. Wählen Sie Server-Standard, um zum Standardwert zurückzukehren.

Nur HTTPS? #

Stellen Sie Nur HTTPS? auf Ja und bestätigen Sie Nur HTTPS einschalten?, damit die öffentliche URL nur über HTTPS bereitgestellt wird. Nutzen Sie das für alles, was Anmeldungen oder personenbezogene Daten überträgt, damit niemand den Tunnel über unverschlüsseltes HTTP erreicht.

HTTP/3 aktiv? #

Stellen Sie HTTP/3 aktiv? auf Ja, damit Clients die öffentliche URL über HTTP/3 erreichen können. Clients, die HTTP/3 nicht unterstützen, verwenden weiterhin die früheren HTTP-Versionen.

Beispiele #

Eine Web-App auf einer anderen Website Ihre API aufrufen lassen #

Ihr Frontend läuft auf https://app.example.com und ruft eine API hinter einem Tunnel auf. Öffnen Sie Header › Verwalten, wechseln Sie zu Response-Header und wählen Sie CORS erlauben. Ersetzen Sie das * von Access-Control-Allow-Origin durch https://app.example.com, wenn nur diese Website die API aufrufen darf, und wählen Sie dann Speichern.

Eine App veröffentlichen, die unter einem Unterpfad liegt #

Ihr Anwendungsserver stellt die App unter /app/v2 bereit, und Besucher sollen die einfache Tunneladresse öffnen. Schalten Sie Pfad umschreiben? ein und geben Sie /app/v2 ein. Ein Besucher, der /login öffnet, erreicht auf Ihrem Dienst /app/v2/login.

Dieselben Einstellungen über die API #

Diese Einstellungen sind auch unter /api/v2/tunnels/<TUNNEL_ID>/ verfügbar: headers, host-header, path-rewrite, http-timeout, https-only und http3. Siehe API.

Fehlerbehebung #

„Header-Namen dürfen Buchstaben, Ziffern und Bindestriche enthalten, zum Beispiel X-Api-Key.“

Der Name enthält ein Zeichen, das in einem Header-Namen nicht erlaubt ist, etwa ein Leerzeichen oder einen Doppelpunkt. Geben Sie unter Name nur den Namen ein und den Rest unter Wert.

„Geben Sie einen Namen für diesen Header ein oder entfernen Sie die Zeile.“

Eine Zeile hat einen Wert, aber keinen Namen. Tragen Sie den Namen ein oder entfernen Sie die Zeile.

„Geben Sie nur den Pfad ein, ohne http:// und Hostnamen.“

Hinzuzufügender Pfad nimmt einen Pfad wie /api entgegen, keine vollständige URL.

„Geben Sie eine ganze Zahl von 1 bis 600 ein oder wählen Sie „Server-Standard“.“

Das Timeout muss zwischen 1 und 600 Sekunden liegen. Beantworten Sie bei einer längeren Aufgabe die Anfrage zuerst und lassen Sie den Client das Ergebnis später abfragen.

Mein CORS-Header funktioniert nicht mit Cookies

Access-Control-Allow-Credentials funktioniert nicht zusammen mit Access-Control-Allow-Origin: *. Setzen Sie Access-Control-Allow-Origin auf den exakten Origin der aufrufenden Website.

Mein lokaler Dienst verwendet HTTPS, und der Tunnel zeigt einen Fehler

Das ist kein Header-Problem. Schalten Sie SslStream aktiv? ein, wodurch der Tunnel erfährt, dass Ihr lokaler Dienst selbst HTTPS verwendet. Siehe Einstellungsreferenz.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support