コンテンツへスキップ
Localtonet Localtonet ダッシュボード

GitLabでシングルサインオン

残高が必要 HTTP トンネル

このページのヘルプ
このページの内容 4セクション
  1. 始める前に
  2. 手順
  3. GitLab で OAuth アプリケーションを作成する
  4. Localtonetにプロバイダーを追加する
  5. トンネルでオンにする
  6. 動作を確認する
  7. トラブルシューティング
  8. 関連ページ

訪問者が HTTP トンネルを開く前に、GitLab アカウントでサインインしてもらえるようにします。GitLab.com とセルフマネージドの GitLab インスタンスの両方で使えます。GitLab で OAuth アプリケーションを作成し、Localtonet にプロバイダーとして追加してから、トンネルでオンにします。

始める前に #

  • HTTP トンネルと、アカウントの残高。シングルサインオンの概要をご覧ください。
  • GitLab.com または独自のインスタンスにある GitLab アカウント。
  • セルフマネージドのインスタンスの場合: そのアドレスにインターネットから到達できる必要があります。訪問者のブラウザーがそのサインインページを開き、Localtonet のサインインホストがそのトークンエンドポイントとユーザーエンドポイントを直接呼び出します。

手順 #

  1. 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 URIhttp://auth.localtonet.com/auth/callback
    Confidential選択したままにします。
    Scopesread_user

    GitLab に Application ID と Secret が表示されます。どちらもすぐにコピーしてください。GitLab がシークレットを表示するのは、アプリケーションの作成直後だけです。

    read_user スコープは、/api/v4/user エンドポイントを通じて、サインインしたユーザーのプロフィールへの読み取りアクセスを与えます。これは Localtonet が入力するユーザー情報エンドポイントです。サインインが要求するスコープはこれだけなので、アプリケーションに他のスコープは必要ありません。

  2. Localtonetにプロバイダーを追加する #

    マイトンネル › HTTPを開き、ページ上部の SSO を選びます。SSOプロバイダーダイアログでプロバイダーを追加を選びます。

    フィールド値
    プロバイダー名任意の名前(例: Company GitLab)。トンネルの設定に表示されます。
    プロバイダーの種類GitLab。保存済みのプロバイダーの種類を変更するとクライアントIDが空になるため、クライアント ID とクライアントシークレットをもう一度入力してください。
    有効オン
    クライアントIDGitLab の 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 のホストは含まれません。

    必要に応じてメールアクセスルールを入力し、プロバイダーを保存を選びます。

  3. トンネルでオンにする #

    あなたのトンネルで、トンネルの設定を選び、SSOプロバイダーの横の管理を選びます。シングルサインオンダイアログで、ログインを必須にすると GitLab プロバイダーのスイッチをオンにして、保存を選びます。

    GitLab.com では誰でもアカウントを作成できます。ルールがないと、アドレスを知っている GitLab.com のユーザー全員がトンネルを開けます。トンネルのログインできるユーザー、またはプロバイダーの許可するメールドメインを入力してください。各リストについては、概要で説明しています。

  4. 動作を確認する #

    プライベートブラウザーウィンドウでトンネルの 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 のボタンがない

プロバイダーがこのトンネルでオンになっていないか、無効に設定されています。両方を確認してください。

サポート