UMA/Outlook-Plugin

---

Outlook-Plugin für UMA Version 3.3.0

Letzte Anpassung: 12.2022 (2.2.0)

Neu:

• Neues Interface zur Outlook-Plugin-Version 2.2.0
• Anmeldung an Microsoft Azure

notempty

Dieser Artikel bezieht sich auf eine Resellerpreview

1.0.9 2.1.0

Voraussetzungen:

• Ab UMA Version 3.3.0
• Ab Microsoft® Outlook® 2010 bis Outlook® 2021 32 Bit
  Auch Outlook Classic genannt
• Ab Windows 7 mit Microsoft .NET Framework 4.5©

---

Vorbereitungen

Das Outlook-Plugin muss als Administrator unter Windows installiert werden.

Bei der Benutzung von Outlook Betaversionen kann es zu Darstellungsfehlern im Ribbon kommen.

---

Herunterladen des UMA Outlook-Plugin

Das Plugin steht im Reseller-Portal im Abschnitt Downloads / Reiter Tools x zum Download als .msi oder .exe bereit.

---

Installation des UMA Outlook-Plugin

Installation mit Assistenten

• .msi oder .exe-Datei starten und die UAC-Meldung bestätigen
  Die .msi verwendet die Anzeigesprache für die Installationsdialoge, die .exe fragt nach einer Sprache.
• Auswahl der Sprache für den Installationsassistenten.
• Die IP-Adresse oder der Hostname des UMA muss angegeben werden.
• Bei der Installation des Plugins wird der Registry-Key BypassSSLNoCacheCheck mit dem Wert 1 unter den folgenden Registry-Pfaden hinzufügt:
  Diese Einstellungen sind erforderlich, um Prüfberichte oder einzelne Mails herunterladen zu können. Andernfalls erhält man eine Fehlermeldung "getdocument.cgi kann nicht herunter geladen werden"
  
  HKEY_Local_Machine\Software\Microsoft\Windows\CurrentVersion\Internet Settings
  HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings
  Der Key wird beim deinstallieren nicht gelöscht.

Benutzerkontensteuerung bestätigen

Auswahl der Sprache für den Installationsassistenten.

Willkommensfenster. Fortsetzen der Installation mit Weiter

Den Lizenzbedingungen muss zugestimmt werden

Die IP-Adresse oder der Hostname des UMA muss angegeben werden.

Angabe des Zielordners kann unverändert bleiben

Start der Installation

Plugin wird installiert

Die Instalation ist abgeschlossen

Silent Installation

Mit der .msi-Datei kann eine Silent Installation durchgeführt werden:

msiexec /i "$Dateiname_und_Pfad_zum_Plugin" UMAADDRESS=$UMA-IP /quiet

$Dateiname_und_Pfad_zum_Plugin =Pfad der .msi-Datei
$UMA-IP = IP-Adresse des UMA

Beispiel:

msiexec /i "D:\UMA-Plugin 2.1.5 .msi" UMAADDRESS=192.168.175.254 /quiet

---

Erster Start

Das Zertifikat des UMAs muss akzeptiert werden

Das Zertifikat für das Plugin (ausgestellt von sales@securepoint.de) muss akzeptiert werden.

Beim ersten Start wird ein Zertifikatsfehler und ein Sicherheitshinweis angezeigt. Es müssen

• das Zertifikat für das Plugin und
• das Zertifikat für das UMA

akzeptiert werden.

---

Bedienung

Menüstruktur

UMA Outlook-Plugin v2.2.0 Menü

Nach dem Öffnen von Outlook erscheint ein weiterer Menüpunkt mit der Bezeichnung UMA E-Mail-Archiv.
Im Folgenden werden die darunter erscheinenden Funktionen erklärt.

Schaltfläche	Beschreibung
Email Email	Die E-Mails werden angezeigt. Es werden die E-Mails durch den im Menü Einstellungen hinterlegten Benutzer angezeigt. Wurde vorher ein anderes in Outlook konfiguriertes Konto angezeigt, werden die E-Mails von diesem Konto angezeigt.
Wiederherstellen Wiederherstellen	Es gibt die Möglichkeit E-Mails, die nicht mehr lokal zur Verfügung stehen, weil diese eventuell gelöscht wurden, aus dem Archiv des UMA wieder herzustellen. Die E-Mail muss mit der Checkbox (in der Spalte der Suchergebnisse oben links am Anfang jeder Mail) markiert werden und kann dann mit Klick auf die Schaltfläche in einem Ordner eigener Wahl wiederhergestellt werden. Nach bestätigen der Schaltfläche OK befindet sich die Nachricht (bzw. die Nachrichten) im gewünschten Ordner.
Einstellungen Einstellungen	Im Abschnitt UMA-Appliance: steht unter IP/Host: die IP-Adresse oder der Hostname des UMA, welche bei der Installation angegeben wird. Im Abschnitt Benutzerdaten: wird der Benutzername für den Zugang zum UMA und das dazugehörige Passwort eingegeben. Alternativ wird SSO/MFA Login über Microsoft Azure aktiviert. Dann erfolgt die Anmeldung über ein extra Fenster über Microsoft Azure. Es werden nur E-Mails durchsucht und angezeigt, die mit dem hier angegebenen Benutzer verknüpft sind. Im Abschnitt Zertifikate: werden die verwendeten Zertifikate als vertraute Zertifikate bestätigt.
	Mit der Schaltfläche Testen werden die Zugangsdaten überprüft. Beim ersten Aufruf muss dabei das Zertifikat des UMAs akzeptiert werden. Anschließend erhält man die Meldung "Keine Verbindung zum Host". Ein erneuter Test liefert dann die Meldung "Benutzerdaten wurden erfolgreich überprüft. Diese Einstellungen Speichern
	Wird unter Benutzerdaten: SSO/MFA Login über Microsoft Azure aktiviert und auf die Schaltfläche Speichern geklickt, erscheint ein Fenster zur Anmeldung an Microsoft Azure. Entweder wird ein schon verbundenes Konto ausgewählt, oder ein anderes Konto verwendet.
