What's New in the Oracle Identity Manager Advanced Connector for CA Top Secret?

This chapter provides an overview of the updates made to the software and documentation for the Oracle Identity Manager Advanced Connector for CA Top Secret in release 9.0.4.20.

The updates discussed in this chapter are divided into the following categories:

Software Updates

The following sections discuss software updates:

Software Updates in Release 9.0.4.20

The following are the software updates in release 9.0.4.20:

End of Life Support for Trusted Source Reconciliation

From this release onward, the connector no longer supports trusted source reconciliation. Only target resource reconciliation is supported.

Support for Oracle Identity Manager Release 11.1.2.3.0

From this release onward, the connector can be installed and used on Oracle Identity Manager 11g Release 2 PS3 (11.1.2.3.0).

See Section 1.1, "Certified Components" for the full list of certified Oracle Identity Manager releases.

Resolved Issues in Release 9.0.4.20

The following table lists issues resolved in release 9.0.4.20:

Bug Number Issue Resolution
18962680 The Code Key and Decode values of the Lookup.ProfileNames lookup definition used a dash (-) instead of a tilde (~). This issue has been resolved.
20270833 CICSOPCLASS mapped incorrectly when reconciled through VOYAGER. This issue has been resolved.

Software Updates in Release 9.0.4.19

The following are the software updates in release 9.0.4.19:

Support for Three New VOYAGER Enhancements

From this release onward, the connector supports the following VOYAGER enhancements:

  1. MSGID01=<YES|NO>,IDMV602E,xx - for LDAP recovery message suppression.

  2. RECOVERY_INTERVAL=xxx,<MINS|SECS> - recovery interval for IP addresses.

  3. DNS_RECOVERY_INTERVAL=xxx,<MINS|SECS> - recovery interval for DNS addresses.

Addition of STARTUP and WRAPUP

From this release onward, STARTUP and WRAPUP have been added back as the method of creating the Subpool for VOYAGER and deleting the Subpool. The VOYAGER control file parameter (SUBPOOL_SIZE=) is no longer supported.

Support for New PIONEER Enhancement

From this release onward, the connector supports a new PIONEER enhancement. EXPORT_MON=YES, REC=01000 – CFILE transfer monitor while PIONEER is running.

Support for VOYAGER AUDIT Log

From this release onward, the VOYAGER Audit log, turned on with VOYAGER parameter AUDIT_LOG=YES has been enhanced to show ACID being processed as well as the number of items or messages read from the Subpool.

Resolved Issues in Release 9.0.4.19

The following table lists issues resolved in release 9.0.4.19:

Bug Number Issue Resolution
18950032 High-availability reconciliation was not supported for users who were deleted from the internal LDAP store. This issue has been resolved. High-availability reconciliation of deleted internal LDAP users is now supported.
18231514 CFILE XML error messages were not logged to the main LDAP gateway log file. This issue has been resolved. CFILE XML error messages are now logged to both the XML error log and main LDAP gateway log file.
19239326 The LDAP Gateway server returned a generic exception when granting a duplicate entitlement to a user. This issue has been resolved. Support for error code 64, User Already Linked to Group/Profile, has been added to all provisioning functions that grant an entitlement to a user.
19316338 The LDAP gateway lacked support for reconciling the display name of a ZONE to which a user belongs. This issue has been resolved. The LDAP gateway now supports both scheduled task and real-time reconciliation of the ZONE display name attribute and value.
19308581 The LDAP gateway did not correctly format a TSOCOMMAND value containing spaces or single quotation marks. This issue has been resolved. The LDAP gateway now properly formats a TSOCOMMAND value that contains a space character, single quotation mark, or both.

Software Updates in Release 9.0.4.18

The following are the software updates in release 9.0.4.18:

Support for New Oracle Identity Manager Release

From this release onward, the connector can be installed and used on Oracle Identity Manager 11g release 2 (11.1.2.0.1) or later. Where applicable, instructions specific to this Oracle Identity Manager release have been added in the guide.

See Section 1.1, "Certified Components" for the full list of certified Oracle Identity Manager releases.

Resolved Issues in Release 9.0.4.18

