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

# GitHub OAuthアプリ（GitHubでサインイン）

コードレビューの自動化やWebhookに使用されるGitHub Appインテグレーションとは別に、ユーザーがGitHubでKodusにサインインできるようにしたい場合に使用します。

## 前提条件

* **WEB\_DOMAIN**: フロントエンドのURL（例：`https://app.yourdomain.com`または`http://localhost:3000`）

## ステップ1：OAuthアプリの作成

1. GitHubで**Settings** > **Developer Settings** > **OAuth Apps**に移動
2. **New OAuth App**をクリック
3. 基本情報（アプリケーション名、ホームページURL）を入力

<img src="https://www.oauth.com/wp-content/uploads/2018/07/github_create_new_application-1024x717.png" alt="新しいアプリケーションフォームを表示するGitHub OAuthアプリページ" />

## ステップ2：コールバックURLの設定

**Authorization callback URL**を以下に設定します：

```
WEB_DOMAIN/api/auth/callback/github
```

URLが実際のWebドメインとスキーム（http/https）と一致していることを確認してください。

## ステップ3：.envへの認証情報の追加

アプリを作成したら、GitHubから認証情報をコピーしてKodusの環境に追加します：

```
WEB_OAUTH_GITHUB_CLIENT_ID="your_client_id_here"
WEB_OAUTH_GITHUB_CLIENT_SECRET="your_client_secret_here"
```

## 環境変数の概要

```bash theme={null}
WEB_OAUTH_GITHUB_CLIENT_ID="your_client_id_here"
WEB_OAUTH_GITHUB_CLIENT_SECRET="your_client_secret_here"
```

変更を適用するためにWebアプリケーションを再起動してください。