Résoudre les problèmes liés à l’authentification unique

Bien que les erreurs d’authentification unique soient souvent faciles à corriger, les tests et le débogage peuvent constituer un défi. Pour des raisons de sécurité, les utilisateurs qui tentent de se connecter ne reçoivent qu’un message générique indiquant que la connexion était incorrecte. Utilisez les outils de diagnostic de votre société pour afficher et résoudre des erreurs plus spécifiques.

Vérifier les paramètres de configuration SSO

De nombreux problèmes SSO sont dus à des paramètres de configuration incorrects. Si vous ne pouvez pas vous connecter via l’authentification unique, les utilisateurs administrateurs peuvent contourner l’authentification unique et se connecter à la page de connexion standard en utilisant leur nom d’utilisateur et leur mot de passe d’administrateur.

Les paramètres de configuration SSO se trouvent dans les zones suivantes :

Informations sur la société Page - Sécurité Onglet
Informations utilisateur Page - Authentification unique Onglet

Voir Configurer l’authentification unique pour obtenir des informations détaillées sur les paramètres de configuration.

Afficher le journal d’accès

Le journal d’accès est un rapport qui enregistre lorsqu’un utilisateur tente de se connecter à une société. Le journal d’accès regroupe les données par utilisateur, puis par date et heure. Il répertorie toutes les tentatives SSO échouées comme « Accès SSO non valide » dans la Résultat de la connexion colonne et affiche l’erreur associée dans la Description colonne pour l’utilisateur concerné.

En savoir plus sur les Journal d’accès.

Pour afficher le journal d’accès :

Aller à Société > Tous > Journaux et sélectionnez Journal d’accès.
Définissez les filtres applicables et sélectionnez Vue.
Intacct affiche les données d’accès qui correspondent aux critères donnés.
Scanner le Résultat de la connexion colonne pour « Accès SSO non valide » et voir les correspondants Description informations.
Voyez le Code d’erreur SSO et tableau de résolution pour obtenir des informations d’erreur.

Tester l’authentification unique d’un utilisateur

Vous pouvez tester l’authentification unique d’un utilisateur à partir de la fiche utilisateur applicable. Intacct ouvre une fenêtre de navigateur temporaire et tente de se connecter avec l’authentification unique pour l’utilisateur. Lorsque la fenêtre se ferme, Intacct affiche les résultats de la tentative dans la zone de texte située sous le bouton de test. Vous pouvez également afficher les résultats d’erreur de ce test dans le journal d’accès.

Pour tester l’authentification unique d’un utilisateur :

Aller à Société > Tous > utilisateurs, puis sélectionnez Utilisateurs.
La liste Utilisateurs s’affiche.
Recherchez l’utilisateur souhaité et sélectionnez Modifier à côté.
Sélectionnez la Authentification unique Onglet.
Sélectionner Tester la connexion unique.
Une autre fenêtre de navigateur apparaît et tente d’utiliser l’authentification unique pour l’utilisateur.

Si l’authentification unique réussit, le message « Test SSO a réussi » s’affiche.

Erreurs possibles :

Si votre société ne peut pas accéder au fournisseur d’identité configuré, une erreur 404 ou une erreur générée par le fournisseur d’identité peut apparaître dans la fenêtre du navigateur.
Si l’authentification unique échoue en raison de l’incapacité à traiter la réponse du fournisseur d’identité SSO, une erreur peut apparaître dans la zone de texte située sous la Tester la connexion unique le bouton. Cette erreur apparaîtra également dans le journal d’accès.
S’il y a un autre type de problème de connexion, la page de connexion peut apparaître et la fenêtre ne se fermera pas. Voir Autres erreurs de connexion pour plus d’informations.

Aller à Société > Tous > utilisateurs, puis sélectionnez Utilisateurs.
La liste Utilisateurs s’affiche.
Recherchez l’utilisateur pour lequel vous souhaitez tester l’authentification unique.
Sélectionnez Modifier à la fin de la ligne.
Sélectionnez la Authentification unique Onglet.
Sélectionner Tester la connexion unique.
Une autre fenêtre de navigateur apparaît et tente d’utiliser l’authentification unique pour l’utilisateur.

Si l’authentification unique réussit, le message « Test SSO a réussi » s’affiche.

Erreurs possibles :

