Intégration des services - Module complémentaire Ad Hoc
- Last Updated: November 2, 2022
- 7 minute read
- MOVEit Transfer
- Version 2022
- Documentation
Configuration requise pour le serveur de messagerie Microsoft
Le module complémentaire MOVEit Transfer est construit sur l'architecture des modules complémentaires basés sur le Web de Microsoft. Pour l'utiliser dans votre entreprise, votre solution de messagerie Microsoft doit répondre aux exigences minimales des modules complémentaires basés sur le Web. Ces exigences sont les suivantes.
Les clients Outlook connectés à Microsoft 365 ou Outlook.com supportent de manière inhérente les compléments basés sur le Web. Cependant, pour les clients Outlook connectés à des installations sur site d'Exchange Server, les conditions suivantes s'appliquent.
- Le serveur doit être Exchange 2013 ou une version ultérieure.
- Les Web Services Exchange (EWS) doivent être activés et doivent être exposés à l'Internet. De nombreux modules complémentaires ont besoin du SAP pour fonctionner correctement.
- Le serveur doit disposer d'un certificat d'authentification valide pour que le serveur puisse émettre des jetons d'identité valides. Les nouvelles installations d'Exchange Server incluent un certificat d'authentification par défaut. Pour plus d'informations, voir Certificats numériques et cryptage dans Exchange 2016 et Set-AuthConfig.
Exigences d'intégration du serveur de transfert MOVEit
Avant de déployer ou de configurer les choses du point de vue d'Outlook ou d'Exchange, le serveur de transfert MOVEit attend les paramètres de configuration décrits dans cette section.
| Pour cette exigence... | Procédez comme suit... |
|---|---|
| Licence de transfert Ad Hoc de production |
|
| Le transfert Ad Hoc est activé dans l'interface Web. | Voir la section intitulée Modifier les paramètres de l'interface utilisateur. (Il s'agit d'un paramètre à l'échelle de l'organisation) |
| Un ou plusieurs utilisateurs doivent activer Ad Hoc Transfer. | Voir la section intitulée Activer Ad Hoc Transfert pour certaines organisations. |
| Partage des ressources entre origines (CORS) activé. |
Dans l'onglet Paramètres de l'utilitaire de configuration de MOVEit Transfer, ajoutez une entrée CORS pour permettre l'accès aux composants du module complémentaire : Meilleures pratiques : Fournissez une valeur personnalisée pour le dossier du module complémentaire hébergé. Actuellement, il est hébergé ici : https://moveit.addins.progress.com Remarque : Au minimum, le paramètre Basic doit être activé
|
|
Permettre aux utilisateurs de coupler l'authentification avec Outlook (facultatif) (Fournit aux utilisateurs d'Outlook l'option « Mémoriser mes informations », qui leur permet d'utiliser le module complémentaire Ad Hoc de MOVEit Transfer et de ne pas se connecter à MOVEit Transfer à chaque fois qu'ils ouvrent Outlook.) |
Voir Configurer les jetons de sécurité pour les applications externes. Vous pouvez vérifier ce paramètre dans : Paramètres de l'interface Web > Stratégies de sécurité - Auth. utilisateur - Applications de confiance |
| Le délai d'exécution est d'environ une demi-journée. | Après le déploiement dans les environnements O365 de vos utilisateurs, attendez-vous à ce qu'il faille au maximum environ 12 heures à un jour (bien que généralement moins) à un Microsoft O365 pour pousser le module complémentaire vers son environnement de production (et pour qu'il apparaisse dans les clients Outlook gérés de manière centralisée). |
Une fois que vous avez rempli les conditions requises pour le transfert MOVEit, comme indiqué dans le tableau, vous pouvez utiliser les outils cloud ou d'entreprise de Microsoft pour déployer le module complémentaire Ad Hoc de MOVEit Transfer pour les utilisateurs.
Déployer et gérer Ad Hoc de manière centralisée à l'aide de Microsoft 365 Admin Center
Les sites utilisant des boîtes aux lettres Exchange Online peuvent utiliser le déploiement centralisé des modules complémentaires de Microsoft.
Vous pouvez affecter le module d'extension Ad Hoc Outlook à la plupart des groupes pris en charge par Azure Active Directory, notamment :
- Groupes Microsoft 365
- Listes de distribution
- Groupes de sécurité
Avant le déploiement
Avant d'intégrer le MOVEit Transfer Ad Hoc Add-in for Outlook dans l'environnement de vos utilisateurs, suivez les instructions du tableau suivant :
| Pour cette exigence... | Procédez comme suit... |
|---|---|
| Permissions de l'administrateur O365 | Connectez-vous à Exchange en tant qu'administrateur global ou administrateur Exchange. |
| Les utilisateurs de votre organisation possèdent des comptes qui permettent l'enregistrement des applications. | La propriétéApp Registrations (Enregistrments d'appplications) est définie sur Yes (Oui) dans User Settings (Paramètres d'utilisateur) dans le centre d'aministration d'Azure Active Directory. |
Déployer en utilisant le centre d'administration
Vous pouvez accéder au centre d'administration de Microsoft 365 à partir de https://admin.microsoft.com. Vous avez besoin des droits d'administrateur de 365. Vérifiez auprès de votre administrateur Microsoft pour plus de détails.
Centre d'administration Microsoft (page des applications intégrées affichée)
- Dans le centre d'administration de Microsoft 365, cliquez sur Paramètres > Applications intégrées.
La page Accueil - Applications intégrées s'affiche.
- Cliquez sur l'hyperlien Modules complémentaires.
La page des modules complémentaires s'affiche.
- Cliquez sur Déployer le module complémentaire
Le panneau coulissant Déployer un nouveau module complémentaire s'affiche.
- Au bas du panneau Déployer le module complémentaire, cliquez sur Suivant.
- Chargez des applications personnalisées. Chargement à l'aide du fichier manifeste MOVEit.(https://moveit.addins.progress.com/transfer/outlook/manifest.xml)
Le panneau Configurer le module complémentaire s'affiche.
- Dans la section Affecter des utilisateurs, sélectionnez :
- Tout le monde
- Utilisateurs/groupes spécifiques
- Juste moi
- Dans la section Méthode de déploiement, choisissez un mode :
- Fixe (par défaut) : le module complémentaire est automatiquement déployé auprès des utilisateurs assignés.
- Disponible. Le module complémentaire est disponible pour être déployé (mais n'est pas installé sur le ruban Outlook de l'utilisateur)
- Facultatif. Le module complémentaire est déployé et présent dans le client Outlook de l'utilisateur, mais celui-ci peut le supprimer.
- Cliquez sur Déployer.
Déployer à l'aide de Cmdlets (PowerShell)
Pour gérer la disponibilité et la configuration du déploiement du module complémentaire MOVEit Transfer de manière programmatique, vous pouvez utiliser Windows PowerShell avec le module complémentaire O365 Centralized (O365CentralizedAddInDeployment).
- Référencez la bibliothèque qui fournit les méthodes d'administration O365.
Par exemple :
Import-Module -Name O365CentralizedAddInDeployment
- Créez une session de gestion.
Connect-OrganisationAddInService
- Fournissez des informations d'identification. (Si vous ne les fournissez pas en tant que propriétés PowerShell, Windows vous le demande de manière interactive).
Par exemple, créez une propriété d'informations d'identification :
$secpasswd = ConvertTo-SecureString "MaiKewlUneeqPasswd" -AsPlainText -Force
--où vous remplacez MaiKewlUneeqPasswd par votre mot de passe.
--et où vous créez un objet d'identification en utilisant la propriété d'identification(secpasswd) comme argument d'entrée pour la méthode qui crée un objet d'identification(mycredentials). Par exemple :
$mycredentials = New-Object System.Management.Automation.PSCredential ("myMsftAdmin@example.com", $secpasswd)
- Connectez-vous à O365.
Par exemple :
Connect-OrganizationAddInService -Credential $mycredentials
- Téléchargez le module complémentaire à l'aide du fichier manifeste.
Par exemple :
New-OrganizationAddIn -ManifestPath 'https://moveit.addins.progress.com/transfer/outlook/manifest.xml' -Locale 'en-US' -Members 'myExampleUser@example.com'
-Où
Obtenir le statut du module complémentaire (Centre d'administration)https://moveit.addins.progress.com/transfer/outlook/manifest.xmlest l'URL du fichier manifeste hébergé.Vous pouvez obtenir le statut de l'add-in MOVEit Transfer Ad Hoc pour Outlook à partir de l'un des sites suivants :
- Colonne d'état de la page Accueil > Applications intégrées .
- Colonne d'état de la page des compléments (Accueil > Modules complémentaires)
- Afficher la bascule d'état dans le panneau coulissant pour un complément spécifique (Accueil > Compléments [Module complémentaire MOVEit Add Hoc]
Accueil > Page des applications intégrées - Colonne d'état (O365 Admin Center)
Obtenir tous les détails et l'état du module d'extension (PowerShell one-liner)Pour obtenir tous les détails de l'extension Outlook de MOVEit Transfer pour votre organisation, y compris son état, vous pouvez exécuter un script d'une ligne à partir de PowerShell :
$Get-OrganizationAddIn -ProductId 05c2e1c9-3e1d-406e-9a91-e9ac64854143 | Format-List
--Où
05c2e1c9-3e1d-406e-9a91-e9ac64854143est l'ID du produit actuel pour le MOVEit Transfer Ad Hoc Add-in.
Personnaliser le module complémentaire
Vous pouvez personnaliser le texte et les icônes utilisés dans le module complémentaire en modifiant le fichier manifeste XML et en installant le module complémentaire à partir de celui-ci (option Upload from File [Télécharger depuis un fichier]) plutôt qu'à partir de l'URL. Cela vous permet de contrôler le texte et les opérations (boutons) dans Outlook et les icônes affichées sur ces boutons.
Les détails de la personnalisation sont fournis ci-dessous, mais les étapes de base sont les suivantes :
- Accédez au fichier du manifeste en ligne dans un navigateur Web
- Enregistrez le fichier manifeste XML localement afin de pouvoir le modifier.
- Dans la section Ressources du fichier XML Manifest, modifiez les Images, ShortStrings et LongStrings pour refléter vos personnalisations et enregistrez le fichier.
- Déployez le complément à l'aide du manifeste XML personnalisé en utilisant l'option Upload from File (Télécharger depuis un fichier) (plutôt que Upload from URL [Télécharger depuis une URL]).
Personnaliser en utilisant le manifeste
- Enregistrez une copie locale du fichier manifeste XML et ouvrez-le pour le modifier :
- Naviguez vers l'URL Progress du fichier manifeste XML dans un navigateur Web (https://moveit.addins.progress.com/transfer/outlook/manifest.xml)
- Faites un clic droit dans la fenêtre du navigateur et utilisez « Enregistrer sous » pour enregistrer une copie locale du fichier.
- Ouvrez le fichier dans un éditeur de texte et accédez à la section Ressources à la fin du fichier.
- Modifiez les Images, ShortStrings et LongStrings pour refléter vos personnalisations :La section Images contient les emplacements hébergés par Progress (URLS) pour chaque taille d'icône. Si vous souhaitez afficher votre propre icône, vous devrez disposer d'images pour chaque taille énumérée ci-dessous sur un site accessible au public, puis remplacer l'URL de l'image hébergée par Progress par votre propre URL d'image pour chaque taille d'icône.
<bt:Images> <bt:Image id="Icon.16x16" DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-16.png"/> <bt:Image id="Icon.32x32" DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-32.png"/> <bt:Image id="Icon.64x64" DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-64.png"/> <bt:Image id="Icon.80x80" DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-80.png"/> </bt:Images>Les sections ShortStrings et LongStrings contiennent les chaînes qui sont utilisées sur les boutons de commande et pour les infobulles. Pour modifier le texte qui s'affiche pour chacun des éléments, vous pouvez modifier la valeur par défaut de chacune des chaînes. La signification de chaque chaîne est assez évidente, mais pour comprendre où chacune des chaînes est utilisée dans Outlook, il peut être utile d'installer d'abord le module complémentaire tel quel, puis de faire vos modifications.
<bt:ShortStrings> <bt:String id="ComposeGroupLabel" DefaultValue="MOVEit Transfer"/> <bt:String id="TaskpaneButton.Label" DefaultValue="Create Secure Package"/> <bt:String id="ReadGroupLabel" DefaultValue="MOVEit Transfer"/> <bt:String id="ReadDialogButton.Label" DefaultValue="View Secure Package"/> </bt:ShortStrings> <bt:LongStrings> <bt:String id="TaskpaneButton.Tooltip" DefaultValue="Create and send files and messages securely using MOVEit Transfer"/> <bt:String id="ReadDialogButton.Tooltip" DefaultValue="View the secure package associated with a 'New Package' notification"/> </bt:LongStrings>
Déployer le module complémentaire avec vos personnalisations
Dans un premier temps, déployez le module complémentaire sur un seul utilisateur et vérifiez que les modifications qui y sont apportées sont conformes à vos attentes (Vous pouvez le faire à partir de la commande Obtenir des modules complémentaires de votre barre d'outils Outlook.). Une fois que vous êtes satisfait de vos personnalisations, déployez le complément aux autres utilisateurs en suivant les étapes décrites ci-dessus, mais en utilisant le fichier manifeste personnalisé plutôt que l'URL du CDN Progress pour le fichier manifeste standard.