Enabling Outlook Extension Authentication Through Command Line
Outlook Extension uses an authentication token stored at HKEY_CURRENT_USER\Software\MessageOne\EMS\Profile Info\<profile name>\AuthToken
to allow a user to use the Extension features without having to log in to Aurea Messaging Solutions. The token can be created by a user logging in with a password, or the administrator can use the PrepareOutlookAuth tool to create the token. After the authentication token is set, the user will not need to log in again during an activation or while using other Extension features.
NOTE
For best results, run this command a day or two before deploying the Outlook Extension, so that the SyncManager has time to complete a sync before the software is installed for users. Otherwise, users must restart Outlook again after the next directory sync.
PrepareOutlookAuth is installed on the same machine that hosts the SyncManager. You must complete a directory sync before running PrepareOutlookAuth.
The following arguments are available.
Argument | Definition |
-all |
Updates authentication for all users. It walks through all user mailboxes and writes an authentication token to a hidden message if a token is not already present. The message is stored in the associated Contents table of the Example:
|
-rewrite |
Writes authentication tokens to all mailboxes (even if a token is already present) |
-user <mailboxDN> |
Writes an authentication token for a specific user only (even if a token is already present). The Mailbox DN value comes from the Active Directory value legacyExchangeDN. Use ADSI Edit to find this value. The value must be entered in lower case, in quotes (for example: Example:
|
-primarySMTPAddress <primary email address> |
Outlook token update for a single user defined by their primary SMTP email address. Example:
|
-inputFile "full_path\filename.txt" |
Outlook token update for all users listed in an input file. Example:
|
-exchangeServerFile “full_path\filename.txt” |
Outlook token update for all users belonging to Exchange servers that are listed in an input file. Example:
|
-verbose |
Enables verbose output |
-help |
Displays usage information |
To authenticate users through the command line (prior to Outlook Extension deployment)
- Open a command-line prompt on the server on which SyncManager is installed.
- Go to the following directory:
C:\[
Program Files (x86)]\Aurea\Outlook Addin\
- Run prepareoutlookauth.exe using the appropriate flag as documented in the previous table.
- Wait for the new mailbox properties to take effect. This may take up to 24 hours.
Install Outlook Extension using one of the documented processes. When a user starts Outlook, the Extension toolbar appears, and the user has access to Extension features without entering his password.