始める前に
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
クライアントID と クライアントシークレットをコピーする
登録後、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 アカウントで認証します。
- Auth0 から、ユーザーの GitHub username とメールアドレスを含むユーザープロファイルデータが返されることを確認します。