MailStore Outlook App Deployment: Unterschied zwischen den Versionen

[unmarkierte Version][gesichtete Version]
 
(15 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 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.
 
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 ihrem Outlook hinzufügen können (dezentrale Installation).
+
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 ==
 
== Voraussetzungen ==
  
* Outlook muss mit einem Microsoft 365-Mandanten sein.
+
* Das neue Outlook muss mit einem Microsoft 365-Mandanten verbunden sein.
 
* Administrativer Zugriff auf den Microsoft 365-Mandanten.
 
* 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
+
* 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.
  
 
== Generierung des Manifests ==
 
== Generierung des Manifests ==
  
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 weiterer Manifeste konstant bleibt 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, ändern sollte.
+
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.
 
Manifeste müssen daher immer auf dem Server generiert werden, zu dem sich die dazugehörige Outlook-App verbinden soll.
  
Einer der im Zertifikat hinterlegt Hostnamen muss im Manifest verwendet, damit Outlook eine Verbindung zum MailStore Server erlaubt.
+
Einer der im Zertifikat hinterlegten Hostnamen muss im Manifest verwendet, damit Outlook eine Verbindung zu MailStore erlaubt.
  
 
=== MailStore Server ===
 
=== MailStore Server ===
Zeile 28: 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, z.B. ''https://archive.example.com/instanceid''.
+
* 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 ==
 
== Installation ==
 
=== Zentral ===
 
  
 
* Melden Sie sich am [https://admin.teams.microsoft.com/policies/manage-apps ''Microsoft Teams Admin Center''] an.
 
* Melden Sie sich am [https://admin.teams.microsoft.com/policies/manage-apps ''Microsoft Teams Admin Center''] an.
Zeile 48: Zeile 51:
 
* Klicken Sie auf ''Aktionen'' > ''Neue App hochladen''.
 
* Klicken Sie auf ''Aktionen'' > ''Neue App hochladen''.
 
* Klicken Sie auf ''Hochladen'' und wählen Sie das zuvor generierte Manifest aus.
 
* Klicken Sie auf ''Hochladen'' und wählen Sie das zuvor generierte Manifest aus.
* Nach dem erfolgreichen Hochlad kann die App über die Suche nach ''MailStore'' bzw. den von Ihnen gewählten Namen aus dem SPE Branding gefunden werden.
+
* 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''.
 
* Wählen Sie die App aus und klicken Sie auf ''Benutzer und Gruppen''.
 
* Veröffentlichen Sie die App.
 
* Veröffentlichen Sie die App.
Zeile 55: Zeile 58:
 
* Fügen Sie eine neue Richtlinie hinzu oder bearbeiten Sie eine vorhandene Richtlinie.
 
* Fügen Sie eine neue Richtlinie hinzu oder bearbeiten Sie eine vorhandene Richtlinie.
 
* Konfigurieren Sie die Richtlinie Ihren Bedürfnissen entsprechend.
 
* Konfigurieren Sie die Richtlinie Ihren Bedürfnissen entsprechend.
 
=== Dezentral ===
 
 
Erlauben Sie, dass Benutzer Benutzerdefinierte Apps hochladen können.
 
 
* Melden Sie sich am [https://admin.teams.microsoft.com/policies/manage-apps ''Microsoft Teams Admin Center''] an.
 
* Wechseln Sie zu ''Teams-Apps'' > ''Einrichtungsrichtlinien''.
 
* Wählen Sie eine Richtlinie aus.
 
* Aktivieren Sie die Option ''Benutzerdefinierte Apps hochladen''.
 
* Speichern Sie die Änderung.
 
 
Laden Sie die App in Outlook hoch.
 
 
* Stellen Sie den Benutzern das erzeugte Manifest zur Verfügung.
 
* Öffnen Sie den App-Store innerhalb Outlooks.
 
* Suchen Sie die MailStore App und fügen Sie sie Ihrer Outlook-Installation hinzu.
 
  
 
== Aktualisierung ==
 
== Aktualisierung ==
  
=== Zentral ===
+
Das Manifest muss aktualisiert werden, wenn sich der Hostname unter dem MailStore erreichbar ist, geändert hat.
 
 
=== Dezentral ===
 
 
 
 
 
== Deinstallation ==
 
 
 
=== Zentral ===
 
 
 
=== Dezentral ===
 
  
 +
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 App Deployment]]
 
[[de:MailStore Outlook App Deployment]]
 
[[en:MailStore Outlook App 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.