🪟 Connexion Microsoft 365

Le connecteur Microsoft 365 est un ensemble d'identifiants tiers (TPC) qui relie votre plateforme Voome à votre locataire (tenant) Microsoft Entra (Azure AD). Une fois configuré, Voome peut lire en votre nom les calendriers et les salles de votre organisation, ainsi que (en option) les contenus Power BI, SharePoint et OneDrive.

Vous configurez la connexion depuis un formulaire Voome unique (Paramètres → Plateforme → Identifiants tiers → ajouter une connexion Microsoft 365). Ce formulaire est divisé en trois étapes. Ce guide vous accompagne dans l'inscription de l'application correspondante dans Azure et vous indique où reporter chaque valeur dans Voome.

Ce que vous pouvez activer

Fonctionnalité	Étape Voome	Autorisations Microsoft concernées
Agenda Microsoft Sync	Étape 1 (obligatoire)	Calendrier et salles Microsoft Graph
Booking Microsoft Sync	Étape 1 (obligatoire)	Calendrier et salles Microsoft Graph
Tableaux de bord Power BI	Étape 2 (facultative, déléguée)	Power BI Service
SharePoint	Étape 2 (facultative, déléguée)	Sites SharePoint
Synchronisation de documents OneDrive	Étape 2 (facultative, déléguée)	Microsoft Graph + utilisateur délégué

L'étape 1 est toujours obligatoire

La synchronisation des calendriers et des réservations de l'étape 1 constitue le socle de la connexion. Les champs délégués de l'étape 2 s'ajoutent à l'étape 1, sans jamais la remplacer.

Avant de commencer

Vous avez besoin de :

• Un locataire Microsoft Entra (Azure AD).
• Un compte autorisé à inscrire des applications et à accorder le consentement administrateur dans ce locataire (généralement un administrateur général ou un administrateur d'applications).
• Le formulaire de connexion Voome ouvert, afin d'en copier l'URI de redirection et d'y coller vos valeurs Azure.

Sens de la confiance

L'inscription de l'application établit une relation de confiance unidirectionnelle : votre application fait confiance à la plateforme d'identités Microsoft, et non l'inverse.

---

Partie 1 : inscrire l'application dans Microsoft Entra (Azure AD)

1. Inscrire l'application

1. Connectez-vous au portail Azure.
2. Si vous avez accès à plusieurs locataires, utilisez le filtre Répertoire + abonnement (Directory + subscription) dans le menu supérieur pour sélectionner le locataire dans lequel inscrire l'application.
3. Recherchez et sélectionnez Microsoft Entra ID (anciennement Azure Active Directory).
4. Sous Gérer (Manage), sélectionnez Inscriptions d'applications → Nouvelle inscription (App registrations → New registration).
5. Saisissez un Nom d'affichage, par exemple Voome Connector.
6. Choisissez qui peut utiliser l'application (les types de comptes pris en charge). Pour une seule organisation, le choix habituel est Comptes dans cet annuaire d'organisation uniquement (Accounts in this organizational directory only).
7. Laissez le champ URI de redirection (Redirect URI) vide pour l'instant. Vous le renseignerez à l'étape suivante.
8. Sélectionnez Inscrire (Register).

Après l'inscription, le volet Vue d'ensemble (Overview) affiche l'ID d'application (client) et l'ID de l'annuaire (locataire). Vous copierez ces deux valeurs dans Voome plus tard.

2. Ajouter l'URI de redirection

1. Dans Voome, ouvrez Étape 1 · Connexion à Microsoft et copiez l'URI de redirection. Elle ressemble à ceci :

   https://cms.voome.com/signin/ms/voome/

2. Dans le portail Azure, ouvrez votre application (Voome Connector) et, sous Gérer, sélectionnez Authentification (Authentication).

3. Sélectionnez Ajouter une plateforme → Web (Add a platform → Web).

4. Collez l'URI de redirection copiée depuis Voome dans le champ URI de redirection (Redirect URIs).

5. Sélectionnez Configurer (Configure).

Copiez l'URI depuis le formulaire de votre propre locataire

Copiez toujours l'URI de redirection depuis le formulaire Voome plutôt que de la saisir à la main. Vous avez ainsi la garantie d'une correspondance exacte, condition exigée par Microsoft pour que la connexion aboutisse.

3. Créer un secret client

Le secret client permet à l'application de s'authentifier en son propre nom, sans aucune intervention d'un utilisateur à l'exécution.

1. Dans votre application, sélectionnez Certificats & secrets → Nouveau secret client (Certificates & secrets → New client secret).
2. Ajoutez une description (par exemple, Voome).
3. Choisissez une expiration. Optez pour la durée la plus longue autorisée par votre politique de sécurité, car la connexion cesse de fonctionner à l'expiration du secret.
4. Sélectionnez Ajouter (Add).
5. Copiez immédiatement la Valeur (Value) du secret.

Copiez dès maintenant la Valeur du secret, pas l'ID du secret

La Valeur du secret n'est affichée qu'une seule fois et ne peut plus être récupérée une fois la page quittée. Veillez à copier la Valeur et non l'ID du secret (Secret ID) : ce sont deux éléments différents, et Voome a besoin de la Valeur.

4. Configurer les autorisations d'API

1. Dans votre application, sous Gérer, sélectionnez Autorisations de l'API → Ajouter une autorisation (API permissions → Add a permission).
2. Ajoutez les autorisations ci-dessous selon les fonctionnalités que vous prévoyez d'utiliser, puis sélectionnez Ajouter des autorisations (Add permissions) pour chaque groupe.

Obligatoire : Microsoft Graph (déléguées)

Ces autorisations alimentent la synchronisation Agenda et Booking et sont nécessaires pour toute connexion.

• User.Read
• Calendars.ReadWrite
• Calendars.ReadWrite.Shared
• Place.Read.All
• email
• offline_access
• profile

Facultatif : Office 365 Exchange Online (déléguées)

À ajouter uniquement si vous devez synchroniser des calendriers Exchange Online.

• Calendars.ReadWrite.All
• Calendars.ReadWrite.Shared

Facultatif : Power BI Service (déléguées)

À ajouter uniquement si vous souhaitez intégrer du contenu Power BI.

• Dashboard.Read.All
• Report.Read.All

Facultatif : SharePoint (déléguées)

À ajouter uniquement si vous devez synchroniser SharePoint.

• Sites.Read.All
• Sites.Read.Shared

5. Accorder le consentement administrateur

De retour sur la page Autorisations de l'API, sélectionnez Accorder un consentement d'administrateur pour <votre locataire> (Grant admin consent for <your tenant>) et confirmez. Vous donnez ainsi votre consentement aux autorisations configurées au nom de toute l'organisation, de sorte que les utilisateurs ne soient pas sollicités individuellement par la suite.

astuce

Il est vivement recommandé d'accorder le consentement administrateur. Sans lui, les autorisations déléguées restent à l'état « non accordé » et la connexion risque d'échouer.

---

Partie 2 : reporter les valeurs dans Voome

Revenez au formulaire Connexion Microsoft 365 de Voome et remplissez-le.

Nom des identifiants

Donnez à la connexion un nom facilement reconnaissable (par exemple, Contoso Microsoft 365). Il s'agit simplement d'un libellé dans Voome.

Étape 1 · Connexion à Microsoft (toujours obligatoire)

Ces valeurs proviennent de l'inscription d'application que vous venez de créer.

Champ	Où le trouver
URI de redirection	Déjà fournie par Voome. Vous l'avez collée dans Azure à la partie 1, étape 2.
ID de locataire Azure (Azure Tenant Id)	L'ID de l'annuaire (locataire) sur la page Vue d'ensemble de l'application. Utilisez la valeur littérale organizations pour le processus de délégation utilisateur.
ID d'application (client_id)	L'ID d'application (client) sur la page Vue d'ensemble de l'application.
Secret d'application (client_secret)	La Valeur du secret issue de Certificats & secrets (et non l'ID du secret).