Erweiterte Suche
Erweiterte Suche	Mit dieser Suchfunktion ist es möglich komplexe Suchmuster zu gestalten, um gezielt die gewünschte E-Mail heraus zu suchen. Um die Erweiterte Suche nutzen zu können, wird auf die Schaltfläche Ausklappen geklickt. Anschließend über Werkzeuge auf Erweiterte Suche.
Suchbegriff:		Den Suchbegriff eingeben Groß- und Kleinschreibung werden nicht unterschieden (case-insensitive) Bei Eingabe von mehreren Zeichenfolgen ohne eine entsprechende Verknüpfungsangabe ist der Standard eine Or-Verknüpfung Die Benutzung von Anführungszeichen " " sucht nach genau der angegebenen Zeichenfolge
Mit der Schaltfläche wird eine erweiterte Suchfunktion hinzugefügt.
Verknüpfung	AndOrNot	Das Schlüsselwort der Verknüpfung wird ausgewählt
Term	Auswählen	Der Term wird ausgewählt. Mit wird ein weiterer Term hinzugefügt.
	Suchbegriff	Ein zusätzlicher Suchbegriff Groß- und Kleinschreibung werden nicht unterschieden (case-insensitive) Bei Eingabe von mehreren Zeichenfolgen ohne eine entsprechende Verknüpfungsangabe ist der Standard eine Or-Verknüpfung Die Benutzung von Anführungszeichen " " sucht nach genau der angegebenen Zeichenfolge
	Dateityp	Der Dateityp wird bestimmt
	Kategorie	Die Kategorie wird bestimmt
	Archivierungs-Zeit	Die Zeit der Archivierung wird bestimmt
	From:	Der Absender wird eingegeben
	To:	Der Empfänger wird eingegeben
	CC:	Ein CC-Empfänger wird eingegeben
	Subject:	Der Anhang wird eingegeben
Mit wird die Reihe gelöscht und mit eine weitere Reihe hinzugefügt.
Jetzt Suchen	Startet die Suchfunktion
Zurücksetzen	Setzt alle Einstellungen zurück
Schließen	Schließt das Fenster
Optionen
	Diese Schaltfläche befindet sich neben jeder E-Mail. Es ermöglicht verschiedene Aktionen:
	E-Mail anzeigen	Die E-Mail wird angezeigt
	E-Mail herunterladen	Ermöglicht das Herunterladen der E-Mail als .eml-Datei.
	Ergebnisse dieser Art bevorzugen	Erhöht die Relevanz ähnlicher Dokumente und Texte bei der Suche
	Attribute editieren	E-Mails können Kategorien zugewiesen werden, nach denen in der Suche gefiltert werden kann.

---

Fehlermeldungen

Bekannte Probleme und ihre Beseitigung

Meldung	Mögliche Ursache	Lösung
Proxy-Probleme
[SESSION INVALID Meldungen beim Laden]	Wenn ein System-Proxy eingestellt wurde, wird der Login direkt geladen, aber alle nachfolgenden Webinterface-Teile über den Proxy. Das führt dazu, dass die Session nicht gültig ist.	In den Proxy-Einstellungen muss eine Ausnahme für das UMA zu definiert werden.
Dateidownload / Prüfbericht
Webbrowser: getdocument.cgi von uma-name kann nicht heruntergeladen werden	Fehlermeldung beim Anzeigen eines Prüfberichtes oder Herunterladen einer Mail. Wenn alle folgende Bedingungen erfüllt sind, kann es zu diesem Fehler kommen: Der Installer des Plugins ist mit einer 32-bit Platform gebaut. Daher wird er unter 64-bit-Systemen den Wert in den Key unter HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Internet Settings schreiben. Es wird ein 64-bit Internet Explorer verwendet, um die Web-Seiten des UMAs anzuzeigen Plugin ist durch Admin-Konto für mehrere / andere Benutzer installiert worden ( Der Key BypassSSLNoCacheCheck wird nicht unter HKEY_Current_User\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings für andere Benutzer geschrieben) Der Haken "Verschlüsselte Seiten nicht auf dem Datenträger speichern" ist angehakt.	Der Internet-Explorer benötigt die Berechtigung, verschlüsselte Seiten herunterzuladen: Internetoptionen aufrufen (Aufruf direkt mit diesem Begriff über das Suchfeld, oder in den Einstellungen des Internet Explorers). Im Reiter Erweitert die Checkbox bei Verschlüsselte Seiten nicht auf dem Datenträger speichern. deaktivieren. →