UMA/SEWS-Tool v1.2: Unterschied zwischen den Versionen

Aktuelle Version vom 13. August 2024, 08:56 Uhr

notempty

Dieser Artikel bezieht sich auf eine nicht mehr aktuelle Version!

notempty

Der Artikel für die neueste Version steht hier

notempty

Zu diesem Artikel gibt es bereits eine neuere Version, die sich allerdings auf eine Reseller-Preview bezieht

Informationen

Letzte Anpassung zur Version: 1.2
Bemerkung:
Vorherige Versionen: -
Changelog: Changelog

Einleitung

Das Securepoint EWS-Tool (SEWS-Tool) dient zum Import von E-Mails aus einem Microsoft Exchange Mailsystem in das Securepoint Unified Mail Archive (UMA).
Dafür wird die EWS Schnittstelle des Microsoft Exchange verwendet.

Nutzungsvoraussetzungen

UMA ab Version 2.5.10
Exchange Server 2010 oder höher
Microsoft Windows 7 oder höher
.NET Framework 4.0 oder höher

Das SEWS Import Tool

Vorbereitung des UMA

Import mittels SEWS-Import Tool erlauben

In dem UMA muss die Nutzung des SEWS Tool unter Setup -> Mailbox Importieren im Abschnitt SEWS Import aktiviert werden.

Vorbereitung des Exchange und Active Directory

Die Einstellungspunkte können je nach Exchange Server Version an einer anderen Stelle sein.

Damit das SEWS Tool genutzt werden kann, wird ein Benutzer im Active Directory benötigt. Dieser Benutzer benötigt das Recht auf die Postfächer anderer Benutzer zuzugreifen. Im Exchange Server muss zusätzlich die Postfachberechtigung für den Import gesetzt werden.

Unter Exchange 2010 wird dieses über die Exchange Management Shell eingestellt.

Ab Exchange Server 2013 kann dies auch in der Benutzerverwaltung eingestellt werden.

Beispiel für Exchange Server 2013 mit der Shell

Zugriffberechtigung für Superuser erteilen

Das Kommando um dem Benutzer superuser in der Domäne securepointdemo.local die Berechtigung für den Vollzugriff für das Postfach User1 zu erteilen lautet:

Add-MailboxPermission User1 -User 'Securepointdemo\superuser' -AccessRights 'FullAccess'

Sollte der NETBIOS/WORKGROUP-Name von der Domäne abweichen, muss darauf geachtet werden, dass hier der korrekte Eintrag mit dem NETBIOS-Namen erfolgt. In diesem Beispiel also Securepointdemo.

Zusatz zum Exchange Server 2016

Die Vergabe der Berechtigung muss um "-InheritanceType All" ergänzt werden.

Add-MailboxPermission User1 -User 'Securepointdemo\superuser' -AccessRights 'FullAccess' -InheritanceType All

Installation des SEWS Import Tool

Das SEWS Tool kann aus dem Resellerportal heruntergeladen werden. Resellerportal Downloads
Die Installation wird nach dem Herunterladen mit einem Doppelklick auf die SEWS_Installer.exe als Administrator gestartet.
Nach dem Wählen der gewünschten Sprache sowie Bestätigen der Lizenzvereinbarung muss ein Installationsort gewählt werden
Mit einem Klick auf "Beenden" ist die Installation abgeschlossen. Das Tool kann nun gestartet werden.

UMA Import via SEWS Import Tool

Das SEWS Import Tool wird über die Anwendungsdatei (.exe) gestartet.

Punkt 1: Konfiguration

Konfiguration

Der erste Punkt besteht aus dem erstellen einer neuen Konfiguration. Hierzu muss nach dem Klick auf "Neue Konfiguration" zunächst ein Konfigname vergeben werden. In den Bereichen "Microsoft Exchange" sowie "Securepoint UMA" müssen dann die Werte für den Importuser und dessen E-Mailadresse, sowie die IP der UMA eingetragen werden. Ein Klick auf "Konfiguration Speichern" sichert selbige. Dies erscheint auch als Info-Meldung im unteren LOG-Bereich.

