Intégration Outlook¶
Une intégration Outlook peut être ajoutée à votre installation de Drovio Server. Elle permet aux utilisateurs de planifier des réunions Drovio directement depuis leur calendrier Outlook : un bouton Add a Drovio meeting insère le lien pour rejoindre dans le rendez-vous, et l'envoi du rendez-vous tient la réunion à jour de sa date, de ses participants et de sa récurrence. Vous devrez créer une inscription d'application dans Microsoft Entra ID.
Le complément fonctionne dans Outlook sur le web, le nouvel Outlook pour Windows, Outlook classique pour Windows et Outlook pour Mac. Il connecte ses utilisateurs avec leur compte Microsoft : la première fois, ils se connectent aussi une fois à votre instance Drovio Server, pour relier les deux comptes. Leur compte Drovio doit déjà exister.
HTTPS uniquement
Outlook ne charge les compléments qu'en HTTPS. Votre Drovio Server doit être joignable en HTTPS depuis les machines qui exécutent Outlook.
Déclarer le complément dans Microsoft Entra ID¶
Dans la suite, <your server> désigne le nom d'hôte de l'URL publique de votre
Drovio Server, par exemple drovio.example.com.
Inutile de construire à la main l'URI de redirection et l'Application ID URI : la page Outlook du panneau d'administration affiche les deux, prêts à copier. Ouvrez Integrations, puis Configure sur la carte Outlook.
Créer l'inscription d'application¶
Dans le portail Azure, ouvrez Microsoft Entra ID, puis App registrations, et New registration.
| Champ | Valeur |
|---|---|
| Name | Le nom de votre choix, par exemple Drovio Outlook |
| Supported account types | Accounts in this organizational directory only (single tenant) |
| Redirect URI | Single-page application (SPA), puis brk-multihub://<your server> |
Dans le volet Overview, relevez :
| Valeur dans Entra ID | Utilisée comme |
|---|---|
| Application (client) ID | client_id |
| Directory (tenant) ID | tenant_id |
Aucun secret client n'est nécessaire : le complément ne s'authentifie jamais en tant qu'application.
Exposer l'API¶
Sous Expose an API, cliquez sur Add à côté de l'Application ID URI, et saisissez l'URI que le panneau d'administration affiche une fois l'Application ID enregistré :
api://<your server>/<client id>
Puis Add a scope :
| Champ | Valeur |
|---|---|
| Scope name | access_as_user |
| Who can consent | Admins and users |
| Admin consent display name | Use Drovio as the user |
| Admin consent description | Lets Outlook sign the user in to Drovio. |
| State | Enabled |
Toujours sous Expose an API, cliquez sur Add a client application,
saisissez ea5a67f6-b6f3-4338-b240-c655ddc3cc8e et cochez la portée
access_as_user. Cet identifiant désigne l'ensemble des applications Office, qui
demandent un jeton pour le compte du complément lorsque Outlook ne dispose pas de
l'authentification d'application imbriquée (nested app authentication).
Demander des jetons en version 2¶
Sous Manifest, passez requestedAccessTokenVersion à 2, dans la section
api, puis Save. Drovio Server vérifie les jetons tels qu'Entra ID les émet
dans cette version.
Accorder le consentement¶
Sous API permissions, Add a permission, ouvrez APIs my organization
uses, retrouvez l'inscription d'application par son nom et ajoutez sa
permission déléguée access_as_user. Cliquez ensuite sur Grant admin consent
for <your tenant>, ce qui épargne à chaque utilisateur la demande de
consentement.
Configurer l'intégration¶
Dans le panneau d'administration, ouvrez Integrations, puis Configure sur la carte Outlook.
| Champ | D'où il vient |
|---|---|
| Status | Enabled ou Disabled |
| Application ID | Le client_id relevé dans Entra ID |
| Tenant ID | Le tenant_id relevé dans Entra ID |
L'enregistrement prend effet dès la requête suivante, sans redémarrage. Une fois l'Application ID enregistré, la page affiche l'Application ID URI et l'URI de redirection que l'inscription d'application doit déclarer.
Passer le statut à Disabled refuse les requêtes venant d'Outlook, tout en laissant la page accessible pour configurer l'intégration.
Référence de configuration¶
Voici les clés de l'élément outlook de settings.conf, si vous préférez
l'éditer directement. En cluster, le panneau d'administration ne peut pas les
enregistrer : chaque serveur lit son propre fichier de configuration, qu'il faut
éditer sur chacun d'eux.
| Clé | Défaut | Signification |
|---|---|---|
enabled |
false |
Active l'intégration |
client_id |
Application (client) ID de l'inscription d'application | |
tenant_id |
Directory (tenant) ID de l'inscription d'application, indispensable pour activer l'intégration | |
manifest_id |
Identifie le complément dans Microsoft 365. Fixé au premier enregistrement, à ne pas modifier |
Déployer le complément¶
Le complément est décrit par un manifest qui pointe vers votre serveur. Dans la page Outlook du panneau d'administration, la section Manifest permet de le télécharger, rempli avec la configuration enregistrée.
Dans le centre d'administration Microsoft 365, allez dans Settings, puis Integrated apps, et Upload custom apps. Choisissez Office Add-in, téléversez le manifest, puis sélectionnez les utilisateurs ou les groupes auxquels le déployer. Le déploiement met jusqu'à 24 heures à atteindre Outlook, parfois davantage pour Outlook classique pour Windows.
Utiliser le complément¶
Dans un rendez-vous dont l'utilisateur est l'organisateur, le ruban affiche un groupe Drovio :
| Bouton | Ce qu'il fait |
|---|---|
| Add a Drovio meeting | Crée la réunion Drovio à partir du rendez-vous, place le lien pour rejoindre dans le lieu et l'ajoute à l'invitation |
| Settings | Affiche le compte Drovio auquel le complément est connecté, et permet de se déconnecter |
À l'envoi du rendez-vous, le complément met à jour la réunion Drovio avec les modifications faites depuis : sujet, description, dates, participants et récurrence. Drovio n'envoie aucune invitation de son côté : l'invitation Outlook est celle que reçoivent les participants.
Outlook sur le web et le nouvel Outlook
Dans Outlook sur le web et le nouvel Outlook pour Windows, le complément ne s'exécute à l'envoi que si le rendez-vous est ouvert dans sa propre fenêtre, avec Open in new window. Depuis le formulaire qui s'ouvre dans la fenêtre principale, ou lorsque le rendez-vous est transféré, les modifications faites après l'ajout de la réunion Drovio ne lui parviennent pas.