1. Introduction
Ce guide est conçu pour vous aider à configurer l'authentification unique (SSO) pour les applications de votre organisation en utilisant Microsoft Entra.
Note importante : Avant de commencer, assurez-vous d'avoir les autorisations nécessaires. Si vous n'êtes pas sûr, veuillez contacter le support informatique ou l'administrateur de votre entreprise.
2. Table des matières
- Comprendre les termes clés
- Commencer
- Configuration SSO étape par étape
- Test et confirmation
- Dépannage & Support
- Ressources supplémentaires
3. Comprendre les termes clés
Microsoft Entra : Anciennement connu sous le nom d'Azure Active Directory, c'est l'annuaire d'identité en ligne de Microsoft utilisé pour gérer l'accès des utilisateurs aux ressources. • SSO (Single Sign-On) : Une méthode sécurisée qui vous permet d'accéder à diverses applications avec un seul ensemble d'identifiants (nom d'utilisateur et mot de passe). • Application : Tout outil ou service en ligne utilisé par votre organisation (par exemple, email, outils de collaboration).
4. Commencer
Avant de commencer à configurer le SSO, veuillez vous assurer :
• Vous avez reçu un accès administrateur à Microsoft Entra (ou demandez à votre équipe informatique si nécessaire).
• Le protocole du SSO sera SAML2
• Indiquez la valeur à utiliser comme nom d'utilisateur. Pour l'accès SSO, Cyber Guru souhaite utiliser l'ID d'objet de l'utilisateur. Cela signifie que si vous préchargez l'utilisateur sur notre plateforme, il doit avoir l'objectID comme nom d'utilisateur
• Vérifiez la présence dans le profil utilisateur Microsoft des champs obligatoires : nom d'utilisateur, email, prénom, nom de famille
• Vérifiez la politique d'accès à l'application SSO pour les utilisateurs. L'utilisation de groupes serait préférable.
• Fournissez un utilisateur pour Cyberguru dans Microsoft Entra pour le dépannage
5. Configuration SSO étape par étape
5.1. Étape 1 :
Connexion à Microsoft Entra
Accédez à la page de connexion Microsoft Entra avec un rôle d'administrateur
5.2. Étape 2 : Navigation vers la section Applications d'entreprise
Une fois connecté, recherchez un panneau de navigation (généralement à gauche).
Cliquez sur l'option intitulée “Applications d'entreprise” ou “Apps”.
Cette section montre toutes les applications disponibles pour l'intégration SSO.
5.3. Étape 3 : Ajouter une nouvelle application
En haut de la page “Applications d'entreprise”, il y a généralement un bouton qui dit “Nouvelle application” ou “Ajouter une application”.
Cliquez sur ce bouton.
Cliquez sur “Créer votre propre application”
Assurez-vous que le bouton radio est sélectionné sur “Intégrer toute autre application que vous ne trouvez pas dans la galerie (Non-galerie)
insérez un nom pour l'application et cliquez sur “Enregistrer”
5.4. Étape 4 : Configurer le SSO pour l'application
Sur la page d'aperçu de l'application,
cherchez un bouton ou un lien indiquant "Authentification unique" ou "Configurer l'authentification unique".
Cliquez sur ce bouton. Vous serez dirigé vers la page de configuration SSO.
Vous pourriez voir différentes méthodes SSO (comme SAML, OpenID Connect, etc.). Cliquez sur "SAML".
5.5. Étape 5 : envoyer les métadonnées Idp à Cyber Guru
Trouvez le panneau n°3 sur la page de l'application.
Copiez l'URL de FederationMetadata de l'application et envoyez-la à CSM Cyber Guru.
5.6. Étape 6 : Configuration par Cyber Guru
Cyber Guru complétera la configuration de son côté et renverra l'URL des métadonnées SP.
N.B. Ouvrez l'URL des métadonnées SP reçue dans un navigateur et enregistrez-la en tant que fichier XML
5.7. Étape 7 : télécharger les métadonnées SP
Cliquez sur "Mettre à jour le fichier de métadonnées", dans le coin supérieur gauche de la page de l'application et
fournissez le fichier xml des métadonnées SP enregistré à l'étape précédente.
Dès que le fichier est téléchargé, vous accédez à la page de révision des métadonnées
cliquez sur "Enregistrer"
5.8. Étape 8 : Ajouter les revendications Cyber Guru à la réponse SAML
Cyber Guru revendique les attributs obligatoires suivants dans la réponse SAML
• nom d'utilisateur
• prénom
• nom de famille
Pour une liste complète des attributs que Cyber Guru peut recevoir dans la réponse, veuillez vous référer à l'article dédié "Attributs Idp"
Dès que l'application est créée, vous trouverez les revendications par défaut comme suit
Vous pouvez modifier les revendications supplémentaires existantes ou les supprimer toutes et en créer de nouvelles. Voici le détail pour chaque attribut obligatoire :
À la fin de la configuration des revendications, vous devriez voir ce qui suit. Vérifiez attentivement le mappage et faites attention aux attributs avec des noms sensibles à la casse (prénom, nom de famille)
5.9. Étape 9 Révision de la Configuration
Prenez un moment pour revoir les informations. Si quelque chose ne semble pas correct, vous pouvez revenir en arrière et faire des ajustements.
Remarque : Il est conseillé de conserver une note papier ou une copie numérique de ces paramètres pour référence future.
6. Test et Confirmation
Une fois la configuration SSO terminée, testez son bon fonctionnement :
Autorisez l'utilisateur pour le test dans l'application. L'utilisateur doit déjà être préchargé dans la plateforme Cyber Guru.
Ouvrez une nouvelle fenêtre de navigateur (ou une fenêtre incognito/privée).
Accédez à l'URL de connexion de l'application
https://<domaine client>.platform.cyberguru.eu
Cliquez sur le bouton « Connexion avec SSO » — votre navigateur devrait vous rediriger vers la page de connexion de Microsoft Entra.(*)
Entrez les identifiants de connexion.
Confirmez que vous êtes connecté à l'application sans avoir besoin de saisir d'autres identifiants.
Si tout fonctionne correctement, vous verrez un message de succès ou le tableau de bord de l'application.
(*) Ce bouton peut être supprimé par Cyber Guru, donc dès que vous pointez votre navigateur vers https://<domaine client>.platform.cyberguru.eu, la plateforme redirigera automatiquement l'utilisateur vers la page de connexion Microsoft.
7. Dépannage & Support
Si vous rencontrez des problèmes lors de la configuration :
- Vérifiez les informations saisies dans chaque champ.
- Assurez-vous que les URL et les identifiants correspondent à ceux fournis par votre équipe informatique ou le fournisseur de l'application.
- Recherchez les messages d'erreur à l'écran — ils incluent souvent des indices sur ce qui ne va pas.
- Utilisez un traceur SAML dans le navigateur pour suivre les valeurs des revendications dans la réponse SAML.
Si vous avez toujours des difficultés, notez le message d'erreur et contactez votre support informatique et/ou le service d'assistance Cyberguru.
8. Ressources Supplémentaires
Documentation Microsoft Entra :
Visitez le site officiel de Microsoft pour des guides détaillés et des FAQ :
https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal-setup-sso
Contactez le Support Informatique : Contactez l'équipe informatique de votre organisation pour obtenir de l'aide sur des configurations spécifiques.