Wechseln zu:Navigation, Suche
Wiki

UMA Outlook-Plugin

Aus Securepoint Wiki


































































































































De.png
En.png
Fr.png






Outlook-Plugin für UMA Version 3.3.0
Letzte Anpassung: 07.2023 (2.2.1)
Neu:
notempty
Dieser Artikel bezieht sich auf eine Resellerpreview

1.0.9 2.1.0

Voraussetzungen:

    • Nur ab UMA Version 3.3.0
    • ab Outlook 2010
    • ab Windows 7 mit Microsoft .NET Framework 4.5©


Vorbereitungen

Vorbereitungen

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

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

Herunterladen des UMA Outlook-Plugin

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 des UMA Outlook-Plugin

Installation mit Assistenten

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.


Silent Installation

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

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

Bedienung

Menüstruktur

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 UMAv3.3 Outlook-Pluginv2.2.0 E-Mail.png
Email
UMA PLugin v2.0 Mail-Icon.png 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
UMA PLugin v2.0 Restore-Icon.png 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 UMA PLugin v2.0 Restore-Icon.png 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.

UMA Plugin v2.0 Wiederherstellen.PNG
Einstellungen
UMA PLugin v2.0 Einstellungen-Icon.png 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. 		UMAv3.3 Outlook-Pluginv2.2.0 Einstellungen.png
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 		UMA Plugin v2.0 Zertifikatsfehler-Einstellungen.PNG
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. 		UMAv3.3 Outlook-Pluginv2.2.0 Azure.png

Erweiterte Suche

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. 		UMAv3.3 Outlook-Plugin Erweiterte-Suche.png
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
   		UMAv3.3 UI Werkzeuge Erweitere-Suche.png
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

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.

Importvorgang

Über das Outlook-Plugin lassen sich neben einzelnen E-Mails, auch ganze Ordner oder Konten in das UMA importieren:

  • Import Dialog starten im Kontext-Menü (Rechtsklick) des zu importierenden Objektes
  • Schaltfläche UMA Outlook-Plugin Import Icon.png In UMA archivieren klicken
  • Der Import erfolgt in das Konto, mit dem das Outlook-Plugin beim UMA angemeldet ist, auch wenn die Quelle zu einem anderen E-Mail-Konto gehört!
    • UMA Outlook-Plugin Import E-Mail.png
    Schritt 1
    • Gewünschte E-Mail auswählen
    • Bei mehreren E-Mails Shift-Taste gedrückt halten
    • Kontextmenü (Rechtsklick) UMA Outlook-Plugin Import Icon.png In UMA archivieren
    UMA Outlook-Plugin Import E-Mail Importbestätigung.png
    Schritt 2
    • Im Fenster Importbestätigung wird der UMA-Server und die dazugehörige Konten angezeigt, in welche die E-Mails importiert werden
    • Zum Start des Importvorgangs auf die Schaltfläche Ja klicken
    UMA Outlook-Plugin Import E-Mail Import Informationen.png
    Schritt 3
    • Unter
      Statistik
       wird der Beginn und das Ende des Importvorganges angezeigt
    • Die Anzahl der erfolgreich importierten, fehlgeschlagenen und ausgelassenen E-Mails werden angezeigt
    • Nach dem abgeschlossenem Importvorgang kann das Fenster geschlossen werden
    UMA Outlook-Plugin Import Ordner.png
    Schritt 1
    • Gewünschten Ordner auswählen
    • Kontextmenü (Rechtsklick) UMA Outlook-Plugin Import Icon.png In UMA archivieren
    UMA Outlook-Plugin Import Ordner Importbestätigung.png
    Schritt 2
    • Im Fenster Importbestätigung wird der importierte Ordner, der UMA-Server und die dazugehörige Konten angezeigt, in welche der Ordner importiert werden
    • Mit der Aktivierung  Unterordner importieren werden auch die dazugehörigen Unterordner des Ordners mit importiert
    • Zum Start des Importvorgangs auf die Schaltfläche Ja klicken
    UMA Outlook-Plugin Import E-Mail Import Informationen.png
    Schritt 3
    • Unter
      Statistik
       wird der Beginn und das Ende des Importvorganges angezeigt
    • Die Anzahl der erfolgreich importierten, fehlgeschlagenen und ausgelassenen E-Mails werden angezeigt
    • Nach dem abgeschlossenem Importvorgang kann das Fenster geschlossen werden
    UMA Outlook-Plugin Import Account.png
    Schritt 1
    • Gewünschten Account auswählen
    • Kontextmenü (Rechtsklick) UMA Outlook-Plugin Import Icon.png In UMA archivieren
    UMA Outlook-Plugin Import Account Importbestätigung.png
    Schritt 2
    • Im Fenster Importbestätigung wird der importierte Account, der UMA-Server und die dazugehörige Konten angezeigt, in welche sämtliche E-Mails des Accounts importiert werden
    • Zum Start des Importvorgangs auf die Schaltfläche Ja klicken
    UMA Outlook-Plugin Import E-Mail Import Informationen.png
    Schritt 3
    • Unter
      Statistik
       wird der Beginn und das Ende des Importvorganges angezeigt
    • Die Anzahl der erfolgreich importierten, fehlgeschlagenen und ausgelassenen E-Mails werden angezeigt
    • Nach dem abgeschlossenem Importvorgang kann das Fenster geschlossen werden

    Fehlermeldungen

    Fehlermeldungen

    Bekannte Probleme und ihre Beseitigung

    Meldung Mögliche Ursache Lösung

    Proxy-Probleme

    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

    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. → Plugin-Prüfbericht-Fehler webbrowser.PNG
    UMA Plugin v2.0 Internetoptionen.PNG
    Abgerufen von „https://wiki.securepoint.de/index.php?title=UMA/Outlook-Plugin&oldid=87093“