Comment configurer le SSO SAML avec Mooncard via Azure AD (Entra ID) ?

Le SSO (authentification unique) permet à vos collaborateurs de se connecter à Mooncard avec leur compte d'entreprise. Cet article détaille la configuration avec Microsoft Entra ID (anciennement Azure AD).

Cet article s'adresse à l'administrateur Microsoft Entra ID de votre société. La mise en place se fait en trois temps, en lien avec votre interlocuteur Mooncard :

  1. Mooncard vous transmet les deux valeurs propres à votre société.
  2. Vous créez l'application SAML chez votre fournisseur d'identité, puis vous nous renvoyez son certificat et ses informations.
  3. Mooncard active la connexion, puis vous la testez.

Avant de commencer

Pour une mise en place fluide, préparez les éléments suivants :

  • Un administrateur de votre fournisseur d'identité. Il crée l'application SAML et lui affecte vos collaborateurs.
  • La liste de vos domaines e-mail (par exemple votre-societe.fr). Mooncard s'en sert pour reconnaître vos collaborateurs à la connexion et les orienter vers votre fournisseur.
  • Vos collaborateurs invités dans Mooncard. Le SSO s'appuie sur les comptes Mooncard existants : invitez chaque collaborateur avec la même adresse e-mail que chez votre fournisseur. Son invitation est acceptée automatiquement à sa première connexion SSO.
  • Un fournisseur d'identité par société. Les sociétés d'un même groupe peuvent partager une seule et même configuration.

Étapes détaillées

Étape 1 — Récupérer les valeurs Mooncard

Votre interlocuteur Mooncard vous transmet deux valeurs, propres à votre société. Utilisez uniquement celles-ci.

Valeur Nom chez Microsoft Entra ID
URL ACS (Assertion Consumer Service) Reply URL (Assertion Consumer Service URL)
ID d'entité Identifier (Entity ID)

Les autres champs facultatifs (Sign on URL, Relay State, Logout URL) restent vides.

Étape 2 — Créer l'application chez Microsoft Entra ID (Azure AD)

  1. Ouvrir le centre d'administration Microsoft Entra, puis Applications d'entreprise → Nouvelle application → Créer votre propre application. Nommer l'application « Mooncard » et choisir « Intégrer une autre application que vous ne trouvez pas dans la galerie ».

  2. Dans l'application, ouvrir Authentification unique et choisir SAML.

  3. Dans le bloc Configuration SAML de base, saisir l'Identifier (Entity ID) et la Reply URL reçus de Mooncard (étape 1).

  4. Dans le bloc Attributs et revendications, ajouter les revendications du tableau ci-dessous, en laissant le champ Espace de noms vide.

  5. Dans le bloc Certificats SAML, télécharger le Certificat (Base64), au format .cer. Avec Entra ID, ce certificat est propre à chaque application.

  6. Dans le bloc Configurer Mooncard, copier l'URL de connexion (Login URL) et l'Identificateur Microsoft Entra.

  7. Dans le menu Utilisateurs et groupes, affecter l'application aux collaborateurs ou aux groupes qui utilisent Mooncard. Seuls les collaborateurs affectés peuvent se connecter.

Revendications à ajouter (point 4) :

Nom de la revendication Attribut source Obligatoire
email user.mail (ou user.userprincipalname) Oui
identity_provider_user_id user.objectid Oui
firstname user.givenname Non
lastname user.surname Non
phone user.mobilephone Non

Étape 3 — Envoyer vos informations à Mooncard

Transmettez à votre interlocuteur Mooncard :

  • le certificat de signature (.cer, .pem ou .crt, format Base64) ;
  • l'URL de connexion de votre fournisseur (Login URL) ;
  • l'identifiant de votre fournisseur (Identificateur Microsoft Entra) ;
  • la liste de vos domaines e-mail.

Nous enregistrons la configuration, puis nous vous prévenons dès que vous pouvez tester.

