Prérequis
- Vous devez disposer d'un accès SuperAdmin à Libraesva.
- Accès administrateur global du tenant Microsoft 365
- Vous avez besoin d'un connecteur Graph API créé dans ESG. Pour le créer, veuillez suivre le guide précédent Configuration des API Microsoft 365.
Configuration
Le processus de configuration comporte plusieurs étapes, veuillez les suivre dans l'ordre indiqué. Libraesva ESG propose une intégration simple pour tous les utilisateurs de Microsoft Outlook. Les versions Windows et Mac sont toutes deux prises en charge. En substance, le module complémentaire permet d'interagir avec votre quarantaine et de signaler un message comme malveillant ; toutefois, vous pouvez décider de supprimer certaines fonctionnalités lors de la création du fichier manifest.xml.[fruitful_alert type="alert-info"]REMARQUE : vous avez besoin d'un certificat TLS valide sur l'ESG pour que le module complémentaire Outlook fonctionne. Consultez la page Certificats du manuel.[/fruitful_alert]
Ajouter une autorisation API pour le module complémentaire Outlook
Configurer les Redirect URIs et l'URL de déconnexion Front-Channel
- Recherchez le portail App registrations comme indiqué :
- Recherchez votre App registration concernant Libraesva ESG et ouvrez-la
- Cliquez maintenant sur Authentication dans le menu de gauche :
- Cliquez sur Add a platform
- Choisissez l'option Single-page application (SPA)
- Saisissez votre https://<YOUR-ESG-HOSTNAME>/outlook-addin-assets/taskpane.html dans Redirect URI
- Cliquez sur Settings
- Saisissez votre https://<YOUR-ESG-HOSTNAME>/outlook-addin-assets/taskpane.html dans Front-Channel Logout URL
Configurer les autorisations API
- Cliquez maintenant sur API permissions dans le menu de gauche :
- Cliquez sur Add a permission
- Sélectionnez l'API Microsoft Graph
- Sélectionnez les autorisations suivantes sous Application permissions
- Mail.Read
- Sélectionnez les autorisations suivantes sous Delegate permissions
- offline_access
- openid
- profile
- Cliquez sur Done
- Cliquez sur Grant admin consent puis sur Yes dans la boîte de dialogue
Appliquer le consentement administrateur de l'application
- Allez à : App registration > Overview > faites défiler vers le bas > cliquez sur « Go to Enterprise applications »
- Allez à : Security > Permissions > cliquez sur « Grant admin consent for …. »
- Acceptez la demande d'autorisation
Création du fichier Manifest.xml
Récupérer l'ID de l'annuaire (Tenant)
- Recherchez le portail App registrations comme indiqué :
- Recherchez votre App registration concernant Libraesva ESG et ouvrez-la
- Notez l'ID de l'annuaire (Tenant) affiché dans le coin supérieur droit
Saisir l'ID de l'annuaire (Tenant) dans Libraesva ESG
- Allez dans Admin Area > Integrations > Microsoft 365
- Modifiez le connecteur
- Saisissez l'ID de l'annuaire (Tenant) dans la configuration du connecteur
- Vous pouvez maintenant générer le fichier Manifest.xml en cliquant sur le bouton correspondant
- Décidez quels paramètres inclure ou supprimer des fonctionnalités du module complémentaire
-
- Barre latérale « Quarantine » : permet à l'utilisateur de voir les messages actuellement stockés dans son environnement de quarantaine
-
- Bouton « Report as Bad » : permet à l'utilisateur de signaler un message comme malveillant directement depuis le module complémentaire, sans aucune autre action nécessaire (Documentation : Fonctionnement du bouton « Report as »)
Activer les API dans Libraesva ESG
- Connectez-vous à votre ESG
- Allez dans Admin Area -> Authentication -> Web Portal -> API Service
- Activez l'API Service
DÉPLOIEMENT MICROSOFT 365
Si vous devez déployer le module complémentaire automatiquement pour de nombreux utilisateurs, vous pouvez le faire de manière centralisée en vous connectant à Exchange Management Console.- Connectez-vous à votre tenant Microsoft 365 via le portail en ligne de Microsoft avec un compte administrateur
- dans le centre d'administration Microsoft 365, choisissez Settings > Integrated apps > Add-ins
- Cliquez sur + Deploy Add-in
- Cliquez sur « + Deploy Add-In »
- Sélectionnez « Upload custom apps »
- Sélectionnez « I have the manifest file (.xml) on this device »
- Sélectionnez le fichier Manifest.xml créé précédemment
- Cliquez sur Upload
- Sélectionnez « Everyone » pour déployer le module complémentaire sur l'ensemble du tenant
- Sélectionnez un ou plusieurs utilisateurs/groupes pour déployer le module complémentaire
- Cliquez sur Deploy
[fruitful_alert type="alert-info"]REMARQUE : le déploiement du module complémentaire à tous les utilisateurs peut prendre jusqu'à 72 heures en raison des délais de propagation de Microsoft. En cas de problème avec le déploiement, veuillez contacter le support Microsoft[/fruitful_alert]
- Sélectionnez Next puis Close
DÉPLOIEMENT EXCHANGE-ON-PREMISE
Si vous devez déployer le module complémentaire automatiquement pour de nombreux utilisateurs, vous pouvez le faire de manière centralisée en vous connectant à Exchange Management Console.- Connectez-vous à votre Microsoft Exchange ECP avec un compte administrateur.
- accédez à Organization puis add-ins
- Cliquez sur + (nouveau) – Add from URL
- Saisissez l'URL suivante : <your-hostname>/outlook-addin/manifest.xml
- Cliquez sur Install
- Modifiez Libraesva ESG Outlook-Add-In et activez-le
- Cliquez sur Save
[fruitful_alert type="alert-info"]REMARQUE : si vous obtenez l'erreur : « The app couldn't be downloaded » ouvrez le lien XML avec un navigateur sur votre PC et enregistrez-le comme fichier. Ensuite, lors de l'ajout du module complémentaire, sélectionnez Add from a file au lieu de Add from URL comme décrit ci-dessus.[/fruitful_alert]