Jump to:navigation, search
Wiki
































De.png
En.png
Fr.png






Outlook-Plugin for UMA version 3.3.0
Last adaption: 07.2023 (2.2.1)
New:
notempty
This article refers to a Resellerpreview

1.0.9 2.1.0

Requirements:

    • Only from UMA NG v3 on
    • from Outlook 2010
    • from Windows 7 with Microsoft .NET Framework 4.5©



Preparations

Preparations

The Outlook plug-in must be installed as an administrator under Windows.

notempty
When using Outlook beta versions, display errors may occur in the ribbon.

Downloading the UMA Outlook plugin

Downloading the UMA Outlook plugin

The plugin is available in the reseller portal in the section Downloads / Tools for download as .msi or .exe.


Installation of the UMA Outlook plugin

Installation of the UMA Outlook plugin

Installation with wizard

Installation with wizard

  • Start .msi or .exe file and acknowledge the UAC message
    The .msi uses the display language for installation dialogs, while the .exe prompts for a language.
      
  • Selecting the language for wizard
  • The IP address or host name of the UMA must be specified.
  • During the installation of the plugin, the registry key BypassSSLNoCacheCheck with the value 1 is added under the following registry path:
    These settings are required to download test reports or individual mails. Otherwise you will get an error message "getdocument.cgi cannot be downloaded"
      
    HKEY_Local_Machine\Software\Microsoft\Windows\CurrentVersion\Internet Settings
    HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings
    The key will not be deleted during uninstallation.


Silent installation

Silent installation

The .msi file can be used to perform a silent installation:

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

$Filename_and_path_to_plugin =PAth to the .msi-file
$UMA-IP = IP-address of the UMA

Example:

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


First start

First start

The certificate of the UMA must be accepted
The certificate for the plugin (issued by sales@securepoint.de) must be accepted.
At the first start a certificate error and a security warning is displayed. You have to accept
  • the certificate for the plugin and
  • the certificate for the UMA
.



Handling

Handling

Menu structure

Menu structure
UMA Outlook Plugin v2.2.0 Menu

After opening Outlook, another menu item appears with the name UMA Email Archive.
The functions appearing below are explained below.


Button Description UMAv3.3 Outlook-Pluginv2.2.0 E-Mail-en.png
Email
UMA PLugin v2.0 Mail-Icon.png Email
The emails are displayed.
The emails are displayed by the user stored in the Settings menu. If another account configured in Outlook was previously displayed, the emails from this account are displayed.
Restore
UMA PLugin v2.0 Restore-Icon.png Restore
It is possible to restore from the UMA archive any emails that are no longer available locally because they may have been deleted.

The email must be marked with the checkbox (in the search results column in the upper left corner at the beginning of each mail) and can then be restored in a folder of your choice by clicking the UMA PLugin v2.0 Restore-Icon.png button. After confirming the button OK the message (or messages) will be in the desired folder.

UMA Plugin v2.0 Wiederherstellen-en.PNG
Settings
UMA PLugin v2.0 Einstellungen-Icon.png Settings
In the section
UMA appliance:
under IP/Host: is the IP address or host name of the UMA, which is specified during installation.

In the section
User data:
, the user name for access to the UMA and the corresponding password are entered.
Alternatively, SSO/MFA Login via Microsoft Azure is activated. Then the login takes place via an extra window via Microsoft Azure.

Only emails associated with the user specified here are searched and displayed.

In the
Certificates:
section, the certificates used are confirmed as trusted certificates.
UMAv3.3 Outlook-Pluginv2.2.0 Einstellungen-en.png
With the button Test the credentials are checked.
The certificate of the UMA must be accepted at the first call.
Afterwards you will receive the message "No connection to the host". A new test then returns the message "User data has been successfully verified. Save these settings
UMA Plugin v2.0 Zertifikatsfehler-Einstellungen.PNG
If SSO/MFA Login via Microsoft Azure is activated under
User Data:
and the Save button is clicked, a window for logging in to Microsoft Azure appears. Either an already connected account is selected or another account is used.
UMAv3.3 Outlook-Pluginv2.2.0 Azure-en.png

Advanced search

Advanced search
Advanced search With this search function it is possible to create complex search patterns to find the desired email.
To use the advanced search, click on the Expand button. Then click on Advanced Search via Tools.
UMAv3.3 Outlook-Plugin Erweiterte-Suche-en.png
Search term:     Enter search term
  • No distinction is made between upper and lower case (case-insensitive)
  • When entering multiple strings without a corresponding operation specification, the default is an OR operation.
  • The use of quotation marks " " searches for exactly the specified character string.
  
