GitHubでのシングルサインオン
残高が必要 HTTPトンネル
このページの内容 4セクション
訪問者が、HTTPトンネルを開く前に、GitHubアカウントでログインするようにします。GitHubでOAuthアプリを登録し、Localtonetにプロバイダーとして追加してから、トンネルでオンにします。
始める前に #
- HTTPトンネルと、アカウントの残高。シングルサインオンの概要をご覧ください。
- GitHubアカウント。組織用にアプリを登録する場合は、その組織の設定にアクセスできる必要があります。
手順 #
-
GitHubでOAuthアプリを登録する #
GitHubの公式ガイドはCreating an OAuth appです。要点は次のとおりです。
- GitHubで、プロフィール画像の下のメニューを開き、Settings、Developer settings、OAuth appsの順に選択します。
- New OAuth Appを選択します。まだアプリがない場合、ボタンはRegister a new applicationと表示されます。
- 下の値でフォームに入力し、Register applicationを選択します。
- 新しいアプリのページでClient IDをコピーし、Generate a new client secretを選択して、シークレットをすぐにコピーします。
GitHubの項目 値 Application name 訪問者が見てわかる名前。GitHubが訪問者に認可を求めるときに表示されます。 Homepage URL アプリを説明するWebアドレス(例:ご自身のウェブサイト)。 Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow オフのままにします。 GitHub側でスコープを選択する必要はありません。スコープは、ログインのリクエストで指定されます:
read:userとuser:email。訪問者が初めてログインするとき、GitHubが承認を求めます。 -
Localtonetにプロバイダーを追加する #
マイトンネル › HTTPを開き、ページ上部のSSOを選択します。SSOプロバイダーダイアログで、プロバイダーを追加を選択します。
項目 値 プロバイダー名 任意の名前(例: GitHub)。トンネル設定に表示されます。プロバイダーの種類 GitHub。保存済みのプロバイダーの種類を変更するとクライアントIDが空になるため、クライアントIDとクライアントシークレットを再入力してください。 有効 オン クライアントID GitHubのクライアントIDです。 クライアントシークレット GitHubのクライアントシークレットです。保存後は表示されません。 エンドポイントとコールバックには、GitHubの標準のアドレスが自動で入力されています。そのままにしてください。
項目 入力済みの値 認可エンドポイント https://github.com/login/oauth/authorizeトークンエンドポイント https://github.com/login/oauth/access_tokenユーザー情報エンドポイント https://api.github.com/userコールバックパス /auth/callback/github必要に応じてメールアクセスルールを入力し、プロバイダーを保存を選択します。
-
トンネルでオンにする #
あなたのトンネルで、トンネルの設定を選択し、SSOプロバイダーの横の管理を選択します。シングルサインオンダイアログで、ログインを必須にすると、GitHubプロバイダーのスイッチをオンにします。保存を選択します。
GitHubアカウントは誰でも作成できます。ルールがなければ、アドレスを知っているGitHubユーザーなら誰でもトンネルを開けます。トンネルのログインできるユーザー、またはプロバイダーの許可するメールドメインを設定してください。これらの一覧については、概要で説明しています。
-
動作を確認する #
プライベートブラウザーウィンドウでトンネルの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のボタンがない
このトンネルでプロバイダーがオンになっていないか、非アクティブに設定されています。両方を確認してください。