Sun Java logo     Previous      Contents     Next     

Sun logo
Sun Java[TM] System Identity Manager 7.1 Update 1 Release Notes 

Documentation Additions and Corrections

This section contains new and corrected information that was required after the Identity Manager 7.1 documentation set was published. This information is organized as follows:


Identity Manager Installation

This section provides new information and documentation corrections related to Sun Java System Identity Manager Installation.


Identity Manager Upgrade

This section provides new information and documentation corrections for Sun Java System Identity Manager Upgrade.

Other Custom Repository Objects

Record the names of any other custom repository objects that you created or updated. You might have to export these objects from your current installation and then re-import them to the newer version of Identity Manager after upgrading.

You can use Identity Manager’s SnapShot feature to create a baseline or “snap shot” of the customized repository objects in your deployment, which can be very useful when you are planning an upgrade.

SnapShot copies the following, specific object types from your system for comparison:

You can then compare two snapshots to determine what changes have been made to certain system objects before and after upgrade.


Note

This feature is not intended for detailed, on-going XML diffs — it is only a minimal tool for “first-pass” comparisons.


To create a snapshot:

  1. From the Identity Manager Debug page ( ), click the SnapShot button to view the SnapShot Management page.
  2. Figure 1  SnapShot Management Page
    Example SnapShot Management Page.

  3. Type a name for the snapshot in the Create text box, and then click the Create button.
  4. When Identity Manager adds the snapshot, the snapshot’s name displays in the Compare menu list and to the right of the Export label.

To compare two snapshots:

  1. Select the snapshots from each of the two Compare menus ( ).
  2. Figure 2  SnapShot Management Page
    Select a snapshot name from each Compare menu list.

  3. Click the Compare button.
    • If there are no object changes, then the page indicates that no differences were found.
    • If object changes were found, then the page displays the object type and name, and whether an object is different, absent, or present.
    • For example, if an object is present in baseline_1, but is not present in baseline_2, then the baseline_1 column indicates Present and the baseline_2 column indicates Absent.

You can export a snapshot in XML format. Click the snapshot name to export the snapshot file.

To delete a snapshot, select the snapshot from the Delete menu, and then clicking the Delete button.


Identity Manager Administration Guide

This section provides new information and documentation corrections for Sun Java System Identity Manager Administration.

Chapter 2, Getting Started with Identity Manager

Chapter 3, User and Account Management

Chapter 5, Administration

           Delegations to Deleted Users

Chapter 8, Task Templates

Chapter 11, Identity Auditing

The following information has been added to this chapter:

Continuous Compliance

The information in this section currently states that any provisioning operations performed on a user will cause user- and organization-assigned policies to be evaluated. This information should be corrected to read as follows: (ID-17416)

Continuous compliance means that an audit policy is applied to all provisioning operations, such that an account cannot be modified in a way that does not comply with current policy.

You enable continuous compliance by assigning an audit policy to an organization, a user, or both. Any provisioning operations performed on a user will cause the user-assigned policies to be evaluated. Any resulting policy failure will interrupt the provisioning operation.

Resolving Auditor Capabilities Limitations

By default, capabilities needed to perform auditing tasks are contained in the Top organization (object group). As a result, only those administrators who control Top can assign these capabilities to other administrators.

You can resolve this limitation by adding the capabilities to another organization. Identity Manager provides two utilities, located in the sample/scripts directory, to assist with this task.

  1. Run the following command to list all capabilities (AdminGroups) and their associated organizations (object groups):
  1. Edit the CSV file to adjust the capabilities organizational locations as desired.
  2. Run this command to update Identity Manager.

Adding Rules

Added the following Note to this section (ID-16604, 16831):


Note

Identity Manager does not support the control of rule nesting. In addition, using the Audit Policy Wizard to create policies with Boolean expression nesting can produce unpredictable results.

For complex Rule expressions, use an XML editor to create a separate XPRESS rule that references all of the rules you want to use.


Create the Rule Expression

Changed the Note in this section to read as follows (ID-16604, 16831):


Note

Identity Manager does not support the control of rule nesting. In addition, using the Audit Policy Wizard to create policies with Boolean expression nesting can produce unpredictable results.

For complex Rule expressions, use an XML editor to create a separate XPRESS rule that references all of the rules you want to use.


Chapter 13, Service Provider Administrator

The section titled “Configure Synchronization” should state the default synchronization interval for Service Provider synchronization tasks defaults to 1 minute.

All Chapters

The release date noted in the chapter footers should be 7.1 not 7.0. (ID-16968)


Identity Manager Resources Reference

This section contains new information and documentation corrections for the Sun Java System Identity Manager Resources Reference:

General

Active Directory

The following information should be added to the Active Directory resource adapter documentation.

Specifying a Domain for Pass-Through Authentication

In a default configuration, pass-through authentication is accomplished by sending the user ID and password only. These two attributes are configured in the AuthnProperties element in the resource object’s XML as w2k_user and w2k_password. Without a domain specification, the gateway searches all known domains and tries to authenticate the user in the domain that contains the user.

