SAML

SAML 2.0 est un protocole standard ouvert qui permet aux utilisateurs d’accéder à plusieurs applications web avec un seul ensemble d’identifiants. Cela offre un moyen plus sûr et pratique pour les utilisateurs d’accéder à Document360. Avec SAML 2.0 activé, les utilisateurs de Document360 peuvent se connecter à la plateforme en utilisant leurs identifiants existants auprès d’un fournisseur d’identité (IdP). Document360 prend en compte la configuration de plusieurs points d’accès à connexion unique (SSO), permettant aux utilisateurs et aux lecteurs de se connecter via leur fournisseur d’identité préféré.

Fournisseurs d’identité pris en charge

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

• Okta

• Entrée ID

• Google

• Auth0

• ADFS

• OneLogin

• Autres

Configuration du SSO en utilisant SAML

1. Connectez-vous à votre compte Document360 et naviguez vers le projet souhaité.

2. Naviguez vers () > Utilisateurs & permissions > Configuration SSO.

3. Cliquez sur Créer SSO.

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

   

5. Sélectionnez SAML sur la page Configurer le fournisseur de service (SP ).

   

6. En utilisant les détails fournis dans la page Configurer le fournisseur de service (SP ), configurez l’application Document360 avec le fournisseur d’identité précédemment sélectionné.

7. En utilisant les informations fournies par le fournisseur d’identité, configurez la configuration SSO dans Document360 sur la page Configurer le fournisseur d’identité (IdP ).

   

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

Si vous souhaitez que les utilisateurs qui se connectent via un flux SSO initié par l’IdP 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 ceci :

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

2. Ouvre l’application SAML que tu as créée pour Document360.

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

4. Saisissez l’URL de votre site de base de connaissances.

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

5. Sauvegardez 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 reste vide, les utilisateurs seront redirigés par défaut vers le tableau de bord Document360 Project.

Une fois la configuration SSO terminée avec succès selon le protocole SAML, vous pouvez inviter les membres de votre projet à accéder à l’application SSO configurée.

Désormais, les utilisateurs peuvent se connecter à Document360 soit en utilisant leur adresse e-mail et mot de passe, soit via SSO.

Dépannage

Si vous rencontrez des problèmes lors de la configuration ou de la connexion du SSO SAML, consultez les erreurs courantes suivantes et leurs solutions :

Requête SAML invalide (clé non fiable)

Erreur : Une erreur a été rencontrée lors de la gestion de la connexion à distance - la signature SAML de requête SAML invalide est valide mais utilise une clé non fiable. Cette erreur survient lorsque le certificat SAML téléchargé sur Document360 est inactif.

Étapes à résoudre :

Pour résoudre ce problème,

Téléchargez le certificat SAML actif

1. Accédez à votre IDP.

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

Re-téléversez le certificat dans Document360

1. Dans Document360, naviguez vers () > Users & permissions > SAML/OpenID.

2. Cliquez sur Modifier pour la configuration SSO pertinente.

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

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

Télécharger le certificat actif devrait résoudre le problème.

La signature du message SAML est invalide

Erreur :

• SignatureInvalide : la signature du message SAML est invalide.

• AssertionSignatureInvalid : La signature d’assertion SAML est invalide.

• Requête SAML invalide : la signature SAML est valide mais utilise une clé non fiable.

Cette erreur survient 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 non expiré.

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

Re-téléversez le certificat correct dans Document360 :

1. Dans Document360, naviguez vers () > Users & permissions > SAML/OpenID.

2. Cliquez sur Modifier pour la configuration SSO pertinente.

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

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

Capture des 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 lancer le flux de connexion SSO.

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

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

5. Faites un clic droit dans le panneau tracer SAML .

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

Pour une assistance complémentaire, contactez l’équipe de support de Document360 avec :

• Captures d’écran de votre configuration IDP.

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

• Journaux traceurs SAML.