概要

このセクションでは、LibreChatでOAuth2およびOpenID Connectを設定する方法について説明します。

OAuth2

• Apple
• Discord
• Facebook
• GitHub
• Google

OpenID Connect

• Auth0
• AWS Cognito
• Azure Entra/AD
• Keycloak
• ログインセッションにOpenIDトークンを再利用する

OpenID Connect のトラブルシューティング

OpenID Connect認証で問題が発生した場合：

1. ヘッダーデバッグログの有効化: 環境変数に DEBUG_OPENID_REQUESTS=true を設定すると、URLに加えてリクエストヘッダーもログに記録されます（機密データはマスクされます）。なお、リクエストURLは常にデバッグレベルでログに記録されることに注意してください。
2. リダイレクトURIの確認: プロバイダー側とLibreChatの設定側で、コールバックURLが完全に一致していることを確認してください。
3. スコープの検証: 必要なすべてのスコープが適切に設定されていることを確認してください
4. プロバイダーログの確認: 認証エラーがないか、アイデンティティプロバイダーのログを確認してください
5. トークンの検証: プロバイダーが期待されるクレームを含む有効なトークンを発行していることを確認してください
6. nonce が生成されることを確認する: 一部のアイデンティティプロバイダーは、リクエスト内に nonce URL パラメーターがない場合に自動生成します。OPENID_GENERATE_NONCE=true を設定して、openid-client に強制的に生成させるようにしてください。

管理パネルへのリダイレクト

Admin PanelがLibreChatとは別のURLでホストされている場合は、LibreChat API環境でADMIN_PANEL_URLを設定してください。これは、管理者用OAuthまたはSSOのコールバック完了後に、管理者をどこへリダイレクトするかをLibreChatに指示するものです。