Oracle Identity Manager Connector Guide For IBM Lotus .

Oracle Identity ManagerConnector Guide for IBM Lotus Notes and DominoRelease 9.0.1B31117-01June 2006

Oracle Identity Manager Connector Guide for IBM Lotus Notes and Domino, Release 9.0.1B31117-01Copyright 2006, Oracle. All rights reserved.Primary Authors:Debapriya Datta, Shiladitya Guha, Venkatasubramaniam IyerContributing Authors:Don Gosselin, Lyju VadasseryThe Programs (which include both the software and documentation) contain proprietary information; theyare provided under a license agreement containing restrictions on use and disclosure and are also protectedby copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly,or decompilation of the Programs, except to the extent required to obtain interoperability with otherindependently created software or as specified by law, is prohibited.The information contained in this document is subject to change without notice. If you find any problems inthe documentation, please report them to us in writing. This document is not warranted to be error-free.Except as may be expressly permitted in your license agreement for these Programs, no part of thesePrograms may be reproduced or transmitted in any form or by any means, electronic or mechanical, for anypurpose.If the Programs are delivered to the United States Government or anyone licensing or using the Programs onbehalf of the United States Government, the following notice is applicable:U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical datadelivered to U.S. Government customers are "commercial computer software" or "commercial technical data"pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. Assuch, use, duplication, disclosure, modification, and adaptation of the Programs, including documentationand technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle licenseagreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, CommercialComputer Software--Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA94065.The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherentlydangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,redundancy and other measures to ensure the safe use of such applications if the Programs are used for suchpurposes, and we disclaim liability for any damages caused by such use of the Programs.Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or itsaffiliates. Other names may be trademarks of their respective owners.The Programs may provide links to Web sites and access to content, products, and services from thirdparties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites.You bear all risks associated with the use of such content. If you choose to purchase any products or servicesfrom a third party, the relationship is directly between you and the third party. Oracle is not responsible for:(a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with thethird party, including delivery of products or services and warranty obligations related to purchasedproducts or services. Oracle is not responsible for any loss or damage of any sort that you may incur fromdealing with any third party.

ContentsPreface . vAudience.Documentation Accessibility .Related Documents .Documentation Updates .Conventions .1About the ConnectorSupported Functionality .Reconciliation Module .Lookup Fields Reconciliation .User Reconciliation .Provisioning Module.Files and Directories That Comprise the Connector .21-11-21-21-21-31-3Deploying the ConnectorStep 1: Verifying Deployment Requirements.Step 2: Copying the Connector Files and External Code .Step 3: Importing the Connector XML File .Defining IT Resources .Step 4: Configuring Reconciliation.Specifying Values for the Scheduled Task Attributes .Lookup Fields Reconciliation Scheduled Task .User Reconciliation Scheduled Task .Step 5: Compiling Adapters .Step 6: Configuring SSL.3vvvivivi2-12-12-22-32-52-52-52-62-62-7Testing the ConnectorRunning Test Cases. 3-1Troubleshooting. 3-24Known IssuesIndexiii

iv

PrefaceOracle Identity Manager Connector Guide for IBM Lotus Notes and Domino providesinformation about integrating Oracle Identity Manager with IBM Lotus Notes andDomino.Note: This is a transitional release following Oracle's acquisition ofThor Technologies. Some parts of the product and documentation stillrefer to the original Thor company name and Xellerate product nameand will be rebranded in future releases.AudienceThis guide is intended for users who want to deploy the Oracle Identity Managerconnector for IBM Lotus Notes and Domino.Documentation AccessibilityOur goal is to make Oracle products, services, and supporting documentationaccessible, with good usability, to the disabled community. To that end, ourdocumentation includes features that make information available to users of assistivetechnology. This documentation is available in HTML format, and contains markup tofacilitate access by the disabled community. Accessibility standards will continue toevolve over time, and Oracle is actively engaged with other market-leadingtechnology vendors to address technical obstacles so that our documentation can beaccessible to all of our customers. For more information, visit the Oracle AccessibilityProgram Web site y of Code Examples in DocumentationScreen readers may not always correctly read the code examples in this document. Theconventions for writing code require that closing braces should appear on anotherwise empty line; however, some screen readers may not always read a line of textthat consists solely of a bracket or brace.Accessibility of Links to External Web Sites in DocumentationThis documentation may contain links to Web sites of other companies ororganizations that Oracle does not own or control. Oracle neither evaluates nor makesany representations regarding the accessibility of these Web sites.v

TTY Access to Oracle Support ServicesOracle provides dedicated Text Telephone (TTY) access to Oracle Support Serviceswithin the United States of America 24 hours a day, seven days a week. For TTYsupport, call 800.446.2398.Related DocumentsFor more information, refer to the following documents in the Oracle Identity Managerdocumentation set: Oracle Identity Manager Release Notes Oracle Identity Manager Installation and Upgrade Guide for JBoss Oracle Identity Manager Installation and Upgrade Guide for WebLogic Oracle Identity Manager Installation and Upgrade Guide for WebSphere Oracle Identity Manager Administrative and User Console Guide Oracle Identity Manager Administrative and User Console Customization Guide Oracle Identity Manager Design Console Guide Oracle Identity Manager Tools Reference Guide Oracle Identity Manager Audit Report Developer Guide Oracle Identity Manager Best Practices Guide Oracle Identity Manager Connector Framework Guide Connector guides for various third-party applicationsDocumentation UpdatesOracle is committed to delivering the best and most recent information available. Forinformation about updates to the Oracle Identity Manager 9.0.1 connectordocumentation set, visit Oracle Technology Network ndex.htmlConventionsThe following text conventions are used in this document:viConventionMeaningboldfaceBoldface type indicates graphical user interface elements associatedwith an action, or terms defined in text or the glossary.italicItalic type indicates book titles, emphasis, or placeholder variables forwhich you supply particular values.monospaceMonospace type indicates commands within a paragraph, URLs, codein examples, text that appears on the screen, or text that you enter.

1About the ConnectorOracle Identity Manager automates access rights management, security, andprovisioning of IT resources. Oracle Identity Manager connectors are used to integrateOracle Identity Manager with third-party applications. The connector for IBM LotusNotes and Domino is used to integrate Oracle Identity Manager with IBM Lotus Notesand Domino.Oracle Identity Manager connectors were referred to asresource adapters prior to the acquisition of Thor Technologies byOracle.Note:This chapter contains the following sections: Supported Functionality Reconciliation Module Provisioning Module Files and Directories That Comprise the ConnectorSupported FunctionalityThe following table lists the functions that are available with this connector.FunctionTypeDescriptionAdd UserProvisioningCreates a userDelete UserProvisioningDeletes a userUpdate User Last NameProvisioningUpdates the last name of a userUpdate User First NameProvisioningUpdates the first name of a userUpdate User Middle NameProvisioningUpdates the middle name of a userUpdate User OrganizationUnitProvisioningUpdates the organization unit of a userUpdate User Short NameProvisioningUpdates the short name of a userUpdate User Mail InternetAddressProvisioningUpdates the e-mail address of a userUpdate User LocationProvisioningUpdates the location of a userUpdate User CommentProvisioningUpdates the comment of a userAbout the Connector1-1

Reconciliation ModuleFunctionTypeDescriptionUpdate User ForwardDomainProvisioningUpdates the e-mail address to whiche-mail for the user should be forwardedUpdate User PasswordProvisioningUpdates the user password and resets theID fileDisable UserProvisioningDisables a userEnable UserProvisioningEnables a userReconcile lookup fieldReconciliationReconciles the lookup fieldsReconcile User DataReconciliationTrusted mode: Reconciles user data fromIBM Lotus Notes and Domino to OracleIdentity Manager. A corresponding user iscreated in Oracle Identity Manager. If theuser already exists in Oracle IdentityManager, then this user is updated.Nontrusted mode: Reconciles user datafrom IBM Lotus Notes and Domino toOracle Identity Manager. A user is notcreated in Oracle Identity Manager.Note: The Delete User provisioning function is implemented by usingthe DeleteUser Administration Process (AdminP) function of IBMLotus Notes and Domino. Similarly, the RenameNotesUserAdminP function is used to implement the following provisioningfunctions:Update User Last NameUpdate User First NameUpdate User Middle NameUpdate User Organization Unit When you create a user, you must specify the End Date in theDD/MM/YY format.Reconciliation ModuleThis section describes the elements that the reconciliation module extracts from thetarget system to construct reconciliation event records.Reconciliation can be divided into the following types: Lookup Fields Reconciliation User ReconciliationLookup Fields ReconciliationLookup fields reconciliation involves reconciling the Group lookup field.User ReconciliationUser reconciliation involves reconciling the fields that are used to store userinformation in IBM Lotus Notes and Domino. These fields are:1-2 Oracle Identity Manager Connector Guide for IBM Lotus Notes and Domino

Files and Directories That Comprise the Connector FirstName MiddleName LastName ShortName Password OrgUnit MailInternetAddress Location Comment ForwardDomain EndDate SecurityType Group OldLastName OldFirstName OldMiddleName OldOrgUnitProvisioning ModuleThe following fields of IBM Lotus Notes and Domino are provisioned: FirstName MiddleName LastName ShortName Password OrgUnit MailInternetAddress Location Comment ForwardDomain EndDate SecurityType GroupFiles and Directories That Comprise the ConnectorThe files and directories that comprise this connector are compressed in the followingZIP file on the installation media:Collaboration and Messaging Applications\IBM Lotus Notes Domino\IBM Lotus NotesAbout the Connector1-3