GitLabでシングルサインオン
残高が必要 HTTP トンネル
このページの内容 4セクション
訪問者が HTTP トンネルを開く前に、GitLab アカウントでサインインしてもらえるようにします。GitLab.com とセルフマネージドの GitLab インスタンスの両方で使えます。GitLab で OAuth アプリケーションを作成し、Localtonet にプロバイダーとして追加してから、トンネルでオンにします。
始める前に #
- HTTP トンネルと、アカウントの残高。シングルサインオンの概要をご覧ください。
- GitLab.com または独自のインスタンスにある GitLab アカウント。
- セルフマネージドのインスタンスの場合: そのアドレスにインターネットから到達できる必要があります。訪問者のブラウザーがそのサインインページを開き、Localtonet のサインインホストがそのトークンエンドポイントとユーザーエンドポイントを直接呼び出します。
手順 #
-
GitLab で OAuth アプリケーションを作成する #
GitLab 自体のガイドは Configure GitLab as an OAuth 2.0 authentication identity provider です。アプリケーションは、ユーザー、グループ、インスタンス全体のいずれにも所属させられます。
所有者 作成する場所 ご自身のユーザー アバターを選び、Edit profile、Access › Applications、Add new application の順に選びます。 グループ グループを開き、Settings › Applications を選びます。 インスタンス(セルフマネージド、管理者のみ) Admin › Applications、New application。 フォームに入力して Save application を選びます。
GitLab のフィールド 値 Name 訪問者が見て分かる名前。GitLab が認可を求める際に表示されます。 Redirect URI http://auth.localtonet.com/auth/callbackConfidential 選択したままにします。 Scopes read_userGitLab に Application ID と Secret が表示されます。どちらもすぐにコピーしてください。GitLab がシークレットを表示するのは、アプリケーションの作成直後だけです。
read_userスコープは、/api/v4/userエンドポイントを通じて、サインインしたユーザーのプロフィールへの読み取りアクセスを与えます。これは Localtonet が入力するユーザー情報エンドポイントです。サインインが要求するスコープはこれだけなので、アプリケーションに他のスコープは必要ありません。 -
Localtonetにプロバイダーを追加する #
マイトンネル › HTTPを開き、ページ上部の SSO を選びます。SSOプロバイダーダイアログでプロバイダーを追加を選びます。
フィールド 値 プロバイダー名 任意の名前(例: Company GitLab)。トンネルの設定に表示されます。プロバイダーの種類 GitLab。保存済みのプロバイダーの種類を変更するとクライアントIDが空になるため、クライアント ID とクライアントシークレットをもう一度入力してください。 有効 オン クライアントID GitLab の Application ID。 クライアントシークレット GitLab の Secret。保存後は表示されません。 エンドポイントとコールバックを開きます。GitLab.com のアドレスは自動で入力されます。セルフマネージドのインスタンスの場合は、最初の 3 つのフィールドの
gitlab.comを、お使いのインスタンスのホスト名に置き換えてください。GitLab.com
フィールド 入力される値 認可エンドポイント https://gitlab.com/oauth/authorizeトークンエンドポイント https://gitlab.com/oauth/tokenユーザー情報エンドポイント https://gitlab.com/api/v4/userコールバックパス /auth/callback/gitlabセルフマネージド
フィールド 入力する値 認可エンドポイント https://<YOUR_GITLAB_HOST>/oauth/authorizeトークンエンドポイント https://<YOUR_GITLAB_HOST>/oauth/tokenユーザー情報エンドポイント https://<YOUR_GITLAB_HOST>/api/v4/userコールバックパス /auth/callback/gitlab(変更なし)GitLab アプリケーションの Redirect URI は、手順 1 の Localtonet のアドレスのままです。GitLab のホストは含まれません。
必要に応じてメールアクセスルールを入力し、プロバイダーを保存を選びます。
-
トンネルでオンにする #
あなたのトンネルで、トンネルの設定を選び、SSOプロバイダーの横の管理を選びます。シングルサインオンダイアログで、ログインを必須にすると GitLab プロバイダーのスイッチをオンにして、保存を選びます。
GitLab.com では誰でもアカウントを作成できます。ルールがないと、アドレスを知っている GitLab.com のユーザー全員がトンネルを開けます。トンネルのログインできるユーザー、またはプロバイダーの許可するメールドメインを入力してください。各リストについては、概要で説明しています。
-
動作を確認する #
プライベートブラウザーウィンドウでトンネルの URL を開きます。Localtonet に Sign in to continue と、お使いのプロバイダーのボタンが表示されます。初回は GitLab がアプリケーションの認可を求めます。その後はトンネルに戻り、サービスが読み込まれます。
トラブルシューティング #
GitLab が、含まれているリダイレクト URI は無効だと表示する
GitLab アプリケーションのどの Redirect URI も、送信されたアドレスと一致しません。アプリケーションの Redirect URI に http://auth.localtonet.com/auth/callback を、そのまま入力してください。
GitLab が、要求されたスコープが無効、不明、または不正だと表示する
要求されたスコープが GitLab アプリケーションで選択されていません。アプリケーションを編集して read_user を選択してください。
GitLab が、クライアント認証に失敗したと表示する
Localtonet に保存したクライアントIDまたはクライアントシークレットが、GitLab アプリケーションと一致していません。Application ID と Secret をもう一度貼り付けて、プロバイダーを保存を選んでください。GitLab でシークレットを更新した場合は、新しいシークレットを Localtonet に保存するまで、アプリケーションは動作しません。
セルフマネージドのインスタンスでのサインインが完了しない
3 つのエンドポイントに入力ミスがないか確認し、インスタンスがインターネットから応答することを確認してください。HTTPS を使う場合は、公開クライアントが信頼する証明書が必要です。ネットワーク内からしか到達できないインスタンスは使えません。
GitLab のサインインに成功した後に「403 - Access Denied」
Localtonet のルールがそのアカウントを拒否しました。プロバイダーのメールアクセスルールと、トンネルのログインできるユーザーを確認してください。ルールを修正した後は、1 分待ってから再読み込みしてください。
サインインページに GitLab のボタンがない
プロバイダーがこのトンネルでオンになっていないか、無効に設定されています。両方を確認してください。