SAML

SAML 2.0 est un protocole standard ouvert qui permet aux utilisateurs d’accéder à plusieurs applications Web à l’aide d’un seul ensemble d’informations d’identification. Cela offre aux utilisateurs un moyen plus sûr et plus pratique d’accéder à Document360. Lorsque SAML 2.0 est activé, les utilisateurs de Document360 peuvent se connecter à la plateforme à l’aide de leurs informations d’identification existantes auprès d’un fournisseur d’identité (IdP). Document360 prend en charge la configuration de plusieurs points de terminaison d’authentification unique (SSO), ce qui permet aux comptes d’équipe et aux lecteurs de se connecter à l’aide de leur fournisseur d’identité préféré.

Fournisseurs d’identité pris en charge

Document360 prend en charge les fournisseurs d’identité (IdP) suivants :

• Okta

• Entra ID

• Google (en anglais)

• Auth0

• ADFS

• OneLogin

• Autrui

Configuration de l’authentification unique à l’aide de SAML

1. Connectez-vous à votre compte Document360 et accédez au projet de votre choix.

2. Accédez à () > Users & security >SAML/OpenID.

3. Cliquez sur Créer une authentification unique.

4. Sélectionnez un fournisseur d’identité sur la page Choisir votre fournisseur d’identité (IdP ).

   

5. Sélectionnez SAML dans la page Configurer le fournisseur de services (SP).

   

6. À l’aide des détails fournis dans la page Configurer le fournisseur de services (SP), configurez l’application Document360 avec le fournisseur d’identité précédemment sélectionné.

7. À l’aide des détails fournis par le fournisseur d’identité, configurez la configuration SSO dans Document360 sur la page Configurer le fournisseur d’identité (IdP).

   

Activation de la redirection directe du site de la base de connaissances (SSO initié par l’IdP)

Si vous souhaitez que les utilisateurs qui se connectent via un flux d’authentification unique initié par un fournisseur d’identité soient redirigés directement vers votre site de base de connaissances (au lieu du tableau de bord du projet), vous devez configurer le paramètre RelayState dans votre fournisseur d’identité (IdP).

Pour configurer cela :

1. Connectez-vous à la console d’administration de votre fournisseur d’identité (IdP) (par exemple, Okta, Entra ID, Auth0 ou ADFS).

2. Ouvrez l’application SAML que vous avez créée pour Document360.

3. Localisez le champ RelayState (ou équivalent).

4. Entrez l’URL de votre site de la base de connaissances.

   Par exemple: https://docs.yourdomain.com

5. Enregistrez votre configuration.

6. Testez la connexion initiée par l’IdP pour vérifier que les utilisateurs sont redirigés directement vers le site de la base de connaissances.

NOTE

Si le champ RelayState est laissé vide, les utilisateurs seront redirigés vers le tableau de bord du projet Document360 par défaut.

Une fois que vous avez terminé avec succès la configuration de l’authentification unique basée sur le protocole SAML, vous pouvez inviter des membres de votre projet à l’application d’authentification unique configurée.

Désormais, les utilisateurs peuvent se connecter à Document360 à l’aide de leur adresse e-mail et de leur mot de passe ou à l’aide de l’authentification unique.

Dépannage

Si vous rencontrez des problèmes lors de la configuration ou de la connexion à l’authentification unique SAML, reportez-vous aux erreurs courantes suivantes et à leurs solutions :

Demande SAML non valide (clé non approuvée)

Erreur: Une erreur s’est produite lors de la gestion de la connexion à distance - Demande SAML non valide La signature SAML est valide, mais utilise une clé non approuvée. Cette erreur se produit lorsque le certificat SAML téléchargé sur Document360 est inactif.

Étapes à résoudre :

Pour résoudre ce problème, procédez comme suit :

Télécharger le certificat SAML actif

1. Accédez à votre IdP.

2. Téléchargez le certificat SAML actuellement actif.

Téléchargez à nouveau le certificat dans Document360

1. Dans Document360, accédez à () > Users & security > SAML/OpenID.

2. Cliquez sur Modifier pour la configuration SSO appropriée.

3. Dans la section Configurer le fournisseur d’identité (IdP), recherchez le champ Certificat SAML .

4. Cliquez sur Parcourir pour télécharger le nouveau certificat actif.

Le téléchargement du certificat actif devrait résoudre le problème.

La signature du message SAML n’est pas valide

Erreur :

• SignatureInvalid : la signature du message SAML n’est pas valide.

• AssertionSignatureInvalid : la signature d’assertion SAML n’est pas valide.

• Demande SAML non valide : la signature SAML est valide, mais utilise une clé non approuvée.

Cette erreur se produit lorsqu’un certificat SAML incorrect ou expiré est téléchargé sur Document360.

Étapes à résoudre :

Assurez-vous que le certificat est valide :

1. Vérifiez si le certificat téléchargé est actif et n’a pas expiré.

2. Si nécessaire, générez un nouveau certificat dans le fournisseur d’identité (IdP).

Téléchargez à nouveau le certificat correct dans Document360 :

1. Dans Document360, accédez à () > Users & security > SAML/OpenID.

2. Cliquez sur Modifier pour la configuration SSO appropriée.

3. Dans la section Configurer le fournisseur d’identité (IdP), recherchez le champ Certificat SAML .

4. Cliquez sur Parcourir pour télécharger le nouveau certificat actif.

Capturer les journaux pour une analyse plus approfondie (si le problème persiste)

1. Ajoutez l’extension SAML Tracer à votre navigateur.

2. Ouvrez SAML Tracer avant de démarrer le flux de connexion SSO.

3. Effectuez l’action qui déclenche le processus SSO (par exemple, en cliquant sur Continuer avec SSO).

4. SAML Tracer enregistrera toutes les requêtes réseau.

5. Cliquez avec le bouton droit de la souris dans le panneau Traceur SAML .

6. Sélectionnez Exporter ou enregistrez les journaux dans un format approprié.

Pour obtenir de l’aide, communiquez avec le Document360 support team :

• Captures d’écran de votre configuration IdP.

• Les détails du certificat SAML téléchargé.

• Journaux de suivi SAML.