UMAv3.3 UI Werkzeuge Erweitere-Suche-en.png
The button adds an advanced search function.
Operation AndOrNot The keyword of the operation is selected
Term Select The term is selected. With another term is added.
Search term An additional search term
  • No distinction is made between upper and lower case (case-insensitive)
  • When entering multiple strings without a corresponding operation specification, the default is an OR operation.
  • The use of quotation marks " " searches for exactly the specified character string.
  
File type The file type is specified
Category The category is specified
Archiving time The archiving time is set
From: The sender is entered
To: The recipient is entered
CC: A CC recipient is entered
Subject: The attachment is entered
With the row is deleted and with another row is added.
Search now Stars the search function
Reset Resets all settings
Close Closes the window

Options

Options
This button is located next to each email. It enables various actions:
 Show email The email is displayed
 Download email Allows you to download the email as an .eml file.
 Make relevant to searches Increases the relevance of similar documents and texts in the search
 Editing attributes Emails can be assigned to categories, which can be filtered in the search.

Import process

The Outlook plugin can be used to import individual emails as well as entire folders or accounts into the UMA:

  • Start import dialog in the context menu (right-click) of the object to be imported
  • Click the UMA Outlook-Plugin Import Icon.png Archive in UMA button
  • The import takes place in the account with which the Outlook plug-in is logged into the UMA, even if the source belongs to a different email account!
  • UMA Outlook-Plugin Import E-Mail-en.png
    Step 1
    • Select the desired email
    • Hold down the Shift key for multiple emails
    • Context menu (right-click) UMA Outlook-Plugin Import Icon.png Archive in UMA
    UMA Outlook-Plugin Import E-Mail Importbestätigung-en.png
    Step 2
    • In the Import confirmation window, the UMA server and the associated accounts into which the emails are imported are displayed
    • Click on the Yes button to start the import process
    UMA Outlook-Plugin Import E-Mail Import Informationen-en.png
    Step 3
    • The start and end of the import process is displayed under
      Statistics
    • The number of successfully imported, failed and skipped emails is displayed
    • After the import process has been completed, the window can be closed












    UMA Outlook-Plugin Import Ordner-en.png
    Step 1
    • Select the desired folder
    • Context menu (right-click) UMA Outlook-Plugin Import Icon.png Archive in UMA
    UMA Outlook-Plugin Import Ordner Importbestätigung-en.png
    Step 2
    • In the Import confirmation window, the imported folder, the UMA server and the associated accounts into which the folder is imported are displayed
    • By activating { Import subfolders, the associated subfolders of the folder are also imported
    • Click on the Yes button to start the import process
    UMA Outlook-Plugin Import E-Mail Import Informationen-en.png
    Step 3
    • The start and end of the import process is displayed under
      Statistics
    • The number of successfully imported, failed and skipped emails is displayed
    • After the import process has been completed, the window can be closed












    UMA Outlook-Plugin Import Account-en.png
    Step 1
    • Select the desired account
    • Context menu (right-click) UMA Outlook-Plugin Import Icon.png Archive in UMA
    UMA Outlook-Plugin Import Account Importbestätigung-en.png
    Step 2
    • In the Import confirmation window, the imported account, the UMA server and the associated accounts are displayed, into which all emails of the account are imported
    • Click on the Yes button to start the import process
    UMA Outlook-Plugin Import E-Mail Import Informationen-en.png
    Step 3
    • The start and end of the import process is displayed under
      Statistics
    • The number of successfully imported, failed and skipped emails is displayed
    • The window can be closed after the import process has been completed













    Error messages

    Error messages

    Known problems and their elimination

    Message Possible cause Solution

    Proxy problems

    Proxy problems
    [SESSION INVALID messages during loading] If a system proxy has been set, the login will be loaded directly, but all subsequent web interface parts will be loaded via the proxy.
    This will result in the session not being valid.
    An exception for the UMA must be defined in the proxy settings.

    Error message when viewing a test report or downloading a mail

    Error message when viewing a test report or downloading a mail
    Web browser: getdocument.cgi from uma-name cannot be downloaded Error message when viewing a test report or downloading a mail.
    If all of the following conditions are met, this error may occur:
    The installer of the plugin is built with a 32-bit platform. Therefore on 64-bit systems it will write the value to the key under HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Internet Settings.
      
    • A 64-bit Internet Explorer is used to display the UMA web pages
    • Plugin has been installed by admin account for multiple / other users
      ( The key BypassSSLNoCacheCheck is not installed under HKEY_Current_User\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings written for other users)
    • The check mark "Do not save encrypted pages on the data medium" is ticked.
    The Internet Explorer requires permission to download encrypted pages: Call up Internet Options (call up directly with this term via the search field, or in the Internet Explorer settings). On the Advanced tab, deactivate the checkbox at Do not save encrypted pages on disk.. → Plugin-Prüfbericht-Fehler webbrowser-en.PNG
    UMA Plugin v2.0 Internetoptionen-en.PNG