Auth0

Passaggio 1: Creare un'applicazione SAML in Auth0

1. Accedi alla tua Auth0 Dashboard.
2. Vai su Applications > Applications.
3. Fai clic su Create Application.
4. Inserisci un Nome Applicazione (ad esempio, LibreChat) e seleziona Regular Web Application.
5. Fai clic su Create.

Passaggio 2: Configurare il componente aggiuntivo SAML

1. Apri l'applicazione appena creata in Auth0.
2. Vai alla scheda Addons.
3. Fai clic sul cursore per abilitare la SAML2 Web App.
4. Fai clic sul pannello SAML2 Web App.
5. Configura le seguenti impostazioni:
   • Application Callback URL: Impostalo sull'URL di callback SAML di LibreChat: https://YOUR_DOMAIN/oauth/saml/callback
   • Impostazioni (Formato JSON): Utilizzare la seguente configurazione:

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

     nota

     Se la tua applicazione richiede attributi aggiuntivi come given_name, family_name, username o picture, assicurati che queste mappature siano configurate correttamente nelle impostazioni SAML di Auth0.

6. Fai clic su Save.

Passaggio 3: Ottenere i metadati SAML di Auth0

1. Una volta abilitato SAML, torna alle impostazioni della SAML2 Web App.
2. Vai alla scheda Usage.
3. Fai clic su Identity Provider Certificate: Download Atuh0 certificate.
4. Usa Issuer per SAML_ISSUER
5. Utilizza l'Identity Provider Login URL per SAML_ENTRY_POINT.
6. Copia il file del certificato scaricato nella cartella del tuo progetto

Passaggio 4: Configurare LibreChat con SAML

Apri il file .env nella cartella del tuo progetto e aggiungi le seguenti variabili:

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=