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.
Laquelle choisir ?
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.- 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[].valuedéfini surUSER,ADMINouOWNER(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
departmentn’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
localedoit ê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. LedisplayName 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 envoieactive = 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
SUSPENDEDdans Utilisateurs. - Sa carte NFC, son profil et ses contacts sont conservés.
- Il compte toujours comme un siège.
active = true et réactive le compte.
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.- Depuis Intégrations
- Depuis Utilisateurs
- Accédez à Intégrations → Microsoft Entra ID et cliquez sur Installer l’application.
- 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.
- Connectez-vous avec un compte Microsoft pouvant accorder le consentement administrateur sur le tenant, et acceptez la demande de consentement.
Permissions
Wave Connect demande les étendues déléguéesopenid, 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
Tester la connexion échoue dans Entra
Tester la connexion échoue dans Entra
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.Un utilisateur est affecté mais n'apparaît pas encore dans Wave Connect
Un utilisateur est affecté mais n'apparaît pas encore dans Wave Connect
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.Un utilisateur a été réactivé dans Entra mais reste désactivé
Un utilisateur a été réactivé dans Entra mais reste désactivé
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.L'utilisateur possédait déjà un compte Wave Connect personnel
L'utilisateur possédait déjà un compte Wave Connect personnel
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.
L'e-mail de connexion ne correspond pas à l'UPN
L'e-mail de connexion ne correspond pas à l'UPN
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.