Punkt 2: Exchange-Browser

Exchange Browser

Hier muss zunächst das Passwort des Import-Users eingegeben und anschließend auf "Exchange auslesen" geklickt werden. Kann das Tool den Exchange nicht erreichen, oder das AD nicht finden erscheint ein POP-UP in dem der EWS Pfad des Exchange sowie die IP des AD manuell eingegeben werden muss. Im Folgenden sind die Zertifikate der Server noch zu installieren und die Zertifikatsmeldungen mir "Ja" zu bestätigen. Nach diesem, oder dem direkten Erreichen der EWS-Schnitstelle, sowie dem AD connect, erscheinen in dem Feld "Exchange Browser" unter dem Oberbegriff "Exchange Alias" die User, auf die der Import-User entsprechende Berechtigungen hat.

Nach dem synchronisieren kann pro Benutzer eine Auswahl der zu importierenden Daten getroffen werden.

Punkt 3: Filter

Filter

In dem Bereich "Filter" kann über "Neue Regel erstellen" eine oder mehrere Filterregel angelegt werden, welche E-Mails anhand von Betreff, AN, VON, CC oder X-Header Eintrag explizit von dem Import ausnehmen oder aber explizit archivieren. Filterregeln können mit "und/oder" Verknüpft werden. In dem unteren Beispiel werden explizit E-Mails an eine Adresse sowie von einem Adressteil von der Archivierung ausgenommen.
Wird keine Filterregel angelegt wird alles archiviert!

Es gibt die Möglichkeit im UMA-Admin-Interface ein Blacklist-Filter für E-Mails anzulegen. Alle Mails werden immer anhand dieser Liste gefiltert.

Punkt 4: Import

Import

Um den Import zu starten wird nun die Eingabe des Import-User-Passortes, sowie das Passwort des UMA-Admins erwartet. Um den Durchlauf zu Testen kann vorab mit dem Klick auf "Testlauf" ein Trockenimport durchgeführt werden. Mit dem Klick auf "Start" wird der eigentliche Import gestartet.

Punkt 5: Sonstige Optionen

Sonstige Optionen

Unter "Sonstige Optionen" kann die Größe der E-Mail-Queue, die max. Anzahl von Fehlern bei einem Import sowie die Performance angepasst werden. Ebenfalls kann das Log-Level für die GUI und die Log-Datei einzeln eingestellt werden.

