Apple

前提条件

始める前に、以下のものを用意してください：

• Apple Developer Account: お持ちでない場合は、こちらから登録してください。

新しい App ID の作成

1. Apple Developer Console にログインする

• アクション:
• Apple Developer にアクセスし、Apple IDでサインインしてください。

2. Identifiers に移動する

• Certificates, Identifiers & Profiles に移動します。
• サイドバーの Identifiers をクリックします。

3. 新しいApp IDを作成する

1. "+" ボタンをクリックして、新しい識別子を追加します。
2. App IDsを選択し、Continueをクリックします。
3. Appを選択し、Continueをクリックします。
4. App IDのDescription（例: LibreChat App ID）を入力します。
5. Bundle ID（例：com.yourdomain.librechat）を設定します。
6. Continue をクリックし、次に Register をクリックします。

• 画像参照:

• 図1: 新しいApp IDの作成

• 図2: アプリ識別子の選択

4. "Sign in with Apple" を有効にする

1. App IDを作成した後、それをクリックして編集します。
2. Capabilities の下で、Sign in with Apple を見つけてチェックを入れます。
3. Save をクリックします。

• 画像参照:
• 図 3: 「Sign in with Apple」を有効にする

Services IDの作成

1. Identifiers に移動する

• Certificates, Identifiers & Profiles セクションで、Identifiers をクリックします。

2. 新しい Services ID を作成する

1. "+" ボタンをクリックします。
2. Services IDsを選択し、Continueをクリックします。
3. Description（例：LibreChat Services ID）を入力します。
4. Identifier（例: com.yourdomain.librechat.services）を入力します。
5. Continue をクリックし、次に Register をクリックします。

• 画像参照:

• 図 4: Services ID の選択

• 図 5: Services ID の作成

3. 「Appleでサインイン」を設定する

1. 新しく作成された Services ID をクリックします。
2. Capabilities の下にある Sign in with Apple の横の Configure をクリックします。
3. Domains（例: your-domain.com）および Return URLs（例: https://your-domain.com/oauth/apple/callback）を入力します。
4. Next をクリックし、続いて Register をクリックします。

• 画像参照:

• 図 6: Services ID の「Sign in with Apple」を設定する

• 図 7: Web認証設定

• 図 8: サービスID設定の編集を保存

キーの作成

1. Keys に移動する

• Certificates, Identifiers & Profiles セクションで、Keys をクリックします。

2. 新しいキーを作成する

1. "+" ボタンをクリックして、新しいキーを追加します。
2. Key Name（例：LibreChatSignInWithApple）を入力します。
3. Capabilities の下にある Sign in with Apple を選択します。
4. Configureをクリックし、作成したApp ID（例: com.yourdomain.librechat）を選択してから、Saveをクリックします。
5. Continue をクリックし、次に Register をクリックします。

• 画像参照:

• 図8: 新しいキーの作成

• 図9: App IDを使用したキーの設定

• 図 10: キーの登録

3. 秘密鍵をダウンロードする

1. キーを作成した後、Downloadをクリックします。
2. 重要: .p8 ファイルを安全に保存してください。再度ダウンロードすることはできません。
3. Key IDを控えておいてください。.envファイルで必要になります。

• 画像参照:
• 図11: 秘密鍵のダウンロード

LibreChatの設定

1. .env 設定の更新

.env ファイルに以下の Apple OAuth2 設定を追加してください：

DOMAIN_CLIENT=https://your-domain.com # use http://localhost:3080 if not using a custom domain
DOMAIN_SERVER=https://your-domain.com # use http://localhost:3080 if not using a custom domain

# Apple
APPLE_CLIENT_ID=com.yourdomain.librechat.services
APPLE_TEAM_ID=YOUR_TEAM_ID
APPLE_KEY_ID=YOUR_KEY_ID
APPLE_PRIVATE_KEY_PATH=/path/to/AuthKey.p8 # Absolute path to your downloaded .p8 file
APPLE_CALLBACK_URL=/oauth/apple/callback

注:

• com.yourdomain.librechat.services を実際の Services ID に置き換えてください。
• YOUR_TEAM_ID と YOUR_KEY_ID を、Apple Developerアカウントのそれぞれの値に置き換えてください。
• Dockerを使用している場合は、.p8 ファイルが Docker コンテナ内からアクセス可能であることを確認し、それに応じて APPLE_PRIVATE_KEY_PATH を更新してください。

2. LibreChat を再起動する

.env ファイルを更新した後、LibreChat を再起動して変更を適用してください。

• Dockerを使用している場合:

docker compose up -d

トラブルシューティング

セットアップ中に問題が発生した場合は、以下の解決策を検討してください。

• 無効なリダイレクトURI:

  • Apple Developer ConsoleのリダイレクトURI（https://your-domain.com/oauth/apple/callback）が、.envファイルで指定したもの（APPLE_CALLBACK_URL）と完全に一致していることを確認してください。

• プライベートキーの問題:

  • .p8 ファイルへのパス (APPLE_PRIVATE_KEY_PATH) が正しいことを確認してください。
  • LibreChatが.p8ファイルに対する読み取り権限を持っていることを確認してください。

• Team ID および Key ID エラー:

  • .env ファイル内の APPLE_TEAM_ID と APPLE_KEY_ID が、Apple Developer Account のものと一致していることを再確認してください。

• ドメインの検証に失敗しました:

  • 検証ファイルをドメインのルートに正しくアップロードしていることを確認してください。
  • 設定時に入力したドメイン名に誤字がないか確認してください。

• Docker 設定の問題:

  • Dockerを使用している場合は、.p8 ファイルが適切にマウントされており、APPLE_PRIVATE_KEY_PATH のパスがコンテナ内からアクセス可能であることを確認してください。

• ログの確認:

  • LibreChatのログを確認し、Apple認証に関連するエラーメッセージがないか調べてください。これにより、何が問題であるかについての具体的な洞察が得られる可能性があります。