> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# アプリに GitHub ログインを追加する

> Auth0 を使用してアプリケーションに GitHub でのサインインを追加する方法を説明します。OAuth 2.0 を使用して GitHub のソーシャル接続を構成し、ユーザーが GitHub アカウントで認証できるようにします。

Auth0 は GitHub でのサインインをサポートしており、ユーザーは <Tooltip tip="OAuth 2.0: 認可のプロトコルとワークフローを定義する認可フレームワーク。" cta="用語集を見る" href="/ja/docs/glossary?term=OAuth+2.0">OAuth 2.0</Tooltip> を通じて GitHub アカウントで認証できます。GitHub をソーシャルログインのオプションとして追加すると、開発者や技術系ユーザーに、すばやく使い慣れたサインイン体験を提供できます。

この接続を設定するには、GitHub で OAuth アプリケーションを登録し、その後、GitHub から提供された認証情報を使用して Auth0 Dashboard で接続を構成します。

<Card title="始める前に">
  GitHub をソーシャル接続として構成する前に、次のものが必要です。

  1. [Auth0 アカウント](https://auth0.com/signup)。お持ちでない場合は、無料でサインアップできます。
  2. [GitHub アカウント](https://github.com/signup)。
  3. [Auth0 Dashboard](https://manage.auth0.com/#/applications) に登録済みのアプリケーション。
</Card>

<div id="configure-github">
  ## GitHub を設定する
</div>

接続の確立に必要な認証情報を生成するため、GitHub で OAuth アプリケーションを作成します。

<Steps>
  <Step title="GitHub の Developer Settings を開く">
    GitHub アカウントにログインします。右上のプロフィール写真を選択し、**Settings** を選択します。左側のサイドバーで **Developer settings** を選択し、次に **OAuth Apps** を選択します。
  </Step>

  <Step title="新しい OAuth アプリケーションを登録する">
    **New OAuth App** を選択します。まだアプリケーションを作成したことがない場合は、**Register a new application** を選択します。

    次のフィールドに入力します。

    | **Field**                      | **Value**                                              |
    | ------------------------------ | ------------------------------------------------------ |
    | **Application name**           | ユーザーが認識し、信頼できる名前。例: `My App (Auth0)`                   |
    | **Homepage URL**               | アプリケーションのホームページの完全な URL。例: `https://myapp.example.com` |
    | **Application description**    | (任意) アプリケーションのすべてのユーザーに表示される説明                         |
    | **Authorization callback URL** | `https://YOUR_AUTH0_DOMAIN/login/callback`             |

    `YOUR_AUTH0_DOMAIN` は、Auth0 テナントのドメインに置き換えます。この値は、[Auth0 Dashboard > Applications > Applications](https://manage.auth0.com/#/applications) の **Settings** タブで確認できます。

    アプリケーションでデバイスベースの認可が必要でない限り、**Enable Device Flow** はオフのままで問題ありません。

    **Register application** を選択します。
  </Step>

  <Step title="クライアントID と クライアントシークレットをコピーする">
    登録後、GitHub にアプリケーションの詳細ページが表示されます。**Client ID** の値をコピーします。

    **Generate a new client secret** を選択してシークレットを作成します。生成された値はすぐにコピーしてください。

    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      GitHub では、Client Secret は一度しか表示されません。ページを離れる前に、安全な場所に保管してください。失った場合は、新しいものを生成する必要があります。
    </Callout>
  </Step>
</Steps>

<div id="configure-auth0">
  ## Auth0 を設定する
</div>

GitHub 接続を Auth0 テナントに追加し、前のセクションで取得した認証情報を入力します。

<Steps>
  <Step title="GitHub 接続を作成する">
    [Auth0 Dashboard > Authentication > Social](https://manage.auth0.com/#/social) に移動し、**Create Connection** を選択します。プロバイダーの一覧から **GitHub** を選択します。
  </Step>

  <Step title="接続の用途を選択する">
    **Purpose** で、この接続の用途を指定します。ログイン、接続済みアカウント、またはその両方を選択できます。
  </Step>

  <Step title="GitHub の認証情報を入力する">
    **General** で、GitHub からコピーした **Client ID** と **Client Secret** を入力します。
  </Step>

  <Step title="権限を選択する">
    **Permissions** で、アプリケーションに必要な権限を選択します。ほとんどのアプリケーションでは、ユーザーのメールアドレスには **Email address**、ユーザープロファイル情報には **Read user** が必要です。
  </Step>

  <Step title="接続を保存して有効にする">
    **Create** を選択して接続を保存します。

    **Applications** タブを選択し、GitHub ログインを使用するアプリケーションに対して接続を有効にします。
  </Step>
</Steps>

<div id="test-the-connection">
  ## 接続をテストする
</div>

本番環境にデプロイする前に、GitHub 接続が正しく機能することを確認します。

1. [Auth0 Dashboard > Authentication > Social](https://manage.auth0.com/#/social) に移動します。
2. 一覧から GitHub 接続を選択します。
3. **Try Connection** を選択します。
4. 求められたら、GitHub アカウントで認証します。
5. Auth0 から、ユーザーの GitHub username とメールアドレスを含むユーザープロファイルデータが返されることを確認します。

<div id="keep-reading">
  ## 関連情報
</div>

* [アプリに Google ログインを追加する](/ja/docs/authenticate/identity-providers/social-identity-providers/google)
* [Auth0 Developer Keys を使用してソーシャル接続をテストする](/ja/docs/authenticate/identity-providers/social-identity-providers/devkeys)
* [カスタムソーシャル接続を作成する](/ja/docs/authenticate/identity-providers/social-identity-providers/oauth2)