The following table lists issues resolved in release 9.0.4.18:

Bug Number Issue Resolution
16828743 Users reconciled to Oracle Identity Manager using the CFILE XML processing feature did not include all permission data needed to certify in accordance with SOX. This issue has been resolved. Users and profiles reconciled using the CFILE XML processing feature will now include all necessary permission data required to certify in accordance with SOX.
17628090 Mainframe agent log messages did not contain a date, timestamp, or message code. Messages produced by the mainframe were not described in the documentation. This issue has been resolved. Documentation has been updated to better describe mainframe log messages. Where applicable, date, timestamp, and message codes have been added to the mainframe log messages.
16925326 The 9.0.4.17 connector XML throws an error when importing the connector. This issue has been resolved. The 9.0.4.18 XML no longer throws any errors during connector import or connector upgrade operations.
16855865 The run script used to start the LDAP gateway did not add the correct Oracle Identity Manager libraries to the classpath. This issue has been resolved. The LDAP gateway run script now adds the correct Weblogic and Oracle Identity Manager libraries to the classpath.

Software Updates in Release 9.0.4.17

The following are the software updates in release 9.0.4.17:

Support for Scheduled Task – Reconcile Deleted Users to Oracle Identity Manager

From this release onward, the connector supports an additional scheduled task for reconciling deleted users on the target system. This task retrieves a list of users from the target system and compares that list with a list of users from Oracle Identity Manager. If a user is found to exist within Oracle Identity Manager, but not on the target system, then a delete reconciliation event for the user is sent to Oracle Identity Manager. See Section 4.4.2.2, "Top Secret Reconcile Deleted Users to OIM" for more details.

Support for Scheduled Task – Reconcile Users to Internal LDAP

From this release onward, the connector supports an additional scheduled task for reconciling users on the target system to the internal LDAP store. This task retrieves a list of users and their profiles from the target system and reconciles each user to the internal LDAP gateway metastore. See Section 4.4.2.3, "Top Secret Reconcile Users to Internal LDAP" for more details.

Support for Scheduled Task – Reconcile LDAP Users to Oracle Identity Manager

From this release onward, the connector supports an additional scheduled task for reconciling users from the internal LDAP store to Oracle Identity Manager. This task retrieves a list of users from the internal LDAP store and reconciles those users to Oracle Identity Manager. See Section 4.4.2.4, "Top Secret Reconcile All LDAP Users" for more details.

Support for LU6.2 Attributes During Provisioning and Reconciliation Operations

From this release onward, the connector supports provisioning and reconciliation of LU6.2 attributes. Specifically, support for the #APPL, #ENTITY, BC1CHAIN, BC2CHAIN, SET1DISP, and SET2DISP attributes has been added to TSS CREATE, ADDTO, REPLACE, REMOVE, and LIST commands.

Support for Top Secret RENAME Provisioning Operation

From this release onward, the connector supports the RENAME Top Secret operation. See Section 1.5.1, "Supported Functions for Target Resource Reconciliation" and Section 1.5.2, "Supported Functions for Provisioning" for more details.

Support for Top Secret GENCERT Provisioning Operation

From this release onward, the connector supports provisioning of the GENCERT Top Secret operation. See Section 1.5.2, "Supported Functions for Provisioning" and Section 1.5.9, "Provisioning GENCERT Operations" for more details.

Support for Top Secret GENREQ Provisioning Operation

From this release onward, the connector supports provisioning of the GENREQ Top Secret operation. See Section 1.5.2, "Supported Functions for Provisioning" and Section 1.5.10, "Provisioning GENREQ Operations" for more details.

Support for Configurable Property for Revoking PSUSPEND Users

From this release onward, the connector properties file includes a configurable property for revoking users with the PSUSPEND attribute. See Section 2.6, "Installing and Configuring the LDAP Gateway" for more details.

Support for Configurable Lookup Code Name in Scheduled Tasks

From this release onward, the FindAllResources, FindAllDatasets, FindAllProfiles, and FindAllFacilities scheduled tasks include a property called Lookup Code Names. This property is used to specify the lookup code name where results of the task should be stored. See Section 4.2, "Scheduled Tasks for Lookup Field Synchronization" for more details.