Étape 2 · Accès délégué (facultatif)

Ne remplissez cette étape que pour les fonctionnalités qui agissent au nom d'un utilisateur : tableaux de bord Power BI, SharePoint et synchronisation de documents OneDrive.

Champ	Description
Utilisateur d'accès délégué	L'identifiant de connexion de l'utilisateur Microsoft au nom duquel la connexion agit.
Mot de passe d'accès délégué	Le mot de passe de cet utilisateur.

Tester la connexion Power BI

Pour vérifier que les identifiants délégués peuvent accéder à Power BI, collez un ID de tableau de bord ou de rapport valide (au format XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX) dans le champ Tester la connexion Power BI et sélectionnez Tester Power BI.

Enregistrer

Sélectionnez Enregistrer. La connexion est désormais disponible pour les fonctionnalités Voome que vous avez activées.

---

Dépannage

• La connexion échoue avec une erreur de redirection. L'URI de redirection dans Azure ne correspond pas exactement à celle de Voome. Copiez-la à nouveau depuis le formulaire Voome et vérifiez qu'elle est bien ajoutée sous la plateforme Web.
• Les autorisations apparaissent comme « non accordées ». Revenez à Autorisations de l'API et sélectionnez Accorder un consentement d'administrateur.
• La connexion fonctionnait, puis s'est arrêtée. Le secret client a probablement expiré. Créez un nouveau secret dans Certificats & secrets et collez sa Valeur dans Voome.
• Le test Power BI échoue. Vérifiez que l'utilisateur délégué de l'étape 2 a accès au rapport, que les autorisations Power BI Service ont été ajoutées et que le consentement administrateur a été accordé.