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

GitHubでのシングルサインオン

残高が必要 HTTPトンネル

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

訪問者が、HTTPトンネルを開く前に、GitHubアカウントでログインするようにします。GitHubでOAuthアプリを登録し、Localtonetにプロバイダーとして追加してから、トンネルでオンにします。

始める前に #

  • HTTPトンネルと、アカウントの残高。シングルサインオンの概要をご覧ください。
  • GitHubアカウント。組織用にアプリを登録する場合は、その組織の設定にアクセスできる必要があります。

手順 #

  1. GitHubでOAuthアプリを登録する #

    GitHubの公式ガイドはCreating an OAuth appです。要点は次のとおりです。

    1. GitHubで、プロフィール画像の下のメニューを開き、Settings、Developer settings、OAuth appsの順に選択します。
    2. New OAuth Appを選択します。まだアプリがない場合、ボタンはRegister a new applicationと表示されます。
    3. 下の値でフォームに入力し、Register applicationを選択します。
    4. 新しいアプリのページでClient IDをコピーし、Generate a new client secretを選択して、シークレットをすぐにコピーします。
    GitHubの項目値
    Application name訪問者が見てわかる名前。GitHubが訪問者に認可を求めるときに表示されます。
    Homepage URLアプリを説明するWebアドレス(例:ご自身のウェブサイト)。
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device Flowオフのままにします。

    GitHub側でスコープを選択する必要はありません。スコープは、ログインのリクエストで指定されます:read:userとuser:email。訪問者が初めてログインするとき、GitHubが承認を求めます。

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

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

    項目値
    プロバイダー名任意の名前(例:GitHub)。トンネル設定に表示されます。
    プロバイダーの種類GitHub。保存済みのプロバイダーの種類を変更するとクライアントIDが空になるため、クライアントIDとクライアントシークレットを再入力してください。
    有効オン
    クライアントIDGitHubのクライアントIDです。
    クライアントシークレットGitHubのクライアントシークレットです。保存後は表示されません。

    エンドポイントとコールバックには、GitHubの標準のアドレスが自動で入力されています。そのままにしてください。

    項目入力済みの値
    認可エンドポイントhttps://github.com/login/oauth/authorize
    トークンエンドポイントhttps://github.com/login/oauth/access_token
    ユーザー情報エンドポイントhttps://api.github.com/user
    コールバックパス/auth/callback/github

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

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

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

    GitHubアカウントは誰でも作成できます。ルールがなければ、アドレスを知っているGitHubユーザーなら誰でもトンネルを開けます。トンネルのログインできるユーザー、またはプロバイダーの許可するメールドメインを設定してください。これらの一覧については、概要で説明しています。

  4. 動作を確認する #

    プライベートブラウザーウィンドウでトンネルのURLを開きます。LocaltonetにSign in to continueが表示され、プロバイダー用のボタンが表示されます。初回は、GitHubがアプリの認可を求めます。その後、トンネルに戻り、サービスが読み込まれます。

トラブルシューティング #

GitHubがリダイレクトURIの不一致を報告する

GitHubのエラーはredirect_uri_mismatchで、「The redirect_uri MUST match the registered callback URL for this application.」と表示されます。OAuthアプリのどのコールバックURLも、送信されたアドレスと一致していません。GitHubのAuthorization callback URLを、http://auth.localtonet.com/auth/callbackとまったく同じに設定してください。

アドレスが一覧にあるのに、訪問者が拒否される

GitHubユーザーがプロフィールに公開メールアドレスを設定していない場合、デフォルトのユーザー情報エンドポイント(https://api.github.com/user)はメールアドレスを返さないことがあります。訪問者に、GitHubのプロフィールで公開メールアドレスとして設定されているアドレスを確認してもらい、一覧と照合してください。

GitHubでのログインに成功した後に「403 - Access Denied」が表示される

Localtonetのルールがアカウントを拒否しました。プロバイダーのメールアクセスルールと、トンネルのログインできるユーザーを確認してください。ルールを修正したら、1分待ってから再読み込みしてください。

GitHubの認可ページの前後でログインに失敗する

Localtonetに保存したクライアントIDとクライアントシークレットを、OAuthアプリの値と照合してください。クライアントIDを貼り付け直し、GitHubで新しいクライアントシークレットを生成してプロバイダーに貼り付け、プロバイダーを保存を選択します。

ログインページにGitHubのボタンがない

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

サポート