開始する前に
GitHub をソーシャル接続として設定する前に、次のものが必要です。
- Auth0 アカウント。まだお持ちでない場合は、無料で登録できます。
- GitHub アカウント。
- Auth0 Dashboard に登録済みのアプリケーション。
GitHub を設定する
1
GitHub Developer Settings を開く
GitHub アカウントにログインします。右上のプロフィール写真を選択し、Settings を選択します。左側のサイドバーで Developer settings を選択し、続いて OAuth Apps を選択します。
2
新しい OAuth アプリケーションを登録する
New OAuth App を選択します。これまで一度もアプリケーションを作成したことがない場合は、Register a new application を選択します。次の項目を入力します。
YOUR_AUTH0_DOMAIN はご利用の Auth0 テナントのドメインに置き換えてください。この値は Auth0 Dashboard > Applications > Applications の Settings タブで確認できます。アプリケーションでデバイスベースの認可が必要でない限り、Enable Device Flow はオフのままでかまいません。Register application を選択します。3
Client ID と Client Secret をコピーする
登録後、GitHub にアプリケーションの詳細ページが表示されます。Client ID の値をコピーします。Generate a new client secret を選択してシークレットを作成します。生成された値はすぐにコピーしてください。
GitHub では Client Secret は一度しか表示されません。ページを離れる前に、安全な場所に保管してください。紛失した場合は、新しく生成する必要があります。
Auth0 を設定する
1
GitHub 接続を作成する
Auth0 Dashboard > Authentication > Social に移動し、Create Connection を選択します。プロバイダーの一覧から GitHub を選択します。
2
接続の用途を選択する
Purpose で、この接続の用途を指定します。ログイン、接続済みアカウント、またはその両方に使用できます。
3
GitHub の資格情報を入力する
General で、GitHub からコピーした Client ID と Client Secret を入力します。
4
権限を選択する
Permissions で、アプリケーションに必要な権限を選択します。ほとんどのアプリケーションでは、ユーザーのメールアドレスには Email address、プロファイル情報には Read user が必要です。
5
接続を保存して有効にする
接続を保存するには Create を選択します。Applications タブを選択し、GitHub ログインを提供するアプリケーションでこの接続を有効にします。
接続をテストする
- Auth0 Dashboard > Authentication > Social に移動します。
- 一覧から GitHub 接続を選択します。
- Try Connection を選択します。
- 求められたら、GitHub アカウントで認証します。
- ユーザーの GitHub ユーザー名やメールアドレスを含むユーザープロファイルデータが Auth0 から返されることを確認します。