User guide

Licensed Customer Confidential Installing the Outlook® Extension
Email Continuity Administrator Guide version 6.5 (1st ed.) 75
Enabling User Authentication Through the Command Line
You can use the command line tool PrepareOutlookAuth to authenticate
(register) users automatically. This allows authenticated (registered) users to use
Extension features without providing a password. The tool is installed with the
SyncManager on the primary controller. You must complete a directory sync
before running this tool. When you run the tool using the -all argument, it walks
through all user mailboxes and writes an authentication token to a hidden
message if a token is not there already. The message is stored in the associated
Contents table of the IPM_SUBTREE folder. If you have developer tools such as
MFCMapi or Outlook Spy, you can look at the Associated Contents table of the
IPM_SUBTREE folder for the message with the subject Authentication.
NOTE SyncManager
MessageLabs recommends you upgrade the SyncManager software to version
6.0 or later prior to installing the Extension. If your organization uses distributed
SyncManager, the PrepareOutlookAuth tool should only be run on the primary
SyncManager server.
TIP Run PrepareOutlookAuth prior to deploying the Outlook Extension
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.
The following arguments are available. You must use either -user<mailboxDN>
or -all. Other arguments are optional.
Table 3-2 PrepareOutlookAuth Arguments
Argument Definition
-all Updates authentication for all users
-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: “/o=first organization/ou=first
administrative group/cn=recipients/cn=testuser”
-verbose Enables verbose output
-help Displays usage information