Étape 4 — Tester la connexion

  1. Ouvrir app.mooncard.co et cliquer sur Se connecter.
  2. Saisir une adresse e-mail de votre domaine : Mooncard vous oriente vers la page de connexion de votre fournisseur.
  3. Se connecter chez votre fournisseur : vous revenez sur Mooncard, connecté.

Comment faire sans compte Mooncard ? La configuration est correcte si vous revenez sur la page de connexion Mooncard avec le message « Impossible de vous authentifier car ce compte SSO (…) n'est lié à aucun collaborateur. » Tout autre message indique un point de configuration à vérifier.


💡 Bon à savoir

Le SSO protège l'ensemble de vos domaines. Une fois activé, tout utilisateur dont l'adresse e-mail appartient à l'un de vos domaines (par exemple @votre-societe.fr) se connecte à Mooncard par SSO. Notre conseil : activez-le lorsque tous ces collaborateurs ont accès à l'application chez votre fournisseur.

La connexion démarre depuis Mooncard. Pour des raisons de sécurité, vos collaborateurs se connectent toujours depuis la page de connexion app.mooncard.co, et non depuis le portail de votre fournisseur.

À quoi servent les attributs ?

Attribut Obligatoire Rôle chez Mooncard
email Oui Retrouve le collaborateur à sa première connexion SSO : il doit correspondre à l'adresse enregistrée dans Mooncard. Par défaut, un changement d'adresse chez votre fournisseur est ensuite repris dans Mooncard.
identity_provider_user_id Oui Identifie le collaborateur aux connexions suivantes, même si son adresse change. Il doit être fixe et unique par personne.
firstname Non Met à jour le prénom à chaque connexion.
lastname Non Met à jour le nom à chaque connexion.
phone Non Met à jour le téléphone. Renseignez un numéro de mobile : il sert à valider les paiements en ligne.

Comment nous aider en cas de difficulté ? Envoyez-nous un fichier HAR de votre tentative de connexion : il nous permet d'identifier la cause avec certitude.

  1. Dans Chrome ou Edge, ouvrir les outils de développement (F12), onglet Réseau (Network).
  2. Cocher Conserver le journal (Preserve log).
  3. Refaire la tentative de connexion depuis app.mooncard.co.
  4. Faire un clic droit dans la liste des requêtes, puis Enregistrer tout au format HAR.

Un fichier HAR contient les échanges de votre navigateur : réalisez le test avec un compte dédié et transmettez le fichier uniquement à votre interlocuteur Mooncard.


❓ Mini-FAQ

Un nouveau collaborateur arrive. Que faire ? Affectez-lui l'application chez votre fournisseur, puis invitez-le dans Mooncard avec la même adresse e-mail. Sa première connexion SSO accepte l'invitation automatiquement : il n'a aucun e-mail d'activation à traiter.

Un collaborateur change d'adresse e-mail. Que faire ? Rien de particulier : Mooncard le reconnaît grâce à son identity_provider_user_id, et sa nouvelle adresse est reprise à sa connexion suivante.

Un collaborateur quitte la société. Que faire ? Retirez-lui l'accès chez votre fournisseur, puis archivez-le dans Mooncard pour désactiver ses cartes.

Une connexion affiche « … n'est lié à aucun collaborateur ». Pourquoi ? L'adresse transmise par votre fournisseur ne correspond à aucun collaborateur Mooncard de votre société. Vérifiez l'invitation du collaborateur et l'attribut email.

Le certificat de notre fournisseur arrive à expiration. Que faire ? Envoyez le nouveau certificat à votre interlocuteur Mooncard avant la date d'expiration, pour assurer la continuité des connexions.

Plusieurs sociétés de notre groupe utilisent Mooncard. Faut-il une configuration par société ? Non : une seule application SAML et une seule configuration peuvent servir toutes les sociétés du groupe. Indiquez-les simplement à votre interlocuteur Mooncard.

Allez plus loin avec l'assistantIl répond à partir de cet article, et notre équipe prend le relais si besoin.