ヘッダー、パスの書き換え、HTTPオプション
このページの内容 11セクション
HTTPリクエストとレスポンスがトンネルを通る方法を変更します。固定ヘッダーの追加、サービスが受け取るHostヘッダーの設定、すべてのリクエストの前へのパスの追加、リクエストタイムアウトの設定、パブリックアドレスでのHTTPSのみ・HTTP/3の選択ができます。
始める前に #
- HTTPトンネル。HTTP / HTTPSを参照してください。
- 設定はトンネルの設定パネルにあります。マイトンネル › HTTPを開き、トンネルの行にある設定を選択します。
| 設定 | HTTP | MCPゲートウェイ |
|---|---|---|
| ヘッダー | はい | – |
| パスの書き換え | はい | – |
| HTTPタイムアウト | はい | はい |
| HTTPSのみ | はい | はい |
| HTTP/3を有効化 | はい | はい |
これらの設定を変更しても、トンネルは再起動されません。保存した時点で、実行中のトンネルに変更が適用されます。
HTTPヘッダー #
ヘッダー › 管理を開くと、HTTPヘッダーダイアログが表示されます。トンネルを通るトラフィックに固定ヘッダーを追加します。
- リクエストヘッダーは、すべてのリクエストでローカルサービスに届きます。
- レスポンスヘッダーは、すべてのレスポンスで訪問者に届きます。
値は入力したとおりにそのまま送信されます。
ヘッダーを追加する #
-
ヘッダーの種類を選ぶ #
ダイアログ上部でリクエストヘッダーまたはレスポンスヘッダーを選択します。各タブには、含まれるヘッダーの数が表示されます。
-
ヘッダーを追加する #
ヘッダーを追加を選択して名前と値を入力するか、候補の下の名前を選択して、適切な初期値の入った行を追加します。ダイアログが把握しているヘッダーでは、行の情報アイコンにその働きが説明されます。
-
保存する #
保存を選択します。ヘッダーを削除するには、その行の削除ボタンを選択してから保存を選択します。
定型セット #
レスポンスヘッダータブでは、定型セットを使うと、複数のヘッダーを一度に追加できます。追加後、ダイアログに「NAMEを追加しました。値を確認してから保存してください。」と表示されます。セットは、すでに一覧にあるヘッダーについては、その値が空の場合にのみ値を入力します。
| セット | 追加されるヘッダー | 用途 |
|---|---|---|
| CORSを許可 |
| 他のサイト上のWebアプリが、このトンネルを呼び出せるようにします。 |
| セキュリティヘッダー |
| HSTS、nosniff、フレーム保護、リファラーポリシー。 |
| キャッシュを無効化 | Cache-Control: no-store | ブラウザーやプロキシがレスポンスをキャッシュしないようにします。 |
| 検索エンジンから非表示 | X-Robots-Tag: noindex, nofollow | 検索エンジンに、このアドレスを掲載しないよう依頼します。 |
候補ヘッダー #
| ヘッダー | タイプ | ダイアログでの説明 |
|---|---|---|
Host | リクエスト | サービスは、トンネルのアドレスの代わりにこのホスト名を受け取ります。ローカルのWebサーバーがホスト名でサイトを振り分ける場合に便利です。 |
Authorization | リクエスト | すべてのリクエストで、同じ認証情報をサービスに送ります。 |
X-API-Key | リクエスト | ヘッダーでキーを受け取ることを想定しているサービス向けの、固定キーです。 |
X-Forwarded-Proto | リクエスト | アプリに訪問者がHTTPSを使っていることを伝え、https:// のリンクとリダイレクトが生成されるようにします。 |
Origin | リクエスト | サービスによっては、既知のオリジンからのリクエストしか受け付けません。 |
Access-Control-Allow-Origin | レスポンス | ブラウザーからこのトンネルを呼び出せるWebサイト。* は任意のサイトを許可します。 |
Access-Control-Allow-Credentials | レスポンス | ブラウザーがCookieを送信できるようにします。Access-Control-Allow-Origin: * とは併用できません。 |
Strict-Transport-Security | レスポンス | このアドレスでは常にHTTPSを使うよう、ブラウザーに指示します。 |
X-Frame-Options | レスポンス | 他のサイトが、ページをフレーム内に表示するのを防ぎます。 |
Content-Security-Policy | レスポンス | ページがスクリプト、スタイル、画像を読み込める場所を制御します。厳しいポリシーはページを壊すことがあるため、必ずテストしてください。 |
Cache-Control | レスポンス | no-store は、ブラウザーやプロキシがレスポンスをキャッシュしないようにします。 |
X-Robots-Tag | レスポンス | 検索エンジンに、このアドレスを掲載しないよう依頼します。 |
候補には、リクエスト用の User-Agent、Accept-Language、Cache-Control と、レスポンス用の Access-Control-Allow-Methods、Access-Control-Allow-Headers、X-Content-Type-Options、Referrer-Policy、Permissions-Policy も含まれます。それ以外のヘッダー名も入力できます。
ルール #
- ヘッダー名には英字、数字、ハイフンを使用でき(例:
X-Api-Key)、最大256文字です。 - 名前は、タブごとに1回だけ使えます。同じ名前の2行目は「NAMEはすでにこの一覧にあります。」と拒否されます。
- 行には名前が必要です。空の行は、保存時に無視されます。
Hostヘッダー #
既定では、サービスはリクエストのホスト名としてトンネルのアドレスを受け取ります。別のホスト名を送るには、HTTPヘッダーダイアログでリクエストヘッダー Host を追加し、値にサービスが期待する名前(例:localhost や shop.internal)を設定します。
ローカルのWebサーバーがホスト名でサイトを振り分ける場合(Apacheやnginxのバーチャルホスト、ホストバインディングを使うIIS、localhost にしか応答しない開発サーバーなど)に使用します。完全な例は、仮想ホストを参照してください。
パスの書き換え #
パスの書き換えは、すべてのリクエストがローカルサービスに届く前に、その先頭にパスを追加します。訪問者は引き続き短いアドレスを使います。
-
「パスの書き換え」を「はい」に切り替える #
パスの書き換えダイアログが開きます。
-
追加するパスを入力する #
追加するパスに入力します(例:
/apiや/app/v2)。またはよく使うパスから1つ選びます。パスはスラッシュで始めます。スラッシュを省略した場合は、自動的に追加されます。例ボックスには、サンプルのリクエストに対する結果が表示されます。 -
保存する #
保存を選択します。
パスが /api の場合:
| 訪問者が開くパス | サービスが受け取るパス |
|---|---|
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7 | /api/orders?id=7 |
1つのトンネルに設定できるパスは1つで、200文字までです。スペースを含めることはできず、/ だけにもできません。削除するには、パスの書き換えをいいえに切り替え、パスの書き換えをオフにしますか?で確定します。保存されていたパスが削除され、リクエストは元のパスのままサービスに届きます。
HTTPタイムアウト #
HTTPタイムアウト › 管理を開くと、リクエストタイムアウトダイアログが表示されます。タイムアウトとは、トンネルがサービスからのリクエストへの応答を待つ時間です。その時間を過ぎると、訪問者にはタイムアウトエラーが返されます。
| 項目 | 値 |
|---|---|
| タイムアウト | 1〜600秒の整数。空にするとサーバーのデフォルトになります。 |
| プリセット | サーバーのデフォルト、30秒、1分、2分、5分、10分 |
時間のかかるレポート、大きなアップロード、ロングポーリングなどでは、タイムアウトを長くします。標準値に戻すにはサーバーのデフォルトを選びます。
HTTPSのみ #
HTTPSのみをはいに切り替え、HTTPSのみをオンにしますか?で確定すると、パブリックURLがHTTPSのみで提供されます。ログインや個人データを扱うものには必ず使い、誰も平文のHTTPでトンネルにアクセスできないようにしてください。
HTTP/3を有効化 #
HTTP/3を有効化をはいに切り替えると、クライアントがHTTP/3でパブリックURLに接続できるようになります。HTTP/3に対応していないクライアントは、従来のHTTPバージョンを引き続き使います。
例 #
他のサイトのWebアプリからAPIを呼び出せるようにする #
フロントエンドが https://app.example.com で動作し、トンネルの先のAPIを呼び出しているとします。ヘッダー › 管理を開き、レスポンスヘッダーに移動してCORSを許可を選択します。そのサイトだけにAPIの呼び出しを許可する場合は、Access-Control-Allow-Origin の * を https://app.example.com に置き換え、保存を選択します。
サブパス配下にあるアプリを公開する #
アプリケーションサーバーが /app/v2 配下でアプリを提供していて、訪問者にはシンプルなトンネルのアドレスを開かせたいとします。パスの書き換えをオンにして /app/v2 を入力します。訪問者が /login を開くと、サービス上では /app/v2/login に届きます。
APIでの同じ設定 #
これらの設定は、/api/v2/tunnels/<TUNNEL_ID>/ 配下の headers、host-header、path-rewrite、http-timeout、https-only、http3 でも利用できます。APIを参照してください。
トラブルシューティング #
「ヘッダー名には英字、数字、ハイフンを使えます(例:X-Api-Key)。」
名前に、スペースやコロンなど、ヘッダー名に使えない文字が含まれています。名前には名前だけを入力し、残りは値に入力してください。
「このヘッダーの名前を入力するか、行を削除してください。」
値はあるのに名前がない行があります。名前を入力するか、行を削除してください。
「http://やホスト名を含めず、パスのみを入力してください。」
追加するパスには、完全なURLではなく、/api のようなパスを入力します。
「1~600の整数を入力するか、「サーバーのデフォルト」を選んでください。」
タイムアウトは1〜600秒の範囲で指定する必要があります。それより長くかかる処理では、先にリクエストに応答し、クライアントが後から結果を問い合わせるようにしてください。
CORSヘッダーがCookieで動作しない
Access-Control-Allow-Credentials は Access-Control-Allow-Origin: * と併用できません。Access-Control-Allow-Origin には、呼び出し元サイトの正確なオリジンを設定してください。
ローカルサービスがHTTPSを使っていて、トンネルにエラーが表示される
これはヘッダーの問題ではありません。SslStreamをオンにしてください。これは、ローカルサービス自体がHTTPSを使っていることをトンネルに伝える設定です。設定リファレンスを参照してください。