Auth0

Étape 1 : Créer une application SAML dans Auth0

1. Connectez-vous à votre Auth0 Dashboard.
2. Accédez à Applications > Applications.
3. Cliquez sur Create Application.
4. Saisissez un nom d'application (par ex. LibreChat) et sélectionnez Regular Web Application.
5. Cliquez sur Create.

Étape 2 : Configurer l'extension SAML

1. Ouvrez l'application nouvellement créée dans Auth0.
2. Allez dans l'onglet Addons.
3. Cliquez sur le curseur pour activer la SAML2 Web App.
4. Cliquez sur le panneau SAML2 Web App.
5. Configurez les paramètres suivants :
   • URL de rappel de l'application : Définissez ceci sur votre URL de rappel SAML LibreChat : https://YOUR_DOMAIN/oauth/saml/callback
   • Paramètres (Format JSON) : Utilisez la configuration suivante :

     {
         "mappings": {
             "email": "email",
             "name": "username"
         }
     }

     note

     Si votre application nécessite des attributs supplémentaires tels que given_name, family_name, username ou picture, assurez-vous que ces mappages sont correctement configurés dans les paramètres SAML de Auth0.

6. Cliquez sur Save.

Étape 3 : Obtenir les métadonnées SAML d'Auth0

1. Une fois SAML activé, retournez dans les paramètres de la SAML2 Web App.
2. Allez dans l'onglet Usage.
3. Cliquez sur Identity Provider Certificate: Download Atuh0 certificate.
4. Utilisez le Issuer pour SAML_ISSUER
5. Utilisez l' Identity Provider Login URL pour SAML_ENTRY_POINT.
6. Copiez le fichier de certificat téléchargé dans votre dossier de projet

Étape 4 : Configurer LibreChat avec SAML

Ouvrez le fichier .env dans votre dossier de projet et ajoutez les variables suivantes :

SAML_ENTRY_POINT=https://dev-xxxxx.us.auth0.com/samlp/aaaaaa
SAML_ISSUER=urn:dev-xxxxx.us.auth0.com
SAML_CERT=dev-xxxxx.pem
SAML_CALLBACK_URL=/oauth/saml/callback
SAML_SESSION_SECRET=[JustGenerateARandomSessionSecret]

# Attribute mappings (optional)
SAML_EMAIL_CLAIM=
SAML_USERNAME_CLAIM=
SAML_GIVEN_NAME_CLAIM=
SAML_FAMILY_NAME_CLAIM=
SAML_PICTURE_CLAIM=
SAML_NAME_CLAIM=

# Logint buttion settings (optional)
SAML_BUTTON_LABEL=
SAML_IMAGE_URL=

# Whether the SAML Response should be signed.
# - If "true", the entire `SAML Response` will be signed.
# - If "false" or unset, only the `SAML Assertion` will be signed (default behavior).
# SAML_USE_AUTHN_RESPONSE_SIGNED=