Panoramica

Questa sezione tratterà come configurare OAuth2 e OpenID Connect con LibreChat

OAuth2

• Apple
• Discord
• Facebook
• GitHub
• Google

OpenID Connect

• Auth0
• AWS Cognito
• Azure Entra/AD
• Keycloak
• Riutilizza i token OpenID per la sessione di accesso

Risoluzione dei problemi di OpenID Connect

Se riscontri problemi con l'autenticazione OpenID Connect:

1. Abilita il debug logging delle intestazioni: Imposta DEBUG_OPENID_REQUESTS=true nelle tue variabili d'ambiente per registrare le intestazioni delle richieste oltre agli URL (con i dati sensibili mascherati). Nota: gli URL delle richieste vengono sempre registrati al livello di debug.
2. Controlla gli URI di reindirizzamento: Assicurati che il tuo URL di callback corrisponda esattamente tra il tuo provider e la configurazione di LibreChat
3. Verifica degli ambiti (Scopes): Assicurati che tutti gli ambiti richiesti siano configurati correttamente
4. Esamina i log del provider: Controlla i log del tuo identity provider per errori di autenticazione
5. Convalida i token: Assicurati che il tuo provider stia emettendo token validi con le attestazioni (claims) previste
6. Assicurati che il nonce sia generato: Alcuni provider di identità generano il parametro url nonce se manca nella richiesta. Imposta OPENID_GENERATE_NONCE=true per forzare l'openid-client a generarlo.

Reindirizzamenti del Pannello di Amministrazione

Se l'Admin Panel è ospitato su un URL separato da LibreChat, imposta ADMIN_PANEL_URL nell'ambiente dell'API di LibreChat. Questo indica a LibreChat dove reindirizzare gli amministratori una volta completato il callback OAuth o SSO dell'amministratore.