@@ Zeile 1: / Zeile 1: @@
+{{Archivhinweis|UMA/SEWS-Tool}}
+{{DISPLAYTITLE:Securepoint EWS-Tool für UMA}}{{#vardefine:headerIcon| spicon-uma }}
 == Informationen ==
-Letze Anpassung zur Version: '''1.2'''
+Letzte Anpassung zur Version: '''1.2'''
 <br>
-Bemerkung: Artikelanpassung
+Bemerkung:
 <br>
 Vorherige Versionen: -
 <br>
+Changelog: [[UMA/SEWS-Tool/Changelog | Changelog]]
 == Einleitung ==
@@ Zeile 14: / Zeile 17: @@
 * UMA ab Version 2.5.10
 * Exchange Server 2010 oder höher
+* Microsoft Windows 7 oder höher
+* .NET Framework 4.0 oder höher
 == Das SEWS Import Tool ==
@@ Zeile 22: / Zeile 27: @@
 <div style="clear: both;"></div>
-== Vorbereitung des Exchange und Active Directory ==
+=== Vorbereitung des Exchange und Active Directory ===
 <div>
 <div style="display: flex;padding-right:10px;float:left;"> [[Datei:alert-yellow.png]] </div>
@@ Zeile 29: / Zeile 34: @@
 <div style="clear: both;"></div>
 <br>
-Damit das SEWS Tool genutzt werden kann, wird ein neuer Benutzer im Active Directory benötigt. Dieser Benutzer benötigt das Recht '''auf die Postfächer anderer Benutzer zuzugreifen'''. Im Exchange Server muss zusätzlich die Postfachberechtigung für den Import gesetzt werden.
+Damit das SEWS Tool genutzt werden kann, wird ein Benutzer im Active Directory benötigt. Dieser Benutzer benötigt das Recht '''auf die Postfächer anderer Benutzer zuzugreifen'''. Im Exchange Server muss zusätzlich die Postfachberechtigung für den Import gesetzt werden.
-Unter Exchange 2010 wird diese über die Exchange Management Shell eingestellt.
+Unter Exchange 2010 wird dieses über die Exchange Management Shell eingestellt.
 <div>
 <div style="display: flex;padding-right:10px;float:left;"> [[Datei:alert-yellow.png]] </div>
-<div style="display: flex;"><span style="background-color: #ffc926;padding:10px;border-radius:4px;font-weight:bold;">Ab Exchange Server 2013 kann dies auch in der Benutzerverwaltung eingestellt.</span></div>
+<div style="display: flex;"><span style="background-color: #ffc926;padding:10px;border-radius:4px;font-weight:bold;">Ab Exchange Server 2013 kann dies auch in der Benutzerverwaltung eingestellt werden.</span></div>
 </div>
 <div style="clear: both;"></div>
@@ Zeile 55: / Zeile 60: @@
 <div style="display: flex;padding-right:10px;float:left;"> [[Datei:alert-red.png]] </div>
 <div style="display: flex;"><span style="background-color: #bc1b18;padding:10px;border-radius:4px;font-weight:bold;color:white">Zusatz zum Exchange Server 2016
-*Der Superuser darf NICHT der Administrator sein!
-*Der Superuser MUSS eine Mailbox besitzen!
 *Die Vergabe der Berechtigung muss um "-InheritanceType All" ergänzt werden.
 <br>
@@ Zeile 64: / Zeile 67: @@
 === Installation des SEWS Import Tool ===
-* Das SEWS Tool kann aus dem Resellerportal heruntergeladen werden. [https://my.securepoint.de/downloads/cat/9/ Resellerportal Downloads]
+* Das SEWS Tool kann aus dem Resellerportal heruntergeladen werden. [https://my.securepoint.de/downloads Resellerportal Downloads]
 *Die Installation wird nach dem Herunterladen mit einem Doppelklick auf die SEWS_Installer.exe als Administrator gestartet.
 *Nach dem Wählen der gewünschten Sprache sowie Bestätigen der Lizenzvereinbarung muss ein Installationsort gewählt werden
@@ Zeile 84: / Zeile 87: @@
 ==== Punkt 2: Exchange-Browser ====
-<!--[[Datei:dummy|500px|thumb|right|Exchange Browser]]-->
+[[Datei:EWS-ExBrowser.png|500px|thumb|right|Exchange Browser]]
 <br>
 Hier muss zunächst das Passwort des Import-Users eingegeben und anschließend auf "Exchange auslesen" geklickt werden.
@@ Zeile 104: / Zeile 107: @@
 Wird keine Filterregel angelegt wird alles archiviert!
 <div style="clear: both;"></div>
+<div style="clear: both;"></div>
+<div>
+<div style="display: flex;padding-right:10px;float:left;"> [[Datei:alert-yellow.png]] </div>
+<div style="display: flex;"><span style="background-color: #ffc926;padding:10px;border-radius:4px;font-weight:bold;">Es gibt die Möglichkeit im UMA-Admin-Interface ein Blacklist-Filter für E-Mails anzulegen. Alle Mails werden immer anhand dieser Liste gefiltert.</span></div>
+</div>
+<div style="clear: both;"></div>
 ==== Punkt 4: Import ====
-<!-- [[Datei:dummy.jpg|500px|thumb|right|Import]]-->
+[[Datei:EWS-Import.png|500px|thumb|right|Import]]
 <br>
 Um den Import zu starten wird nun die Eingabe des Import-User-Passortes, sowie das Passwort des UMA-Admins erwartet.