Passer au contenu principal
Le provisionnement SCIM est disponible avec l’abonnement Enterprise. L’intégration d’annuaire (Microsoft Graph) est disponible avec les abonnements Teams et Enterprise. Les deux s’appliquent au niveau de l’organisation et sont configurées par un administrateur.
Il existe deux façons de connecter Microsoft Entra ID (anciennement Azure Active Directory) à Wave Connect. Les deux créent et mettent à jour les utilisateurs Wave Connect à partir de votre annuaire. Elles diffèrent par les personnes synchronisées, le fonctionnement du départ des utilisateurs et ce qui maintient la connexion active.

Laquelle choisir ?

Le provisionnement SCIM est l’approche recommandée par Microsoft pour garder une application synchronisée avec Entra ID. Choisissez l’intégration Graph uniquement avec l’abonnement Teams ou pour un import ponctuel.

Configurer le provisionnement SCIM

1

Créez un jeton SCIM dans Wave Connect

Accédez à Paramètres → Sécurité et repérez la carte Synchronisation de l’annuaire. Cliquez sur Configurer pour ouvrir la fenêtre Configurer SCIM. Copiez le Point de terminaison SCIM (https://app.wavecnct.com/api/scim), puis cliquez sur Créer un jeton. Donnez un nom au jeton et cliquez sur Créer. Copiez le jeton immédiatement. Il n’est affiché qu’une seule fois.
2

Créez l'application d'entreprise

Dans le centre d’administration Microsoft Entra, accédez à Applications d’entreprise → Nouvelle application → Créer votre propre application. Saisissez un nom tel que « Wave Connect », choisissez Intégrer toute autre application que vous ne trouvez pas dans la galerie (hors galerie), puis cliquez sur Créer.
3

Saisissez les identifiants SCIM

Ouvrez la nouvelle application et accédez à Approvisionnement → Commencer. Définissez Mode d’approvisionnement sur Automatique. Sous Informations d’identification de l’administrateur, collez le point de terminaison SCIM dans URL du locataire et le jeton dans Jeton secret. Cliquez sur Tester la connexion, puis sur Enregistrer.
4

Vérifiez les mappages d'attributs

Sous Mappages, ouvrez Approvisionner les utilisateurs Microsoft Entra ID et comparez avec le tableau ci-dessous. Les valeurs par défaut d’Entra couvrent la plupart des lignes. Vous devez uniquement modifier les lignes de l’e-mail principal, de locale et de externalId. Laissez Approvisionner les groupes Microsoft Entra ID activé si vous souhaitez que les groupes Entra deviennent des équipes Wave Connect.
5

Affectez des utilisateurs et des groupes

Accédez à Utilisateurs et groupes et affectez les personnes et les groupes qui doivent disposer d’un compte Wave Connect. Seuls les utilisateurs affectés sont provisionnés.
6

Démarrez le provisionnement

De retour sur Approvisionnement, définissez État de l’approvisionnement sur Activé et cliquez sur Enregistrer, ou cliquez sur Démarrer l’approvisionnement. Entra exécute un cycle initial, puis un cycle incrémentiel environ toutes les 40 minutes. Pour vérifier un seul utilisateur sans attendre, utilisez Approvisionner à la demande.

Correspondance des attributs

Wave Connect lit les attributs SCIM suivants. La colonne Champ Wave Connect indique où chaque valeur est enregistrée.
Les mappages par défaut d’Entra couvrent déjà userName, name.givenName, name.familyName, title, les numéros de téléphone, addresses[type eq "work"].locality et active. Seules trois lignes doivent être modifiées : assurez-vous que le mappage de l’e-mail professionnel définit primary sur True, remplacez la cible de preferredLanguage par locale au lieu de preferredLanguage, et remplacez la source de externalId par objectId au lieu de mailNickname.
Autres remarques sur le mappage :
  • Les numéros de téléphone sont validés et enregistrés au format international. Les valeurs factices et celles ne contenant qu’une extension sont ignorées au lieu de faire échouer la synchronisation.
  • roles[].value défini sur USER, ADMIN ou OWNER (en majuscules) définit le rôle dans l’organisation. Entra n’envoie pas de rôles par défaut, les nouveaux utilisateurs sont donc créés comme utilisateurs.
  • L’extension entreprise department n’est pas enregistrée sur le profil. L’affectation d’équipe basée sur le département peut être activée par le support Wave Connect.
  • La valeur de locale doit être l’une des langues prises en charge par Wave Connect, sinon l’utilisateur obtient l’anglais.

Les groupes deviennent des équipes

Lorsque le provisionnement des groupes est activé, chaque groupe Entra affecté à l’application devient une équipe Wave Connect. Le displayName du groupe devient le nom de l’équipe et l’objectId du groupe est enregistré comme ID externe de l’équipe. Si une équipe portant le même nom existe déjà dans Wave Connect, le groupe y est fusionné. Un utilisateur Wave Connect appartient à une seule équipe. Si un utilisateur fait partie de plusieurs groupes affectés, le dernier groupe provisionné par Entra l’emporte. Une organisation peut compter jusqu’à 75 équipes. Supprimer un groupe dans Entra supprime l’équipe dans Wave Connect. Ses utilisateurs sont conservés et ses contacts sont transférés à l’organisation. Chaque équipe peut avoir un modèle différent, de sorte que les utilisateurs de différents groupes obtiennent automatiquement la mise en page de carte, la marque et les champs verrouillés appropriés. Consultez Modèles.

Départ des utilisateurs

Lorsqu’un utilisateur est retiré de l’application, désactivé ou supprimé de manière réversible dans Entra, le service de provisionnement envoie active = false. Wave Connect désactive l’utilisateur :
  • Il ne peut plus se connecter et ses sessions sont révoquées.
  • Il apparaît avec un badge SUSPENDED dans Utilisateurs.
  • Sa carte NFC, son profil et ses contacts sont conservés.
  • Il compte toujours comme un siège.
Entra conserve un utilisateur supprimé de manière réversible pendant 30 jours, puis envoie une demande de suppression. Wave Connect supprime alors définitivement l’utilisateur, supprime son profil et ses contacts, et dissocie sa carte NFC afin qu’elle puisse être attribuée à quelqu’un d’autre. Si vous ne souhaitez pas le délai de grâce de 30 jours, ouvrez Paramètres → Sécurité → Synchronisation de l’annuaire → Configurer et activez Supprimer l’utilisateur immédiatement au lieu de suspendre. La désactivation supprime alors définitivement l’utilisateur sans délai. Pour réintégrer un utilisateur désactivé, affectez-le à nouveau à l’application dans Entra. Le cycle de provisionnement suivant envoie active = true et réactive le compte.
Vous pouvez activer l’authentification unique sur la même application d’entreprise. Consultez Authentification unique (SAML).

Intégration d’annuaire (Microsoft Graph)

L’intégration d’annuaire connecte Wave Connect à votre tenant via l’API Microsoft Graph en utilisant le compte d’un administrateur. Elle est plus simple à configurer que SCIM, mais elle synchronise l’ensemble du tenant et dépend du compte qui l’a connectée.

Comment se connecter

Il existe deux points d’entrée. Ils créent la même intégration, mais avec une valeur par défaut différente pour Synchronisation des utilisateurs, l’interrupteur qui applique automatiquement les modifications de l’annuaire.
  1. Accédez à Intégrations → Microsoft Entra ID et cliquez sur Installer l’application.
  2. Laissez Importer automatiquement de nouveaux utilisateurs depuis Microsoft Entra ID activé, ou désactivez-le si vous souhaitez uniquement un import manuel. Cliquez sur Continuer.
  3. Connectez-vous avec un compte Microsoft pouvant accorder le consentement administrateur sur le tenant, et acceptez la demande de consentement.
Avec cet interrupteur activé, chaque utilisateur du tenant est créé dans Wave Connect à l’arrivée des notifications de changement, et les modifications futures sont appliquées automatiquement. Il apparaît sous le nom Synchronisation des utilisateurs dans les Paramètres de l’intégration.
Avec Synchronisation des utilisateurs activée, cette intégration ajoute un utilisateur Wave Connect, et donc un siège, pour chaque utilisateur du tenant, invités compris. Il n’est pas possible de la limiter à un groupe.

Permissions

Wave Connect demande les étendues déléguées openid, offline_access, profile, User.Read.All et Directory.Read.All sur le compte de l’administrateur qui se connecte. Wave Connect lit uniquement l’annuaire. Il n’écrit jamais dans Entra. L’intégration fonctionne avec le jeton d’actualisation de cet administrateur. Si le jeton est révoqué (par exemple si l’administrateur quitte l’entreprise, si son mot de passe est réinitialisé avec révocation des sessions, ou si une stratégie d’accès conditionnel bloque l’actualisation), Wave Connect supprime l’intégration et un administrateur doit la reconnecter.

Ce qui est synchronisé

Direction de synchronisation : Entra ID → Wave Connect (entrante uniquement). Les photos de profil ne sont récupérées que lors d’un import manuel ou d’un aperçu et sont enregistrées sous forme de copie dans Wave Connect. Les utilisateurs créés par Synchronisation des utilisateurs n’obtiennent pas de photo.

Synchronisation des utilisateurs et désactivation

Après la connexion, Wave Connect s’abonne aux notifications de changement Microsoft Graph pour les utilisateurs (créés, mis à jour, supprimés). Les abonnements durent trois jours et sont renouvelés automatiquement à partir des notifications de cycle de vie Graph. Les notifications sont ignorées tant que Synchronisation des utilisateurs est désactivée. Lorsqu’un utilisateur est supprimé dans Entra, ou que son compte est désactivé (accountEnabled = false), Wave Connect le désactive : la connexion est bloquée, il apparaît avec un badge SUSPENDED dans Utilisateurs, et sa carte, son profil et ses contacts sont conservés. Il compte toujours comme un siège. Réactiver le compte dans Entra ne le réactive pas dans Wave Connect. Contactez support@wavecnct.com pour réactiver un utilisateur, ou supprimez-le depuis Utilisateurs.

Limitations

  • L’ensemble du tenant est synchronisé. Les invités sont inclus. Il n’y a pas de limitation par affectation.
  • Les groupes et départements Entra ne sont pas synchronisés. Les équipes doivent être gérées dans Wave Connect.
  • Pas de photo pour les utilisateurs créés par Synchronisation des utilisateurs.
  • La connexion dépend d’un seul compte administrateur et est supprimée lorsque le jeton de ce compte est révoqué.
  • Les utilisateurs ne sont jamais supprimés par l’intégration, seulement désactivés.

Déconnexion

Accédez à Intégrations → Microsoft Entra ID → Paramètres et cliquez sur Déconnecter. Cela supprime la connexion enregistrée dans Wave Connect. Rien n’est révoqué côté Microsoft, et l’abonnement Graph expire simplement sous trois jours. Les utilisateurs Wave Connect existants sont conservés et ne sont plus mis à jour. Pour retirer l’accès de Wave Connect côté Microsoft, révoquez le consentement de l’application d’entreprise dans le centre d’administration Entra.

Utiliser les deux

SCIM et l’intégration Graph peuvent être actifs en même temps. Dans ce cas, les utilisateurs provisionnés via SCIM obtiennent leur photo de profil depuis la connexion Graph, par correspondance d’e-mail. Laissez Synchronisation des utilisateurs désactivée sur l’intégration Graph lorsque vous utilisez SCIM. Si elle est activée, l’intégration Graph crée tous les utilisateurs du tenant, ce qui contourne la limitation par affectation que vous avez configurée dans l’application d’entreprise.

Dépannage

Vérifiez que URL du locataire est exactement https://app.wavecnct.com/api/scim sans barre oblique finale, et que Jeton secret contient le jeton complet issu de la fenêtre Configurer SCIM. Un jeton ne peut être copié qu’à sa création, créez-en donc un nouveau si vous l’avez perdu. Les jetons sont supprimés lorsque l’organisation quitte l’abonnement Enterprise.
Entra provisionne par cycles d’environ 40 minutes. Utilisez Approvisionner à la demande sur l’utilisateur pour l’envoyer immédiatement, et consultez les Journaux d’approvisionnement pour le résultat. Une requête en échec signifie généralement qu’un attribut obligatoire est manquant : name.givenName, name.familyName, ou un e-mail principal lors d’une mise à jour.
Avec SCIM, l’utilisateur doit être affecté à l’application. S’il a été retiré, affectez-le à nouveau et Entra envoie active = true. Avec l’intégration Graph, la réactivation ne réactive jamais l’utilisateur. Contactez support@wavecnct.com pour le réactiver.
Lorsque SCIM crée un utilisateur dont l’e-mail appartient déjà à un compte Wave Connect personnel (hors organisation), et que le domaine de l’e-mail fait partie de vos domaines vérifiés, ce compte est transféré dans votre organisation et mis à jour au lieu d’en créer un nouveau. Sa carte et ses contacts existants sont conservés. Vérifiez le domaine avant de provisionner afin que ces comptes soient migrés plutôt que dupliqués.
Avec SCIM, l’e-mail de connexion est l’e-mail principal, que le mappage recommandé prend depuis mail. Avec l’intégration Graph, il s’agit de userPrincipalName (ou mail pour les invités). Si un utilisateur a un mail et un UPN différents, mappez plutôt userPrincipalName vers l’e-mail principal dans Entra, afin que les deux approches concordent.