Dienstintegration – Ad Hoc Add-in
- Last Updated: November 2, 2022
- 6 minute read
- MOVEit Transfer
- Version 2022
- Documentation
Anforderungen für den Microsoft Mail-Server
Das MOVEit Transfer-Add-in basiert auf der webbasierten Add-in-Architektur von Microsoft. Zum Einsatz im Unternehmen muss Ihre Microsoft-Mail-Lösung daher die Mindestanforderungen für webbasierte Add-ins erfüllen. Dies sind die Mindestanforderungen:
Outlook-Clients, die an Microsoft 365 oder Outlook.com angebunden sind, unterstützen webbasierte Add-ins ab Werk. Für Outlook-Clients, die an Installationen von Exchange Server vor Ort angebunden sind, gelten folgende Bedingungen.
- Es muss sich mindestens um Exchange 2013 handeln.
- Exchange Web Services (EWS) müssen aktiviert sein und das Internet erreichen können. Für viele Add-ins ist es erforderlich, dass EWS richtig funktioniert.
- Der Server benötigt ein gültiges Authentifizierungszertifikat für den Server, um gültige Identitäts-Token ausstellen zu können. Neue Installationen von Exchange Server enthalten ein Standard-Authentifizierungszertifikat. Weitere Informationen finden Sie unter „Digital certificates and encryption in Exchange 2016 and Set-AuthConfig“ (Digitale Zertifikate und Verschlüsselung in Exchange 2016 und Set-AuthConfig) in der Microsoft-Hilfe.
Integrationsanforderungen für MOVEit Transfer Server
Vor der Bereitstellung bzw. Konfiguration von Outlook oder Exchange müssen die in diesem Abschnitt aufgeführten Konfigurationseinstellungen von MOVEit Transfer Server vorgenommen werden.
| Anforderung... | Vorgehensweise... |
|---|---|
| Ad Hoc Transfer-Lizenz für Produktionsumgebungen |
|
| Ad Hoc Transfer ist in der Web-Benutzeroberfläche aktiviert. | Weitere Informationen finden Sie unter „Einstellungen für Benutzeroberfläche ändern“. (Hierbei handelt es sich um eine organisationsweite Einstellung.) |
| Bei mindestens einem Benutzer muss Ad Hoc Transfer aktiviert sein. | Weitere Informationen finden Sie im Abschnitt „Ad Hoc Transfer für ausgewählte Organisationen aktivieren“. |
| Cross Origin Resource Sharing (CORS) ist aktiviert. |
Fügen Sie auf der Registerkarte Settings (Einstellungen) im Konfigurationsprogramm von MOVEit Transfer einen CORS-Eintrag hinzu, so dass auf die Add-in-Komponenten zugegriffen werden kann: Best Practice: Geben Sie einen benutzerdefinierten Wert für den gehosteten Add-in-Ordner an. Derzeit wird er hier gehostet: https://moveit.addins.progress.com Anmerkung: Minimum: Einstellung Basic (Einfach) muss aktiviert sein
|
|
Benutzern die Kopplung der Authentifizierung mit Outlook ermöglichen (optional) (Aktiviert die Option „Anmeldeinformationen speichern“ für Outlook-Benutzer. Damit kann das MOVEit Transfer Ad Hoc Add-in verwendet werden, ohne dass sich Benutzer jedes Mal bei MOVEit Transfer anmelden müssen, wenn Outlook geöffnet wird.) |
Weitere Informationen finden Sie unter „Sicherheits-Token für externe Anwendungen konfigurieren“. Sie können diese Einstellung hier überprüfen: WebUI SETTINGS > Security Policies – User Auth – Trusted Applications (EINSTELLUNGEN > Sicherheitsrichtlinien – Benutzerauthentifizierung – Vertrauenswürdige Anwendungen) |
| Vorlaufzeit von ca. einem halben Tag einplanen. | Nach der Bereitstellung in den O365-Umgebungen der Benutzer kann es bis zu ca. 12 Stunden oder einen Tag dauern (in der Regel jedoch weniger lang), bis die Add-ins in der Produktionsumgebung gepusht wurden (und das Add-in in den zentral verwalteten Outlook-Clients angezeigt wird). |
Wenn die in der Tabelle aufgeführten Anforderungen für MOVEit Transfer erfüllt wurden, können Sie das MOVEit Transfer Ad Hoc Add-in für Benutzer mit den Cloud- bzw. Enterprise-Werkzeugen von Microsoft bereitstellen.
Ad Hoc mit Microsoft 365 Admin Center zentral bereitstellen und verwalten
Standorte mit Exchange-Online-Postfächern können die zentrale Bereitstellung für Add-ins von Microsoft nutzen.
Das Ad Hoc Outlook-Add-in kann den meisten Gruppen zugewiesen werden, die von Azure Active Directory unterstützt werden, z. B.:
- Microsoft 365-Gruppen
- Verteilerlisten
- Sicherheitsgruppen
Vorbereitung der Bereitstellung
Prüfen Sie vor der Bereitstellung des MOVEit Transfer Ad Hoc Add-ins for Outlook in der Umgebung Ihrer Benutzer die Anforderungen in der Tabelle unten:
| Anforderung... | Vorgehensweise... |
|---|---|
| Administrator-Berechtigungen für O365 | Melden Sie sich entweder als globaler Administrator oder als Exchange-Administrator bei Exchange an. |
| Benutzer in der Organisation haben Konten, bei denen eine App-Registrierung zulässig ist. | Die Eigenschaft App-Registrierungen in den Benutzereinstellungen im Azure Active Directory Admin Center muss auf Ja gestellt sein. |
Bereitstellung mit Admin Center
Sie finden das Microsoft 365 Admin Center unter https://admin.microsoft.com. Sie benötigen Administratorberechtigungen für Microsoft 365. Details erhalten Sie beim Microsoft-Administrator.
Microsoft Admin Center (Seite „Integrierte Apps“)
- Klicken Sie im Microsoft 365 Admin Center auf Einstellungen > Integrierte Apps.
Die Seite „Start – Integrierte Apps“ wird angezeigt.
- Klicken Sie auf den Hyperlink Add-ins.
Die Seite „Add-ins“ wird angezeigt.
- Klicken Sie auf Add-in bereitstellen.
„Neues Add-in bereitstellen“ wird angezeigt.
- Klicken Sie im unteren Bereich des Bereitstellungsfensters auf Weiter.
- Benutzerdefinierte Apps hochladen. Laden Sie das Add-in mit der MOVEit-Manifest-Datei hoch. (https://moveit.addins.progress.com/transfer/outlook/manifest.xml)
Das Fenster Add-in konfigurieren wird angezeigt.
- Wählen Sie eine Option im Abschnitt „Benutzer zuweisen“ aus:
- Alle
- Bestimmte Benutzer/Gruppen
- Nur ich
- Wählen Sie unter „Bereitstellungsmethode“ einen Modus aus:
- Fest (Standard) Das Add-in wird automatisch zugewiesenen Benutzern bereitgestellt.
- Verfügbar. Das Add-in steht zur Bereitstellung zur Verfügung (wird jedoch nicht auf dem Outlook-Band der Benutzer installiert).
- Optional. Das Add-in wird bereitgestellt und im Outlook-Client des Benutzers angezeigt, aber der Benutzer kann es entfernen.
- Klicken Sie auf „Bereitstellen“.
Bereitstellung mit Cmdlets (PowerShell)
Wenn Sie die Bereitstellung und Konfiguration des MOVEit Transfer Add-ins programmatisch verwalten möchten, können Sie Windows PowerShell mit dem zentralisierten Add-in-Modul von O365 (O365CentralizedAddInDeployment) kombinieren.
- Verweisen Sie auf die Bibliothek, die O365-Admin-Methoden zur Verfügung stellt.
Beispiel:
Import-Module -Name O365CentralizedAddInDeployment
- Erstellen Sie eine Management-Sitzung.
Connect-OrganizationAddInService
- Geben Sie die Anmeldeinformationen an. (Wenn Sie diese nicht als PowerShell-Eigenschaften angeben, fragt Windows sie interaktiv ab.)
Beispiel – erstellen Sie eine Anmeldeinformationen-Eigenschaft:
$secpasswd = ConvertTo-SecureString "MaiKewlUneeqPasswd" -AsPlainText -Force
– Ersetzen Sie hier MaiKewlUneeqPasswd mit Ihren Kennwort.
– und erstellen Sie ein Anmeldeinformationen-Objekt, indem die Anmeldeinformationen-Eigenschaft (secpasswd) als Eingangsargument für die Methode verwendet wird, die ein Anmeldeinformationen-Objekt (mycredentials) erstellt. Beispiel:
$mycredentials = New-Object System.Management.Automation.PSCredential ("myMsftAdmin@example.com", $secpasswd)
- Stellen Sie eine Verbindung mit O365 her.
Beispiel:
Connect-OrganizationAddInService -Credential $mycredentials
- Laden Sie das Add-in mit der Manifest-Datei hoch.
Beispiel:
New-OrganizationAddIn -ManifestPath 'https://moveit.addins.progress.com/transfer/outlook/manifest.xml' -Locale 'en-US' -Members 'myExampleUser@example.com'
– Hier ist
Status des Add-ins abrufen (Admin Center)https://moveit.addins.progress.com/transfer/outlook/manifest.xmldie URL der gehosteten Manifest-Datei.Sie können den Status des MOVEit Transfer Ad Hoc Add-ins for Outlook hier abrufen:
- Spalte Status auf der Seite Start > Integrierte Apps.
- Spalte Status auf der Add-ins-Seite (Home > Add-ins)
- Umschalter Status für ein konkretes Add-in (Start > Add-ins [MOVEit Add Hoc Add-in]
Start > Integrierte Apps – Spalte „Status“ (O365 Admin Center)
Vollständige Details und Status des Add-ins abrufen (einzeiliges PowerShell-Skript)Umfassende Details zum MOVEit Transfer Outlook-Add-in für Ihre Organisation und deren Status können Sie mit folgendem einzeiligen PowerShell-Skript abrufen:
$Get-OrganizationAddIn -ProductId 05c2e1c9-3e1d-406e-9a91-e9ac64854143 | Format-List
– Hier ist
05c2e1c9-3e1d-406e-9a91-e9ac64854143die aktuelle Produkt-ID für das MOVEit Transfer Ad Hoc Add-in.
Add-in anpassen
Sie können Text und Symbole, die im Add-in verwendet werden, anpassen, indem Sie die XML-Manifest-Datei bearbeiten und das Add-in daraus (mit der Option Aus Datei hochladen) statt über die URL installieren. Damit können Sie Text und Vorgänge (Schaltflächen) in Outlook und die Symbole, die auf diesen Schaltflächen angezeigt werden, steuern.
Genauere Angaben zur Anpassung finden Sie unten. Zunächst ein Überblick über die grundlegenden Schritte:
- Öffnen Sie die Online-Manifest-Datei in einem Webbrowser.
- Speichern Sie die XML-Manifest-Datei auf einem Computer, damit sie bearbeitet werden kann.
- Nehmen Sie im Abschnitt „Resources“ der XML-Manifest-Datei in den Bereichen „Images“, „ShortStrings“ und „LongStrings“ die gewünschten Änderungen vor und speichern Sie die Datei.
- Stellen Sie das Add-in mit der angepassten XML-Manifest-Datei über die Option Aus Datei hochladen (statt Von URL hochladen) bereit.
Manifest-Datei anpassen
- Speichern Sie eine Kopie der XML-Manifest-Datei auf dem Computer und öffnen Sie sie zur Bearbeitung:
- Öffnen Sie die Progress-URL zur XML-Manifest-Datei in einem Webbrowser (https://moveit.addins.progress.com/transfer/outlook/manifest.xml).
- Klicken Sie mit der rechten Maustaste in das Browser-Fenster und speichern Sie die Datei mit „Speichern unter“ auf dem Computer.
- Öffnen Sie die Datei in einem Text-Editor und gehen Sie zum Abschnitt „Resources“ am Ende der Datei.
- Nehmen Sie im Bereich „Images“, „ShortStrings“ und „LongStrings“ die gewünschten Änderungen vor:Im Bereich „Images“ befinden sich die von Progress gehosteten Speicherorte (URLS) für die einzelnen Symbolgrößen. Wenn Sie eigene Symbole verwenden möchten, benötigen Sie Bilder für jede unten aufgeführte Größe an einem öffentlich zugänglichen Speicherort. Ersetzen Sie dann die von Progress gehostete Bild-URL mit der eigenen Bild-URL für die einzelnen Größen.
<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>Im Bereich „ShortStrings“ und „LongStrings“ sind die Texte auf den Befehlsschaltflächen und für QuickInfos enthalten. Bearbeiten Sie „DefaultValue“ für die einzelnen Texte, um den Text zu ändern, der für die einzelnen Elemente angezeigt wird. Die Bedeutung der einzelnen Texte ist in der Regel selbsterklärend. Um zu sehen, wo die einzelnen Texte in Outlook verwendet werden, kann es hilfreich sein, dass Add-in zunächst unverändert in Outlook zu installieren und dann die Änderungen vorzunehmen.
<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>
Add-in mit Änderungen bereitstellen
Stellen Sie das Add-in zunächst nur für einen Benutzer bereit, um zu prüfen, dass die Änderungen Ihren Wünschen entsprechen (über den Befehl „Add-ins abrufen“ in der Outlook-Symbolleiste). Sobald Sie die Änderungen zufriedenstellend geprüft haben, stellen Sie das Add-in an alle übrigen Benutzer bereit. Nutzen Sie dazu die oben aufgeführten Schritte, aber verwenden Sie die angepasste Manifest-Datei statt der Progress-CDN-URL für die Standard-Manifest-Datei.