Header, Pfad-Umschreibung und HTTP-Optionen
Auf dieser Seite 11 Abschnitte
- Bevor Sie beginnen
- HTTP-Header
- Einen Header hinzufügen
- Den Header-Typ wählen
- Den Header hinzufügen
- Speichern
- Fertige Sets
- Vorgeschlagene Header
- Regeln
- Host-Header
- Pfad umschreiben
- „Pfad umschreiben?“ auf Ja stellen
- Den hinzuzufügenden Pfad eingeben
- Speichern
- HTTP-Timeout
- Nur HTTPS?
- HTTP/3 aktiv?
- Beispiele
- Eine Web-App auf einer anderen Website Ihre API aufrufen lassen
- Eine App veröffentlichen, die unter einem Unterpfad liegt
- Dieselben Einstellungen über die API
- Fehlerbehebung
- 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.
| Einstellung | HTTP | MCP-Gateway |
|---|---|---|
| Header | Ja | – |
| Pfad umschreiben? | Ja | – |
| HTTP-Timeout | Ja | Ja |
| Nur HTTPS? | Ja | Ja |
| HTTP/3 aktiv? | Ja | Ja |
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 #
-
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.
-
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.
-
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.
| Set | Hinzugefügte Header | Geeignet für |
|---|---|---|
| CORS erlauben |
| Erlaubt Web-Apps auf anderen Websites, diesen Tunnel aufzurufen. |
| Sicherheits-Header |
| HSTS, nosniff, Frame-Schutz und Referrer-Policy. |
| Caching ausschalten | Cache-Control: no-store | Verhindert, dass Browser und Proxys Antworten zwischenspeichern. |
| Vor Suchmaschinen verbergen | X-Robots-Tag: noindex, nofollow | Bittet Suchmaschinen, diese Adresse nicht aufzulisten. |
Vorgeschlagene Header #
| Header | Typ | Was der Dialog dazu sagt |
|---|---|---|
Host | Request | Ihr Dienst erhält diesen Hostnamen statt der Tunneladresse. Nützlich, wenn ein lokaler Webserver die Website anhand des Hostnamens auswählt. |
Authorization | Request | Sendet bei jeder Anfrage dieselben Zugangsdaten an Ihren Dienst. |
X-API-Key | Request | Ein fester Schlüssel für Dienste, die einen in einem Header erwarten. |
X-Forwarded-Proto | Request | Teilt Ihrer App mit, dass Besucher HTTPS verwenden, damit sie https://-Links und Weiterleitungen erzeugt. |
Origin | Request | Manche Dienste akzeptieren nur Anfragen von einem bekannten Origin. |
Access-Control-Allow-Origin | Response | Welche Websites diesen Tunnel aus einem Browser aufrufen dürfen. * erlaubt jede Website. |
Access-Control-Allow-Credentials | Response | Erlaubt Browsern, Cookies zu senden. Funktioniert nicht zusammen mit Access-Control-Allow-Origin: *. |
Strict-Transport-Security | Response | Weist Browser an, für diese Adresse immer HTTPS zu verwenden. |
X-Frame-Options | Response | Verhindert, dass andere Websites Ihre Seiten in einem Frame anzeigen. |
Content-Security-Policy | Response | Steuert, von wo Seiten Skripte, Stile und Bilder laden dürfen. Eine strenge Richtlinie kann Seiten beschädigen, testen Sie sie daher. |
Cache-Control | Response | no-store verhindert, dass Browser und Proxys Antworten zwischenspeichern. |
X-Robots-Tag | Response | Bittet 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.
-
„Pfad umschreiben?“ auf Ja stellen #
Der Dialog Pfad umschreiben öffnet sich.
-
Den hinzuzufügenden Pfad eingeben #
Geben Sie ihn unter Hinzuzufügender Pfad ein, zum Beispiel
/apioder/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. -
Speichern #
Wählen Sie Speichern.
Mit /api als Pfad:
| Besucher öffnet | Ihr 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.
| Element | Werte |
|---|---|
| Timeout | Eine ganze Zahl von 1 bis 600 Sekunden. Leer lassen für den Server-Standard. |
| Vorgaben | Server-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.