In a trusted multi-domain environment, there can be two possible situations:

Correction

In the Active Directory documentation, the “Managing ACL Lists” procedure of this guide contains the following step: (ID-16476)

Database Table

Flat File Active Sync

Gateway Adapters

The Domino Gateway, Active Directory, Novell NetWare and other gateway adapters allow you to use the RA_HANGTIMEOUT resource attribute to specify a timeout value, in seconds. This attribute controls how long before a request to the gateway times out and is considered hung.

You must manually add this attribute to the Resource object as follows:

<ResourceAttribute name='Hang Timeout' displayName='com.waveset.adapter.RAMessages:RESATTR_HANGTIMEOUT' type='int' description='com.waveset.adapter.RAMessages:RESATTR_HANGTIMEOUT_HELP' value='NewValue'>
</ResourceAttribute>

The default value for this attribute is 0, indicating that Identity Manager will not check for a hung connection.

Mainframe Adapters

A step is missing in the Identity Manager Installation Notes section for the ACF2, Natural, RACF, RACF-LDAP, Scripted Host, and Top Secret adapters. Add the following step after step 3.

4. When the Attachmate libraries are installed into a WebSphere Application Server, add the property com.wrq.profile.dir=LibraryDirectory to the WebSphere/AppServer/configuration/config.ini file.

This allows the Attachmate code to find the licensing file.

Microsoft SQL Server

The following information should be added to the Usage Notes section:

Windows authentication mode for the SQL Server resource adapter can only be configured on the Microsoft SQL Server adapter if the Identity Manager server is running on a Windows machine that is included in the same Windows security/authentication framework as the SQL Server server instance.

The JDBC driver supports the use of Type 2 integrated authentication on Windows operating systems through the integratedSecurity connection string property. To use integrated authentication, copy the sqljdbc_auth.dll file to a directory on the Windows system path on the computer where the JDBC driver is installed.

The sqljdbc_auth.dll files are installed in the following location:

InstallationDirectory\sqljdbc_Version\Language\auth\

On a 32-bit processor, use the sqljdbc_auth.dll file in the x86 folder. On a 64-bit processor, use the sqljdbc_auth.dll file in the x64 folder.

For more information, see:

http://msdn2.microsoft.com/en-us/library/ms378428.aspx

NetWare

Oracle

Oracle ERP

Remedy

You must place multiple Remedy API libraries in the directory where the Gateway is installed. These libraries can be found on the Remedy server.

Table 3  Remedy API Libraries

Remedy 4.x and 5.x

Remedy 6.3

Remedy 7.0

  • arapiXX.dll
  • arrpcXX.dll
  • arutlXX.dll

where XX matches the version of Remedy. For example, arapi45.dll on Remedy 4.5.

  • arapi63.dll
  • arrpc63.dll
  • arutl63.dll
  • icudt20.dll
  • icuin20.dll
  • icuuc20.dll
  • arapi70.dll
  • arrpc70.dll
  • arutl70.dll
  • icudt32.dll
  • icuin32.dll
  • icuuc32.dll

SAP

General Notes

The note in step 1 in the Identity Manager Installation Notes procedure is unclear. The wording should be


Note

Make sure that the JCo toolkit you download matches the bit version of Java your application server runs on. For example, JCo is available in only in the 64-bit version on the Solaris x86 platform. Therefore, your application server must be running the 64-bit version on the Solaris x86 platform.


Renaming Accounts

The SAP adapter now supports renaming accounts. The adapter performs this function by copying an existing account to a new account and deleting the original. SAP discourages renaming accounts, but provides the option in the user management application (Transaction SU01 from the SAP GUI). Therefore, Identity Manager also supports the option. Be aware that SAP may not support the rename feature in future releases.

The SAP GUI uses a different method to perform the rename because it has access to non-public APIs and to the SAP kernel. The following steps provide a high-level description of how the adapter performs the rename operation:

  1. Get the user information for the existing user.
  2. Save the ALIAS attribute, if one exists.
  3. Create the new user.
  4. Set the Activity Groups on the new user. (If in CUA mode, get the old user's Activity Groups)
  5. Set the Profiles on the new user. (If in CUA mode, get the old user's Profiles.)
  6. Get the old user's Personalization Data.
  7. Set the new user's Personalization Data.
  8. Delete the old user.
  9. Set the Alias on the new user if one was set on the old user.

If an error occurs during steps 1-3, the operation fails immediately. If an error occurs during steps 4-7, the new user is deleted and the whole operation fails. (If the new user cannot be deleted, a warning is placed into the WavesetResult). If an error occurs during steps 8-9, a warning is added to the WavesetResult, but the operation succeeds.

The Rename operation requires that a new password be set on the new user. This is most easily accomplished by customizing the Rename User Task to invoke the Change User Password Task.

Sun Java System Access Manager

Sun Java System Access Manager Realm

The Identity Manager Resources Reference contains outdated links. Use the following links instead:

In the Installation Notes section, the procedure for configuring the Sun Java System Access Manager Realm Resource Adapter has been updated as follows:

  1. Follow the instructions provided in the Sun Java System Access Manager 7 2005Q4 Developer's Guide to build the client SDK from the Sun Access Manager installation.
  2. Extract the AMConfig.properties and amclientsdk.jar files from the war file that is produced.
  3. Put a copy of the AMConfig.properties in the following directory:
  4. InstallDir/WEB-INF/classes

  5. Place a copy of amclientsdk.jar in the following directory:
  6. InstallDir/WEB-INF/lib

  7. Add the amclientsdk.jar file to the server class path.
  8. Restart the Identity Manager application server.
  9. After copying the files, you must add the Sun Java System Access Manager Realm resource to the Identity Manager resources list. Add the following value in the Custom Resources section of the Configure Managed Resources page.

The procedure described in the “Policy Agent” section is outdated. Use the following procedure instead.

  1. From the Identity Manager Administrator Interface menu bar, select Security.
  2. Click the Login tab.
  3. Click the Manage Login Module Groups button, located at the bottom of the page.
  4. Select the Login Module to modify. For example, select Default Identity System ID/Pwd Login Module Group.
  5. In the Assign Login Module select box, select Sun Access Manager Login Module or Sun Access Manager Realm Login Module.
  6. When a new Select option displays next to the Assign Login Module option, select the appropriate resource.
  7. When the Modify Login Module page displays, edit the displayed fields as needed, and then click Save. The Modify Login Module Group is displayed again.
  8. Specify Sun Access Manager Realm Login Module as the first resource in the module group, and then click Save.

UNIX Adapters

The documentation for the AIX, HPUX, Solaris, and Linux adapters previously stated that if you are using sudo, the NOPASSWORD option must be specified for each command the adapter uses. This is incorrect.

Synchronizing LDAP Passwords

Identity Manager now supports LDAP password synchronization Directory Server 5.2 SP5 and later. The Configure Password Synchronization page contains a new field, Directory Server version, which allows you to specify whether your Directory Server instance is 5.2 P4 or earlier, or 5.2 P5 or later.

Note the following documentation changes:


Identity Manager Technical Deployment Overview

This section contains new information and documentation corrections for Sun Java System Identity Manager Technical Deployment Overview:

  1. Import the following XML file:
  2. Code Example 1  XML to Import

    <?xml version='1.0' encoding='UTF-8'?>

    <!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>

    <Configuration name='AltMsgCatalog'>

    <Extension>

    <CustomCatalog id='AltMsgCatalog' enabled='true'>

    <MessageSet language='en' country='US'>

    <Msg id='UI_BROWSER_TITLE_PROD_NAME_OVERRIDE'>Override Name</Msg>

        </MessageSet>

    </CustomCatalog>

    </Configuration>

    </Extension>

  3. Using the Identity Manager IDE, load the System Configuration object for editing. Add a new top-level attribute:
  4. Name = customMessageCatalog

    Type = string

    Value = AltMsgCatalog

  5. Open the ui.web Generic Object and look for the browserTitleProdNameOverride attribute. Set this value to true.
  6. Save this change to the System Configuration object, and restart your application server.
  7. By default, Identity Manager’s anonymous enrollment processing generates values for accountId and emailAddress by using user-supplied first (firstName) and last names (lastName) as well as employeeId. (ID-16131)
  1. Edit the following three rules within the EndUserRuleLibrary as indicated below:
  2. Edit this rule

    To make this change...

    getAccountId

    To use employeeId only (and remove firstName and lastName)

    getEmailAddress

    To use employeeId only (remove firstName, lastName, and ".")

    verifyFirstname 

    To change length check from 2 to 1 to allow for single character Asian first names

  3. Edit the End User Anon Enrollment Completion form to remove the firstName and lastName arguments from calls to the getAccountId and getEmailAddress rules.
  4. The discussion of how to customize the login pages in Chapter 5 “Private Labeling of Identity Manager” should include the following information about message keys. (ID-16702)
  5. JSP or Identity Manager Component

    Interface Affected

    Message Key

    Login Page TITLE

    Administrator and User

    UI_LOGIN_TITLE_TO_RESOURCE

    UI_LOGIN_CHALLENGE

    Login Page SUBTITLE

    Administrator and User

    Select a key depending on the login mode: Forgot Password, Forgot User ID, Login Challenge.

    UI_LOGIN_WELCOME3

    UI_LOGIN_WELCOME4

    UI_LOGIN_WELCOME5

    UI_LOGIN_WELCOME6

    UI_LOGIN_CHALLENGE_INFO

    staticLogout.jsp and user/staticUserLogout.jsp

    Administrator and User

    UI_LOGIN_TITLE

    continueLogin.jsp

    Administrator

    UI_LOGIN_IN_PROGRESS_TITLE

    UI_LOGIN_WELCOME


Identity Manager Workflows, Forms, and Views

This section contains new information and documentation corrections for Sun Java System Identity Manager Workflows, Forms, and Views.

Chapter 1, Identity Manager Workflow