Support for Pioneer and Voyager Parameters in a Control File

Support for all Pioneer and Voyager parameters are now contained in a parameter or control file pointed to by "//PARMFLE" ddname on both PIONEER and Voyager. This file can be a QSAM (recfm=f,lrecl=80,blksize=80,dsorg=ps) or a pds member. See Section 3.8, "Configuring the Started Tasks" for more details.

Support for New Pioneer Function for LDAP

A full export of Top-Secret CFILE data will now be done through a conversion utility provided converting it to XML for input into Pioneer. This XML data will be sent to the LDAP on-demand.

Removal of STARTUP and WRAPUP

STARTUP and WRAPUP have been removed. Their functions have been incorporated into Voyager. Voyager has a new SUBPOOL_SIZE= parameter that is used to allocate the CACHE (Subpool) for reconciliation messages.

Support for a New Pioneer-Message Function in Voyager

A new parameter has been added to Voyager, "PIONEER_DELETE_MSGS=YES" or "PIONEER_DELETE_MSGS=NO". This new parameter will force Voyager to process or not process messages originating from Pioneer.

Resolved Issues in Release 9.0.4.17

The following table lists issues resolved in release 9.0.4.17:

Bug Number Issue Resolution
16236789 Updates to the UserLogin attribute fails. This issue has been resolved. Support for the TSS RENAME command is now included.
16266065 Updates to the UserLogin attribute fails. This issue has been resolved. Support for the TSS RENAME command is now included.
16515205 Single-use password with EXPIRE does not work. This issue has been resolved. EXPIRE is now a supported attribute in provisioning and reconciliation functions.
16510636 Connector does not include support for both GROUPS and PROFILES operations. This issue has been resolved. Users can now be provisioned and removed from TSS GROUPS and PROFILES, and their group and profile memberships are now supported during reconciliation.
16240718 Updates to the FullName attribute in OIM are not successfully committed to the mainframe. This issue has been resolved. The Full Name attribute is now successfully updated in provisioning operations.
15958873 The "Reconcile All Users" scheduled task is not working. This issue has been resolved. All reconciliation scheduled task functions are now working.
13419640 Maclib.xmi is referenced in the documentation but is not included in the installation media. This issue has been resolved. Maclib.xmi has been removed from the installation media and is no longer referenced in the documentation.
12675647 Maclib.xmi is referenced in the documentation but is not included in the installation media. This issue has been resolved. Maclib.xmi has been removed from the installation media and is no longer referenced in the documentation.

Software Updates in Release 9.0.4.16

The following are the software updates in release 9.0.4.16:

Support for New Reconcile All Users Scheduled Task Properties

From this release onwards, the connector supports the new All Users scheduled task properties. The TSS Reconcile All Users scheduled task properties have been updated. Users can now customize the UID case during reconciliation, and reconciliation of individual users through the scheduled task is now supported. See Table 4-3 for more details.

Support for New Feature

From this release onwards, the connector supports a new feature. The Oracle Identity Manager reconciliation feature ignoreEvent() is now included. The LDAP Gateway will now confirm whether a reconciliation event should be ignored before creating the event in Oracle Identity Manager. Both real-time reconciliation and full reconciliation utilize this feature. See Section 1.3.2.1, "Full Reconciliation Process" and Section 1.3.2.3, "Incremental (Real-Time) Reconciliation Process" for more details.

Resolved Issues in Release 9.0.4.16

The following table lists issues resolved in release 9.0.4.16:

Bug Number Issue Resolution
14048660 The Oracle Identity Manager CA Top Secret connector is unable to reconcile attribute values containing "=" character. This issue has been resolved. Now the Oracle Identity Manager CA Top Secret connector is allowing "=" characters to be parsed in INSTALLATION-DATA field.
13682327 The reconciliation class name for full user reconciliation is identical for both RACF and Top Secret full user reconciliation. This issue has been resolved. The reconciliation class name for full user reconciliation can now use with other mainframe connectors.
11795039 The Oracle Identity Manager CA Top Secret connector is unable to reconcile profiles correctly. This issue has been resolved. The Oracle Identity Manager CA Top Secret connector now allows profiles to be reconciled per user on the child-form.
7359488 The logging is inconsistent in the Oracle Identity Manager CA Top Secret connector. This issue has been resolved. All logging is using OIM logger in adapters.

