1 About the Connector

Oracle Identity Manager automates access rights management, security, and provisioning of IT resources. Oracle Identity Manager connectors are used to integrate Oracle Identity Manager with third-party applications. The connector for Microsoft Exchange 2000 and 2003 is used to integrate Oracle Identity Manager with Microsoft Exchange 2000 and 2003.

Note:

Oracle Identity Manager connectors were referred to as resource adapters prior to the acquisition of Thor Technologies by Oracle.

This chapter contains the following sections:

• Reconciliation Module

• Provisioning Module

• Supported Functionality

• Multilanguage Support

• Files and Directories That Comprise the Connector

• Determining the Release Number of the Connector

Note:

At some places in this guide, Microsoft Exchange 2000 and 2003 have been referred to as target systems.

Reconciliation Module

Reconciliation involves duplicating in Oracle Identity Manager additions of and modifications to user accounts on the target system. It is an automated process initiated by a scheduled task that you configure.

See Also:

The "Deployment Configurations of Oracle Identity Manager" section in Oracle Identity Manager Connector Framework Guide for conceptual information about reconciliation configurations

The following target system fields are reconciled:

• Display Name

• Employee Type

• Mobile Number

• Pager Number

• ObjectGUID

• SAMAccountName

• Mail

• Mail Nick Name

• Garbage Collection Period

• Deleted Item Flags

• Delivery Cont Length

• Submission Cont Length

• DB Over Hard Quota Limit

• DB Over Quota Limit

• DB Storage Quota

• Exchange Recipient Limit

• DB User Defaults

• Exchange Hide From Address Lists

• Employee ID

• Street Address

• Telephone Number

• Other Telephone Number

• Extension Attribute1

• Extension Attribute2

• Extension Attribute3

• Extension Attribute4

• Extension Attribute6

• Extension Attribute8

• Extension Attribute12

• Extension Attribute15

• Distinguished Name

Provisioning Module

Provisioning involves creating or modifying a user's account information on the target system through Oracle Identity Manager. You use the Administrative and User Console to perform provisioning operations.

See Also:

The "Deployment Configurations of Oracle Identity Manager" section in Oracle Identity Manager Connector Framework Guide for conceptual information about provisioning

For this target system, the following fields are provisioned:

• Email Alias

• Display Name

• Garbage Collection Period

• Deleted Item Manager

• Max Incoming Message Size

• Max Outgoing Message Size

• Mailbox Size Receipt Quota

• Mailbox Size Transmit Quota

• Mailbox Warning Size

• Max Recipients Per Message

• Use Storage Defaults

• Hide From Address Lists

• Rout Email

• Employee Type

• Registered Represent

• Desk Location

• PL Proceed

• Company Address

• Mailbox Type

• Mobile Number

• Pager Number

• Routing Email Addr

• Major Business Number

• Other Business Number

• ObjectGUID

Supported Functionality

The following table lists the functions that are available with this connector.

Process Task	Type	Description
Create Mailbox	Provisioning	Creates a mailbox in Microsoft Exchange 2000 and 2003
Delete Mailbox	Provisioning	Deletes a provisioned mailbox from Microsoft Exchange 2000 and 2003
Deleted Item Manager Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Deleted Item Manager attribute
Disable Mailbox	Provisioning	Disables a provisioned mailbox in Microsoft Exchange 2000 and 2003
Display Name Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Display Name attribute
Email Alias Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Email Alias attribute
Enable Mailbox	Provisioning	Enables a disabled mailbox in Microsoft Exchange 2000 and 2003
Garbage Collection Period Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Garbage Collection Period attribute
Hide From Address Lists Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Hide From Address Lists attribute
Mailbox Size Receipt Quota Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Mailbox Size Receipt Quota attribute
Mailbox Size Transmit Quota Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Mailbox Size Transmit Quota attribute
Mailbox Warning Size Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Mailbox Warning Size attribute
Max Incoming Message Size Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Max Incoming Message Size attribute
Max Outgoing Message Size Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Max Outgoing Message Size attribute
Max Recipients Per Message Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Max Recipients Per Message attribute
Disable Mailbox Time Stamp Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Disable Mailbox Time Stamp attribute
Set Exchange Related Properties	Provisioning	Updates certain important configurations of a mailbox in Microsoft Exchange 2000 and 2003
Use Storage Defaults Updated	Provisioning	Updates the configuration of a mailbox in Microsoft Exchange 2000 and 2003 according to a change in the Use Storage Defaults attribute
Get ObjectGUID from Process	Provisioning	Retrieves the ObjectGUID (unique identifier in Microsoft Active Directory) for an existing provisioned Microsoft Active Directory user, for whom a Microsoft Exchange 2000 and 2003 mailbox needs to be provisioned
Create Mailbox	Reconciliation	Reconciles a mailbox from Microsoft Exchange 2000 and 2003 into Oracle Identity Manager

Multilanguage Support

This release of the connector supports the following languages:

• Chinese Simplified

• Chinese Traditional

• English

• French

• German

• Italian

• Japanese

• Korean

• Portuguese (Brazilian)

• Spanish

See Also:

Oracle Identity Manager Globalization Guide for information about supported special characters

Files and Directories That Comprise the Connector

The files and directories that comprise this connector are in the following directory on the installation media:

Collaboration and Messaging Applications/Microsoft Exchange

These files and directories are listed in the following table.

File in the Installation Media Directory	Description
lib/xliExchange.jar	This JAR file contains the class files required for provisioning and reconciliation.
Files in the resources directory	Each of these resource bundle files contains language-specific information that is used by the connector. Note: A resource bundle is a file containing localized versions of the text strings that are displayed on the user interface of Oracle Identity Manager. These text strings include GUI element labels and messages displayed on the Administrative and User Console.
xml/xliExchangeObject_DM.xml	This XML file contains definitions for the following components of the connector: IT resource type Custom process form Process task and adapters (along with their mappings) Resource object Provisioning process Pre-populate rules
xml/xliExchangeSchedulerTask_DM.xml	This XML file contains the parameters for setting up the reconciliation scheduled task.

The "Step 3: Copying the Connector Files" section provides instructions to copy these files into the required directories.

Determining the Release Number of the Connector

You can use any one of the following methods to determine the release number of the connector.

Before Deployment

To determine the release number of a connector:

1. Extract the contents of the xliExchange.jar file. This file is in the following directory on the installation media:

   Collaboration and Messaging Applications/Microsoft Exchange/lib
   
   

2. Open the manifest.mf file in a text editor. The manifest.mf file is one of the files bundled inside the xliExchange.jar file.

   In the manifest.mf file, the release number of the connector is displayed as the value of the Version property.

Note:

If you maintain a copy of the xliExchange.jar file after deployment, you can use this method to determine the release number of the connector at any stage. After you deploy the connector, it is recommended that you use the "After Deployment" method, which is described in the following section.

After Deployment

To determine the release number of a connector that has already been deployed:

See Also:

Oracle Identity Manager Design Console Guide

1. Open the Oracle Identity Manager Design Console.

2. In the Form Designer, open the process form. The release number of the connector is the value of the Version field.