Docs
⚙️ Configuration
Authentication
OAuth2-OIDC
Intro

Social Authentication

This section will cover how to configure OAuth2 and OpenID Connect with LibreChat

Image for Light Theme
Image for Dark Theme

OAuth2

OpenID Connect

Troubleshooting OpenID Connect

If you encounter issues with OpenID Connect authentication:

  1. Enable Header Debug Logging: Set DEBUG_OPENID_REQUESTS=true in your environment variables to log request headers in addition to URLs (with sensitive data masked). Note: Request URLs are always logged at debug level
  2. Check Redirect URIs: Ensure your callback URL matches exactly between your provider and LibreChat configuration
  3. Verify Scopes: Make sure all required scopes are properly configured
  4. Review Provider Logs: Check your identity provider’s logs for authentication errors
  5. Validate Tokens: Ensure your provider is issuing valid tokens with the expected claims
IntroApple