MailStore Outlook App Deployment: Unterschied zwischen den Versionen

[unmarkierte Version][gesichtete Version]
 
(19 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
Um die MailStore Outlook App für das neue Outlook nutzen zu können, muss ein auf Ihre Installation angepasstes Manifest generiert werden.
 
Um die MailStore Outlook App für das neue Outlook nutzen zu können, muss ein auf Ihre Installation angepasstes Manifest generiert werden.
  
−
Das Manifest beschriebt, wie Ihre MailStore Installation von innerhalb Outlooks zu erreichen ist.
+
Das Manifest beschreibt, wie Ihre MailStore Installation von innerhalb Outlooks zu erreichen ist.
  
−
Dieses Manifest kann in den App-Store Ihres Microsoft 365-Mandanten hochgeladen werden. Damit ist die MailStore Outlook App im Outlook App-Store verfügbar und kann entweder von Administratoren den Benutzern per Richtlinie zugewiesen werden, oder die Benutzer können die App aus dem App Store ihrer Outlook-Installation hinzufügen.
+
Dieses Manifest kann in den App-Store Ihres Microsoft 365-Mandanten hochgeladen werden. Damit ist die MailStore Outlook App im Outlook App-Store verfügbar und kann entweder zentral von Administratoren den Benutzern per Richtlinie zugewiesen werden, oder die Benutzer können die App aus dem App Store ihrer Outlook-Installation hinzufügen.
  
−
Alternativ zum App-Store kann das Manifest den Endbenutzern zur Verfügung gestellt werden, damit diese es manuell in Ihr Outlook laden können.
+
Auf Grund von Caching in der Infrastruktur von Microsoft 365 kann es vorkommen, dass Änderungen nicht sofort sichtbar werden. Diese Verzögerungen können sowhl im Microsoft Teams Admin Center als auch im neuen Outlook auftreten.
  
−
== Generierung der Manifest-Datei ==
+
== Voraussetzungen ==
  
−
Das Manifest enthält neben dem Servernamen, unter dem MailStore erreichbar ist auch eine eindeutige ID, die die App im Outlook App-Store identifiziert. Die ID wird von MailStore permanent gespeichert, damit diese bei der Generierung des Manifests konstant bleibt und die App weiterhin über dieselbe ID identifiziert werden kann. Dies ermöglicht das Aktualisieren der App, falls sich der Hostname, unter dem MailStore erreichbar, ändern sollte.
+
* Das neue Outlook muss mit einem Microsoft 365-Mandanten verbunden sein.
 +
* Administrativer Zugriff auf den Microsoft 365-Mandanten.
 +
* MailStore benötigt ein vertrauenswürdiges Zertifikat. Dies kann von [[Verwendung_von_Lets_Encrypt_Zertifikaten|Let's Encrypt]] oder [[Verwendung_eigener_SSL_Zertifikate|einer anderen Zertifizierungsstelle]] stammen.
  
−
Manifest-Dateien müssen daher immer auf dem Server generiert werden, zu dem sich die sich die dazugehörige Outlook-App verbinden soll.
+
== Generierung des Manifests ==
  
−
Damit Outlook eine Verbindung zur App aufbaut, muss zwingend ein valides Zertifikat von MailStore verwendet werden. Der im Zertifikat hinterlegt Hostname muss im Manifest verwendet, damit Outlook eine Verbindung zum Server erlaubt.
+
Das Manifest enthält neben dem MailStore-Hostnamen auch eine eindeutige ID, die die App im Outlook App-Store identifiziert. Die ID wird von MailStore permanent gespeichert, und bleibt pro Installation konstant, damit diese bei der Generierung weiterer Manifeste übernommen wird und die App weiterhin über dieselbe ID identifiziert werden kann. Dies ermöglicht das Aktualisieren der bestehenden App, falls sich der Hostname, unter dem MailStore erreichbar ist, ändern sollte.
 +
 
 +
Manifeste müssen daher immer auf dem Server generiert werden, zu dem sich die dazugehörige Outlook-App verbinden soll.
 +
 
 +
Einer der im Zertifikat hinterlegten Hostnamen muss im Manifest verwendet, damit Outlook eine Verbindung zu MailStore erlaubt.
  
 
=== MailStore Server ===
 
=== MailStore Server ===
Zeile 22: Zeile 28:
 
* Vergeben Sie einen optionalen Namen, für den Fall, dass Sie mehrere Outlook-Apps für mehrere Server erstellen und diese Apps im Outlook App-Store unterscheidbar sein sollen.
 
* Vergeben Sie einen optionalen Namen, für den Fall, dass Sie mehrere Outlook-Apps für mehrere Server erstellen und diese Apps im Outlook App-Store unterscheidbar sein sollen.
 
* Klicken Sie ''Manifest generieren'' und wählen Sie die Zieldatei aus um das Manifest zu erstellen.
 
* Klicken Sie ''Manifest generieren'' und wählen Sie die Zieldatei aus um das Manifest zu erstellen.
 +
* Falls Sie mehrere MailStore Server haben, wiederholen Sie diese Schritte auf allen Servern, für die Sie eine Outlook-App benötigen.
 +
* Fahren sie mit der [[#Installation|Installation]] fort.
  
 
=== MailStore SPE ===
 
=== MailStore SPE ===
  
−
Damit den Download des Manifests zu ermöglichen, muss gegebenenfalls das
+
Diese Schritte werden für MailStore Server NICHT benötigt.
−
[https://help.mailstore.com/en/spe/Branding Branding der SPE] angepasst um einige SPE-spezifische Werte angepasst werde. Andernfalls steht der Download nicht zur Verfügung.
+
 
 +
Um den Download des Manifests zu ermöglichen, muss gegebenenfalls das
 +
[https://help.mailstore.com/en/spe/Branding Branding der SPE] um einige Werte erweitert werden, andernfalls steht der Download nicht zur Verfügung.
  
 
* Öffnen Sie den E-Mail-Archive-Client und verbinden Sie sich als Administrator zu einer Instanz.
 
* Öffnen Sie den E-Mail-Archive-Client und verbinden Sie sich als Administrator zu einer Instanz.
 
* Wechseln Sie zu ''Verwaltung'' > ''Verschiedenes'' > ''Deployment''.
 
* Wechseln Sie zu ''Verwaltung'' > ''Verschiedenes'' > ''Deployment''.
−
* Wenn Sie sich über die MailStore SPE Console als globaler SPE Administrator angemeldet haben, tragen Sie die externe URL, unter der die Instanz erreichbar ist, in das dafür vorgesehene Feld ein.
+
* Falls der Download deaktiviert ist, muss das [https://help.mailstore.com/en/spe/Branding SPE-Branding] angepasst werden. Der Client muss im Anschluss neu gestartet werden.
−
** Wenn Sie sich als Instanzadministrator angemeldet haben, geht MailStore davon aus, dass Sie den externen Hostnamen für die Verbindung verwendet haben und verwendet diesen Hostnamen für die Generierung des Manifests.
+
* Wenn Sie sich über die MailStore SPE Web Console als globaler SPE Administrator angemeldet haben, tragen Sie die externe URL, unter der die Instanz erreichbar ist, in das dafür vorgesehene Feld ein, z.B. ''<nowiki>https://archive.example.com/instanceid</nowiki>''.
−
* Klicken Sie ''Download'' und wählen Sie die Zieldatei aus um das Manifest zu herunterzuladen.
+
** Wenn Sie sich als Instanzadministrator angemeldet haben, geht MailStore davon aus, dass Sie den externen Hostnamen für die Verbindung verwendet haben und verwendet automatisch diesen Hostnamen für die Generierung des Manifests.
 +
* Klicken Sie ''Download'' und wählen Sie die Zieldatei aus, um das Manifest zu herunterzuladen.
  
 +
== Installation ==
  
−
 
+
* Melden Sie sich am [https://admin.teams.microsoft.com/policies/manage-apps ''Microsoft Teams Admin Center''] an.
−
 
+
* Wechseln Sie zu ''Teams-Apps'' > ''Apps verwalten''.
−
 
+
* Klicken Sie auf ''Aktionen'' > ''Neue App hochladen''.
−
== Installation ==
+
* Klicken Sie auf ''Hochladen'' und wählen Sie das zuvor generierte Manifest aus.
 +
* Nach dem erfolgreichen Hochladen kann die App über die Suche nach ''MailStore'' bzw. den von Ihnen gewählten Namen aus dem SPE Branding gefunden werden.
 +
* Wählen Sie die App aus und klicken Sie auf ''Benutzer und Gruppen''.
 +
* Veröffentlichen Sie die App.
 +
* Die Endbenutzer können die App nun im App-Store innerhalb Outlooks finden und ihrem Outlook hinzufügen.
 +
* Sie können die App den Benutzern auch per Richtlinie zuweisen, klicken Sie dazu auf [https://admin.teams.microsoft.com/policies/app-setup ''Einrichtungsrichtlinien''].
 +
* Fügen Sie eine neue Richtlinie hinzu oder bearbeiten Sie eine vorhandene Richtlinie.
 +
* Konfigurieren Sie die Richtlinie Ihren Bedürfnissen entsprechend.
  
 
== Aktualisierung ==
 
== Aktualisierung ==
  
−
Das MailStore Outlook Add-In kann mit Hilfe von Gruppenrichtlinien automatisch auf den Computern der MailStore Benutzer aktualisiert werden. Um eine bestehende ''MailStore Outlook Add-In Deployment''-Gruppenrichtlinie dahingehend zu bearbeiten, dass eine automatische Aktualisierung des MailStore Outlook Add-Ins durchgeführt werden kann, gehen Sie bitte wie folgt vor:
+
Das Manifest muss aktualisiert werden, wenn sich der Hostname unter dem MailStore erreichbar ist, geändert hat.
−
 
 
−
 
 
−
Bei der nächsten Neuanmeldung der Benutzer an ihrer Windows-Arbeitsstation wird der MailStore Client Loader aktualisiert.
 
−
 
 
−
== Konfiguration ==
 
−
 
 
−
 
 
  
−
== Deinstallation ==
+
Erstellen Sie ein neues Manifest, wie im Abschnitt [[#Installation|Installation]] beschrieben.
  
 +
* Melden Sie sich am [https://admin.teams.microsoft.com/policies/manage-apps ''Microsoft Teams Admin Center''] an.
 +
* Wechseln Sie zu ''Teams-Apps'' > ''Apps verwalten''.
 +
* Wählen Sie die vorhandene App aus der Liste der Apps aus.
 +
* Klicken Sie in der Übersichtskachel auf ''Datei hochladen'' und wählen Sie das zuvor generierte Manifest aus.
  
−
[[de:MailStore Outlook Add-In Deployment]]
+
[[de:MailStore Outlook App Deployment]]
−
[[en:MailStore Outlook Add-in Deployment]]
+
[[en:MailStore Outlook App Deployment]]

Aktuelle Version vom 15. Oktober 2024, 11:02 Uhr

Um die MailStore Outlook App für das neue Outlook nutzen zu können, muss ein auf Ihre Installation angepasstes Manifest generiert werden.

Das Manifest beschreibt, wie Ihre MailStore Installation von innerhalb Outlooks zu erreichen ist.

Dieses Manifest kann in den App-Store Ihres Microsoft 365-Mandanten hochgeladen werden. Damit ist die MailStore Outlook App im Outlook App-Store verfügbar und kann entweder zentral von Administratoren den Benutzern per Richtlinie zugewiesen werden, oder die Benutzer können die App aus dem App Store ihrer Outlook-Installation hinzufügen.

Auf Grund von Caching in der Infrastruktur von Microsoft 365 kann es vorkommen, dass Änderungen nicht sofort sichtbar werden. Diese Verzögerungen können sowhl im Microsoft Teams Admin Center als auch im neuen Outlook auftreten.

Voraussetzungen

  • Das neue Outlook muss mit einem Microsoft 365-Mandanten verbunden sein.
  • Administrativer Zugriff auf den Microsoft 365-Mandanten.
  • MailStore benötigt ein vertrauenswürdiges Zertifikat. Dies kann von Let's Encrypt oder einer anderen Zertifizierungsstelle stammen.

Generierung des Manifests

Das Manifest enthält neben dem MailStore-Hostnamen auch eine eindeutige ID, die die App im Outlook App-Store identifiziert. Die ID wird von MailStore permanent gespeichert, und bleibt pro Installation konstant, damit diese bei der Generierung weiterer Manifeste übernommen wird und die App weiterhin über dieselbe ID identifiziert werden kann. Dies ermöglicht das Aktualisieren der bestehenden App, falls sich der Hostname, unter dem MailStore erreichbar ist, ändern sollte.

Manifeste müssen daher immer auf dem Server generiert werden, zu dem sich die dazugehörige Outlook-App verbinden soll.

Einer der im Zertifikat hinterlegten Hostnamen muss im Manifest verwendet, damit Outlook eine Verbindung zu MailStore erlaubt.

MailStore Server

  • Öffnen Sie die MailStore Server Dienst-Konfiguration.
  • Wechseln Sie zu den Netzwerkeinstellungen.
  • Wählen Sie einen Hostnamen aus dem Menü aus oder tragen Sie den Hostnamen, unter dem MailStore Server erreichbar ist, manuell ein.
  • Vergeben Sie einen optionalen Namen, für den Fall, dass Sie mehrere Outlook-Apps für mehrere Server erstellen und diese Apps im Outlook App-Store unterscheidbar sein sollen.
  • Klicken Sie Manifest generieren und wählen Sie die Zieldatei aus um das Manifest zu erstellen.
  • Falls Sie mehrere MailStore Server haben, wiederholen Sie diese Schritte auf allen Servern, für die Sie eine Outlook-App benötigen.
  • Fahren sie mit der Installation fort.

MailStore SPE

Diese Schritte werden für MailStore Server NICHT benötigt.

Um den Download des Manifests zu ermöglichen, muss gegebenenfalls das Branding der SPE um einige Werte erweitert werden, andernfalls steht der Download nicht zur Verfügung.

  • Öffnen Sie den E-Mail-Archive-Client und verbinden Sie sich als Administrator zu einer Instanz.
  • Wechseln Sie zu Verwaltung > Verschiedenes > Deployment.
  • Falls der Download deaktiviert ist, muss das SPE-Branding angepasst werden. Der Client muss im Anschluss neu gestartet werden.
  • Wenn Sie sich über die MailStore SPE Web Console als globaler SPE Administrator angemeldet haben, tragen Sie die externe URL, unter der die Instanz erreichbar ist, in das dafür vorgesehene Feld ein, z.B. https://archive.example.com/instanceid.
    • Wenn Sie sich als Instanzadministrator angemeldet haben, geht MailStore davon aus, dass Sie den externen Hostnamen für die Verbindung verwendet haben und verwendet automatisch diesen Hostnamen für die Generierung des Manifests.
  • Klicken Sie Download und wählen Sie die Zieldatei aus, um das Manifest zu herunterzuladen.

Installation

  • Melden Sie sich am Microsoft Teams Admin Center an.
  • Wechseln Sie zu Teams-Apps > Apps verwalten.
  • Klicken Sie auf Aktionen > Neue App hochladen.
  • Klicken Sie auf Hochladen und wählen Sie das zuvor generierte Manifest aus.
  • Nach dem erfolgreichen Hochladen kann die App über die Suche nach MailStore bzw. den von Ihnen gewählten Namen aus dem SPE Branding gefunden werden.
  • Wählen Sie die App aus und klicken Sie auf Benutzer und Gruppen.
  • Veröffentlichen Sie die App.
  • Die Endbenutzer können die App nun im App-Store innerhalb Outlooks finden und ihrem Outlook hinzufügen.
  • Sie können die App den Benutzern auch per Richtlinie zuweisen, klicken Sie dazu auf Einrichtungsrichtlinien.
  • Fügen Sie eine neue Richtlinie hinzu oder bearbeiten Sie eine vorhandene Richtlinie.
  • Konfigurieren Sie die Richtlinie Ihren Bedürfnissen entsprechend.

Aktualisierung

Das Manifest muss aktualisiert werden, wenn sich der Hostname unter dem MailStore erreichbar ist, geändert hat.

Erstellen Sie ein neues Manifest, wie im Abschnitt Installation beschrieben.

  • Melden Sie sich am Microsoft Teams Admin Center an.
  • Wechseln Sie zu Teams-Apps > Apps verwalten.
  • Wählen Sie die vorhandene App aus der Liste der Apps aus.
  • Klicken Sie in der Übersichtskachel auf Datei hochladen und wählen Sie das zuvor generierte Manifest aus.
Abgerufen von „https://help.mailstore.com/de/server/index.php?title=MailStore_Outlook_App_Deployment&oldid=9219“