Software Updates in Release 9.0.4.15

The following are the software updates in release 9.0.4.15:

  • A new Pioneer Control File Parameter QUEUE_DSN= has been added.

  • The value of JWAIT= parameter has been changed.

  • The value of RWAIT= parameter has been changed.

    See Section 3.8, "Configuring the Started Tasks" for more details.

Resolved Issues in Release 9.0.4.15

The following table lists issues resolved in release 9.0.4.15:

Bug Number Issue Resolution
13696296 The connector dataset name should be customizable. This issue has been resolved. You need to customize the CLIST.DONE.FILE dataset name in order to get the Oracle Identity Manager Top Secret Advanced connector up and running.
13828279 The user is generating an exception crash during reconciliation. This issue has been resolved. The user can now successfully run the reconciliation.
13847821 The RWAIT parameter is not being honored by the pioneer agent before sending to LDAP. This issue has been resolved. The RWAIT parameter is now successfully honored by the pioneer agent before sending to LDAP.

Software Updates in Release 9.0.4.14

The following are the software updates in release 9.0.4.14:

Support for New Lookup Definition Scheduled Tasks

From this release onward, the connector includes scheduled tasks for storing all resources, profiles, facilities, and datasets in lookup definitions. These lookups are used during the provisioning process, allowing the user to select an existing profile, resource, facility, or dataset from a lookup list, instead of manually entering the name in the provisioning form.

See Section 1.5, "Connector Objects Used During Reconciliation and Provisioning" for more information.

Support for Provisioning Functions

From this release onward, new provisioning functions are supported by the connector.

See Section 1.5.2, "Supported Functions for Provisioning" for more details.

Support for New IT Resource Parameters

From this release onward, new IT resource parameters are supported by the connector.

See Section 2.3, "Configuring the IT Resource" for more information.

Support for SSL Configuration in LDAP Gateway

From this release onward, SSL configuration in LDAP Gateway has been supported.

SeeSection 2.6, "Installing and Configuring the LDAP Gateway" for more information.

Support for Voyager and Pioneer Parameters Using a Control File

From this release onward, the Voyager STC will not pass any STC parameters. They are now contained in a QSAM file pointed to by the PARMFLE "DD" statement. Pioneer will now only pass four parameters, TCPN, IPAD, PORT, and DEBUG. All other parameters are passed through the control file.

Support for Voyager and Pioneer Enhanced Operator Command

In this release, new set of commands for Pioneer and Voyager are included.

See Chapter 3, "Connector Deployment on the Mainframe" for more information.

Support for Post-processing within Pioneer Based on Top-Secret Command

In this release, ability for Pioneer to post-process with the usage of one of the three Top-Secret commands, Create, Addto, and Remove commands, has been introduced. The format and functionally is explained in Chapter 3, "Connector Deployment on the Mainframe". The output of the Post-Processing, where it worked or not, is the responsibility of the installation and not Pioneer.

Support for ALIAS Processing within Pioneer Based on LDAP Command

In this release, ability for Pioneer process LDAP ALIAS Defines and Deletes, has been introduced. The ALIAS request will come into Pioneer and Pioneer using the INJCLR "DD" submits the DEFINE or DELETE with the INJCLR JCl wrapped around it. The output is sent back to the LDAP. The "JWAIT= parameter" is new and is used as a wait timer for the job to finish completion.

See Section 3.8, "Configuring the Started Tasks" for more information.

Support for New Scheduled Tasks Configuration

From this release onward, a set of new scheduled task configurations have been supported.

See Table 4-0, "Scheduled Tasks for Lookup Field Synchronization" for more information.

Support for Initial Reconciliation Through Scheduled Task

From this release onward, initial reconciliation is no longer performed using the topsecret-initial-recon-adapter deployment. Instead, initial reconciliation is supported through the TopSecret Reconcile All Users scheduled task.