Si votre société ne peut pas accéder au fournisseur d’identité configuré, une erreur 404 ou une erreur générée par le fournisseur d’identité peut apparaître dans la fenêtre du navigateur.
Si l’authentification unique échoue en raison de l’incapacité à traiter la réponse du fournisseur d’identité SSO, une erreur peut apparaître dans la zone de texte située sous la Tester la connexion unique le bouton. Cette erreur apparaîtra également dans le journal d’accès.
S’il y a un autre type de problème de connexion, la page de connexion peut apparaître et la fenêtre ne se fermera pas. Voir Autres erreurs de connexion pour plus d’informations.

Codes d’erreur et résolutions

Les erreurs suivantes peuvent apparaître soit dans le journal d’accès, soit à la suite de la connexion d’un utilisateur de test.

Erreur	Résolution
Réponse à l’authentification unique non valide.	Vérifiez les paramètres dans la Informations sur la société page. Solutions possibles : Vérifiez que le certificat SSO est un certificat x.509 valide et qu’il correspond à celui de votre fournisseur SSO. Le certificat SSO délivré par votre fournisseur d’identité SSO a peut-être été mal copié dans votre société, ou le certificat initial pourrait avoir expiré. Le certificat x.509 doit être au format PEM et généré avec une signature de hachage SHA-256. Vérifiez que les éléments sélectionnés Type de fournisseur d’identité est correcte.
L’authentification unique n’est pas activée pour cette société.	La configuration de l’authentification unique est incomplète ou jamais terminée. Voir Configurer l’authentification unique pour des informations sur l’activation de SSO.
L’authentification unique n’est pas activée pour l’utilisateur <Intacct user="" id="">.</Intacct>	Modifiez la fiche de l’utilisateur pour activer l’authentification unique. Voir Configurer des utilisateurs individuels pour obtenir des instructions détaillées.
<Intacct user="" id=""> L’utilisateur a tenté de se connecter, mais l’ID de utilisateur fédéré <SSO federated="" id=""> envoyé par le fournisseur SSO ne correspond pas <Intacct federated="" id=""> à l’ID de utilisateur fédéré dans le fiche du utilisateur.</Intacct></SSO></Intacct>	Modifier la fiche de l’utilisateur et corriger celle de l’utilisateur Identifiant d’utilisateur SSO fédéré. Voir Configurer des utilisateurs individuels pour obtenir des instructions détaillées.

Autres erreurs de connexion

Votre société ne peut pas capturer les erreurs SSO si l’une des conditions suivantes est remplie :

Si votre société est introuvable
Si l’URL du fournisseur d’identité ne peut pas être trouvée
Si la réponse du fournisseur d’identité ne peut pas être interprétée

Ces types d’erreurs n’apparaîtront pas dans le journal d’accès ni dans les résultats de la connexion unique de l’utilisateur de test. Le tableau suivant répertorie certaines des erreurs qui se produisent à la suite de l’une des conditions ci-dessus :

Problème	Résolution
Les données de configuration de l’authentification unique sont envoyées à une société incorrecte ou non valide.	Si la tentative d’authentification unique ne permet pas de se connecter à votre société, l’échec ne peut pas être consigné dans un Journal d’accès. Vérifiez la configuration de votre fournisseur d’identité SSO.
Configuration de l’authentification unique Identifier le type de fournisseur incorrectement sur la page Informations sur la société.	Vérifiez la Type de fournisseur d’identité dans la Informations sur la société page. Les options sont : SAML 2.0, et SAML 2.0 avec ADFS. Si le mauvais paramètre est utilisé, la connexion SSO peut être confuse quant à l’société à laquelle se connecter, ce qui entraîne une erreur non enregistrée.
Sur la page d’authentification unique, sélectionnez Connexion. La page de connexion actualise les champs Identifiant utilisateur et Société, et rien ne se passe ni ne s’affiche.	Intacct ne parvient pas à se connecter au fournisseur d’identité SSO. Vérifiez la URL de connexion pour votre fournisseur d’identité SSO dans le Informations sur la société page.
Les attributs SAML incorrects sont renvoyés par le fournisseur d’identité d’authentification unique.	Pour les connexions initiées par le fournisseur d’identité, votre société s’attend à ce que l’ID de société soit renvoyé dans l’attribut Nom de la Société de l’assertion SAML et que l’ID utilisateur soit renvoyé dans l’attribut Nom. Vérifiez la configuration de votre fournisseur d’identité SSO.