HTTPトンネルのシングルサインオン
残高が必要 HTTPトンネル
このページの内容 10セクション
シングルサインオン(SSO)は、HTTPトンネルの前にログインページを置く機能です。訪問者は、リクエストがサービスに届く前に、Google、GitHub、Microsoft、GitLabなどお好みのIDプロバイダーか、ご自身で定義したユーザー名とパスワードでログインします。
利用する場面 #
保護しない限り、HTTPトンネルはアドレスを知っている人なら誰でも開けます。管理パネル、ダッシュボード、社内ツール、ステージングサイトなど、ブラウザーでトンネルを開く人を限定したい場合に、SSOは適した保護手段です。サービス側を変更する必要はなく、サービスにパスワードが渡ることもありません。
SSOはブラウザー向けの仕組みです。ログインCookieを持たないリクエストはログインページにリダイレクトされるため、スクリプト、Webhook、APIクライアントは通過できません。その場合は、一部のパスだけを保護する(ログインパスを参照)か、アクセス制御のオプションを使ってください。
仕組み #
- 訪問者がトンネルのURLを開きます。HTTPのリクエストは、最初にHTTPSへリダイレクトされます。
- 訪問者はまだログインしていないため、Localtonetサーバーはブラウザーを
auth.localtonet.comのログインページにリダイレクトします。このページには見出しSign in to continueが表示され、このトンネルでオンにしたプロバイダーが並びます。 - 訪問者はプロバイダーを選び、そこでログインします。ユーザー名とパスワードのプロバイダーでは、フォームがログインページ上に表示されます。
- Localtonetはアクセスルールを確認し、訪問者を元のアドレスに戻します。ログイン状態は、トンネルのホスト名用のCookieに保存されます。これはブラウザーセッションCookieで、HTTPS経由でのみ送信されます。
- 以降のリクエストは、通常どおりサービスに転送されます。ログインの有効期限が切れると、訪問者は再びログインページに送られます。
ログインしたもののルールで許可されていない訪問者には、403 - Access Deniedと「You do not have permission to access this tunnel.」というテキストが表示されます。
/.well-known 配下のパスは、ログインの対象になりません。
始める前に #
- HTTPトンネル。HTTP / HTTPSを参照してください。
- アカウントの残高。残高がないと、プロバイダーの保存やログインのオン切り替えが「この機能を利用するには残高の購入が必要です。」というメッセージで失敗します。プランと残高と料金を参照してください。
- 外部プロバイダーを使う場合:OAuthアプリケーションを登録できる、そのプロバイダーのアカウント。
SSOは個人用ダッシュボードで設定します。チームのトンネルでは、SSOボタンとSSOプロバイダー設定は表示されません。
プロバイダー #
よく使われる選択肢については、次のガイドで手順を順に説明しています。
ダッシュボードのプロバイダーの種類リストには、Username-Password、Google、GitHub、Microsoft、OpenID Connect、Discord、Twitter (X)、Custom、Facebook、Apple、LinkedIn、GitLab、Slack、Spotify、Twitch、Reddit、Bitbucket、Amazon、Yahooが含まれます。Username-PasswordとCustomを除くすべての種類では、エンドポイントが自動的に入力されます。OpenID Connectで入力されるアドレスは例であり、お使いのプロバイダーのエンドポイントに置き換えてください。
設定する #
設定は2つの部分に分かれます。まずプロバイダーを1回追加すると、すべてのHTTPトンネルで使えるようになります。その後、保護したいトンネルごとにそのプロバイダーをオンにします。保存しただけのプロバイダーは、トンネルで使うまで何も保護しません。
-
プロバイダーを追加する #
マイトンネル › HTTPを開き、ページ上部のSSOを選択します(ツールチップはSSOプロバイダー設定)。SSOプロバイダーダイアログが開きます。プロバイダーを追加を選択してフォームに入力し、プロバイダーを保存を選択します。プロバイダーは1つずつ保存されます。
項目 内容 備考 プロバイダー名 トンネル設定でこのプロバイダーを識別するための名前。 必須です。例: Company Google。プロバイダーの種類 ログイン方法。 新しいプロバイダーの初期値はGoogleです。保存済みのプロバイダーの種類を変更するとクライアントIDが空になるため、クライアントIDとクライアントシークレットを入力し直してください。 有効 プロバイダーをトンネルで使えるようにします。 プロバイダーを無効に切り替えて保存すると、そのプロバイダーを使っていたすべてのトンネルでもオフになります。 クライアントID プロバイダーに登録したアプリケーションのID。 Username-PasswordとCustomを除くすべての種類で必須です。 クライアントシークレット そのアプリケーションのシークレット。 保存後は表示されません。後で空欄のままにすると、保存済みのシークレットが維持されます。 エンドポイントとコールバック 認可エンドポイント、トークンエンドポイント、ユーザー情報エンドポイント、コールバックパス。 標準的なプロバイダーでは自動的に入力されます。ガイドで指示されている場合にのみ変更してください。 メールアクセスルール 許可するメールドメイン、ブロックするメールドメイン、ブロックするメールアドレス。 任意です。アクセスルールを参照してください。 ログインユーザー ユーザー名とパスワード。 Username-PasswordとCustomの種類でのみ使います。 プロバイダーを削除するには、プロバイダーを削除を選択します。アカウントと、トンネルのSSO設定の両方から削除されます。
-
トンネルでオンにする #
あなたのトンネルで、トンネルの設定を選択します。トンネル設定パネルでSSOプロバイダーを探し、管理を選択します。シングルサインオンダイアログが開きます。
設定 動作 ログインを必須にする このトンネルでSSOをオンにします。ログインしていない訪問者は、まずログインページに送られます。 プロバイダー 有効なプロバイダーごとに1つのスイッチがあります。少なくとも1つをオンにしてください。複数をオンにすると、訪問者はログインページで選びます。 ログインできるユーザー このトンネル用の、任意のメールアドレス、メールドメイン、ユーザー名のリスト。 ログイン・ログアウトのパス 任意のログインパスとログアウトパス。 保存を選択します。
-
動作を確認する #
プライベートブラウジングのウィンドウでトンネルのURLを開きます。Sign in to continueページが表示され、ログイン後にサービスが表示されるはずです。
リダイレクトURI #
外部プロバイダーは、ログイン後にユーザーをどこへ送ってよいかを尋ねます。どのトンネルでも、これはトンネルのアドレスではなく、Localtonetのログインホスト上のアドレスです。次の値をそのまま登録してください。
http://auth.localtonet.com/auth/callback入力する場所は、各プロバイダーのガイドで説明しています。
| 値 | 入力先 |
|---|---|
| 上記のリダイレクトURI | プロバイダー側:Authorized redirect URIs(Google)、Authorization callback URL(GitHub)、Redirect URI(Microsoft、GitLab)。 |
コールバックパス(例:/auth/callback/google) | Localtonetのエンドポイントとコールバックの下にあります。自動的に入力されるので、そのままにしてください。 |
プロバイダーは、リダイレクトURIを登録済みの値と完全に一致するかどうかで照合します。ここに表示されているとおりにコピーしてください。
アクセスルール #
ログインは、訪問者が誰であるかを証明します。ルールは、その人がトンネルを開いてよいかどうかを決めます。ルールには2つのレベルがあり、両方が適用されます。
| 場所 | リスト | ダッシュボードの説明 |
|---|---|---|
| プロバイダー | 許可するメールドメイン | 空欄にすると、ドメインの制限はありません。ワイルドカードの扱いはプロバイダーによって異なります。 |
| プロバイダー | ブロックするメールドメイン | これらのメールドメインからのログインをブロックします。 |
| プロバイダー | ブロックするメールアドレス | これらの個別のメールアドレスをブロックします。 |
| トンネル | メールアドレス、メールドメイン、ユーザー名 | リストを空にすると、そのチェックは行われません。リストは、そのトンネルでオンにしたすべてのプロバイダーに適用されます。 |
1行に1項目を入力するか、カンマで区切ります。ドメインは @ なしで入力します(例:example.com)。
ルールを変更した後も、すでに許可された訪問者は最大5分間アクセスを維持できる場合があります。拒否された訪問者は、1分後に再度チェックされます。
ログインパスとログアウトパス #
| 設定 | 動作 | 例 |
|---|---|---|
| ログインパス | 空の場合:トンネルのすべてのパスでログインが必要です。入力した場合:パスがいずれかの項目で始まるリクエストだけがログインを必要とします。 | /admin は /admin と /admin/users を対象とし、/administrator は対象としません。 |
| ログアウトパス | 開くと、このトンネルのログイン状態が解除され、訪問者はトンネルのスタートページか、returnUrl クエリ値で指定されたアドレスに送られます。 | /sso/logout |
パスはスラッシュで始めます。大文字と小文字は区別されません。
ログインパスのリストを入力すると、それ以外はすべて開放されます。リストに /admin がある場合、保護されるのは /admin だけで、ほかのパスはログインなしでアクセスできます。トンネル全体を保護するには、リストを空のままにしてください。
ログアウトパスは、トンネルからのログアウトだけを行います。Google、GitHub、その他のIDプロバイダーからはログアウトされません。
トラブルシューティング #
「この機能を利用するには残高の購入が必要です。」
SSOには残高が必要です。残高を追加してから、もう一度保存してください。残高がなくても、ダイアログを開いてログインを必須にするをオフにすることはできます。
「ログインをオンにする前にプロバイダーを追加してください。」
有効なプロバイダーがまだありません。ダイアログでプロバイダーを追加を選択するか、HTTPページ上部のSSOボタンを使ってください。
「少なくとも1つのプロバイダーをオンにするか、ログインをオフにしてください。」
ログインを必須にするがオンですが、プロバイダーのスイッチがどれもオンになっていません。無効に設定したプロバイダーはそのトンネルでオフになり、一覧にも表示されなくなります。
ログインページに「No authentication providers are currently configured for this tunnel.」と表示される
ログインは必須ですが、このトンネルでオンになっているプロバイダーがありません。トンネルのSSOプロバイダー › 管理を開いて、いずれかをオンにしてください。
ログインを求められずにトンネルが開く
ログインを必須にするがオンで、保存されていることを確認してください。ログインパスを入力している場合は、そのパスだけが保護されます。また、プライベートウィンドウでも試してください。お使いのブラウザーが、すでにログインした状態のままになっている可能性があります。
ログイン後に「403 - Access Denied」が表示される
ログインはできましたが、ルールによってそのアカウントが拒否されました。プロバイダーのメールアクセスルールと、トンネルのログインできるユーザーのリストを確認してください。ルールを修正したら、1分待ってから再読み込みしてください。
WebhookやAPIクライアントが、応答ではなくリダイレクトを受け取る
ログインCookieのないリクエストは、ログインページにリダイレクトされます。ログインパスには人が見るページだけを指定するか、機械からのトラフィック用に別のトンネルを使ってください。
自動化 #
プロバイダーとトンネルのSSO設定は、/api/v2/sso-providers 配下のAPIや、MCPサーバーからも管理できます。