See Section 5.4, "Removing Attributes Mapped for Target Resource Reconciliation" for more details.

Resolved Issues in Release 9.0.4.14

The following table lists issues resolved in release 9.0.4.14:

Bug Number Issue Resolution
12977414 No support for expiration dates when modifying a user (TSS ADDTO) This issue has been resolved. All ADDTO attributes, including FIRST, AFTER, and BEFORE, are now supported.

Software Updates in Release 9.0.4.13

The following are the software updates in release 9.0.4.13:

Support for New Oracle Identity Manager Release

From this release onward, the connector can be installed and used on Oracle Identity Manager 11g release 1 (11.1.1). Where applicable, instructions specific to this Oracle Identity Manager release have been added in the guide.

See Section 1.1, "Certified Components" for the full list of certified Oracle Identity Manager releases.

Support for Request-Based Provisioning

From this release onward, the connector provides support for request-based provisioning on Oracle Identity Manager 11g release 1 (11.1.1).

See Section 4.7.2, "Request-Based Provisioning" for more information.

Resolved Issues in Release 9.0.4.13

The following table lists issues resolved in release 9.0.4.13:

Bug Number Issue Resolution
6361887 The Out of Disk Space error was not handled correctly. This issue has been resolved. The Out of Disk Space error is now handled correctly.
9704749 The maclib.xmi file was missing from the Mainframe_TS.zip file on the installation media. This issue has been resolved. The maclib.xmi file is now bundled in the Mainframe_TS.zip file on the installation media.
9735838 During reconciliation, CPU utilization by the LDAP Gateway reached very high levels. This issue has been resolved. CPU utilization by the LDAP Gateway now remains within acceptable levels.

Software Updates in Release 9.0.4.12

The following are software updates in release 9.0.4.12:

  • With the DEBUG log level, the connector can now record log messages that describe issues related to storing of user records in the internal meta-store. See Section 1.3.2, "Connector Operations" for information about the internal meta-store.

  • The connector can recognize and prevent the recording of invalid encrypted messages in the log files.

Software Updates in Release 9.0.4.11

The following are software updates in release 9.0.4.11:

Support for the SOURCE Multivalued Attribute

From this release onward, the connector supports the SOURCE multivalued attribute for reconciliation and provisioning operations. See Section 1.5.6, "SOURCE Attributes for Provisioning" for information about attribute mappings for this multivalued attribute.

Software Updates in Release 9.0.4.7

The following are software updates in release 9.0.4.7:

Software Updates in Release 9.0.4.6

The following are software updates in release 9.0.4.6:

Support for the Suspend Until Function

The connector now supports provisioning operations corresponding to the following target system functions:

  • TSS ADD(acid) ASUSPEND UNTIL(DATE): An administrative user suspends a user either indefinitely (no date is entered) or up to a specified date.

  • TSS REMOVE(acid) ASUSPEND UNTIL(): An administrative user unsuspends a user.

  • TSS ADD(acid) SUSPEND UNTIL(DATE): A user suspends another user either indefinitely (no date is entered) or up to a specified date.

  • TSS REMOVE(acid) SUSPEND UNTIL(): A user unsuspends another user.

Note:

For a Suspend operation, you cannot specify the current date. The date specified must be either the next day or a future date.

Resolved Issues in Release 9.0.4.6

The following are issues resolved in release 9.0.4.6:

Bug Number Issue Resolution
8582428 During provisioning operations, assignment of a group to a user failed. This issue was resolved in release 9.0.4.5. Group assignment to a user does not fail during provisioning operations.
8909417 The connector allows you to create and use multiple resource objects to represent multiple user types in your organization. This is described in the "Configuring Limited Reconciliation" section of the connector guide. In earlier releases, changes to the Enabled/Disabled/Revoked status of users on the target system were not reconciled if you used multiple resource objects. This issue has been resolved. Changes in user status are reconciled into Oracle Identity Manager even when you configure multiple resource objects.

Software Updates in Release 9.0.4.5

The following are issues resolved in release 9.0.4.5:

Bug Number Issue Resolution
8715777 During a reconciliation run, a parsing error was encountered if there was no data between the PROFILES and INSTDATA segments fetched from the target system. This issue has been resolved. Data is always present between the PROFILES and INSTDATA segments during a reconciliation run.

Software Updates in Release 9.0.4.4

The following are software updates in release 9.0.4.4:

Support for Limited Reconciliation from Multiple Resources

If you use multiple resource objects for reconciliation with the target system, then from this release onward you can specify the resource objects with which you want to associate records of specific user types from the target system. See "Configuring Limited Reconciliation" for more information about this feature.

Software Updates in Release 9.0.4.3

The following are issues resolved in release 9.0.4.3:

Bug Number Issue Resolution
7583557 Passwords were specified in unencrypted format in the beans.xml file, which is a configuration file used by the connector. This issue has been resolved. You can now use the propertyEncrypt script to encrypt passwords before you copy them into the beans.xml file.

See "Encrypting Passwords Used in the beans.xml File" for information about the procedure.


Software Updates Up To Release 9.0.4.2

The following are software updates up to release 9.0.4.2:

  • The IBM MQ Series protocol for the message transport layer is no longer supported for this connector. All content related to this protocol has been removed from the guide.

  • CA Top Secret user, group, facility, and data set and resource profile commands supported by the Provisioning Agent have been added in "Functionality Supported by the Pioneer Provisioning Agent" on page 1-6.

  • The list of functions supported by the Provisioning Agent has been updated in "Functionality Supported for Provisioning" on page 1-7.

  • The commands supported by the Reconciliation Agent have been added in "Functionality Supported by the Voyager Reconciliation Agent" on page 1-7.

  • The list of functions supported by the Reconciliation Agent has been updated in "Functionality Supported for Reconciliation" on page 1-7.

  • The list of fields reconciled between Oracle Identity Manager and CA Top Secret has been updated in "Target System Fields Used for Reconciliation and Provisioning" on page 1-8.

  • The IT resource parameters and their corresponding descriptions and sample values have been updated in "Importing the Connector XML File" on page 2-6.

  • The procedure to configure the connector for multiple installations of the target system has been added in "Configuring the Connector for Multiple Installations of the Target System" on page 2-14.

  • Information about reconciliation based on user status has been added in "Configuring Account Status Reconciliation".

  • Steps to add a new field for provisioning have been added in "Adding New Fields for Provisioning" on page 4-5.

  • Known issues related to the following bugs have been added in Chapter 7, "Known Issues and Workarounds":

    • 6668844

    • 6904041

    • 7033009

  • Information about integrating the Reconciliation Agent exit with existing Top Secret exits has been added in "Installing or Integrating the Reconciliation Agent Exit".

Documentation-Specific Updates

The following sections discuss documentation-specific updates:

Documentation-Specific Updates in Release 9.0.4.20

The following documentation-specific updates have been made in revision "23" of release 9.0.4.20:

The following documentation-specific updates have been made in revision "22" of release 9.0.4.20:

The following documentation-specific updates have been made in revision "21" of release 9.0.4.20:

Documentation-Specific Updates in Release 9.0.4.19

The following documentation-specific updates have been made in revision "20" of release 9.0.4.19:

The following documentation-specific updates have been made in revision "19" of release 9.0.4.19:

The following documentation-specific updates have been made in revision "18" of release 9.0.4.19:

Documentation-Specific Updates in Release 9.0.4.18

The following are the documentation-specific updates in this release:

Documentation-Specific Updates in Release 9.0.4.17

There are no documentation-specific updates in this release.

Documentation-Specific Updates in Release 9.0.4.16

There are no documentation-specific updates in this release.

Documentation-Specific Updates in Release 9.0.4.15

The following is the documentation-specific update in this release:

Documentation-Specific Updates in Release 9.0.4.14

The following are the documentation-specific updates in this release.

Documentation-Specific Updates in Release 9.0.4.13

There are no documentation-specific updates in this release.

Documentation-Specific Updates in Release 9.0.4.2 Through 9.0.4.12

The following sections discuss documentation-specific updates have been made in releases 9.0.4.2 to 9.0.4.12: