IBM Security Verify Governance Adapter for IBM Security Verify Governance Admin Realm 10.0.2 is available. Compatibility, installation, and other getting-started issues are addressed.
Copyright International Business Machines Corporation 2024. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Welcome to the IBM Security Verify Governance Adapter for IBM Security Verify Governance Admin Realm. These Release Notes contain information for the following products that was not available when the IBM Security Verify Governance Adapter for IBM Security Verify Governance Admin Realm manuals were printed:
· IBM Security Verify Governance Adapter for IBM Security Verify Governance Admin Realm Adapter Installation and Configuration Guide
The IBM Security Verify Governance Admin Realm Adapter is designed to create and manage User Accounts on the IBM Security Verify Governance Admin Realm platform. The adapter runs in "agentless" mode and communicates using REST API to the systems being managed.
The IBM Security Verify Governance Adapters are powerful tools that require Administrator Level authority. Adapters operate much like a human system administrator, creating accounts, permissions and home directories. Operations requested from the IBM Security Verify - Governance server will fail if the Adapter is not given sufficient authority to perform the requested task.
License Agreement
Review and agree to the terms of the IBM Security Verify Governance License prior to using this product. The license can be viewed from the "license" folder included in the product package.
Adapter Version
Version |
|
Build Date |
2024 January 17 06.46.22 |
Adapter Version |
10.0.2 |
Component Versions |
Adapter build: 10.0.2.44 Profile: 10.0.2.44 Connector: 10.0.2.44 Dispatcher 7.1.39 or higher (packaged separately) |
Documentation |
The following guides are available in the IBM Verify Adapters Knowledge Center
IBM Security Verify Governance Admin Realm Installation and Configuration Guide |
New Features
Internal# |
Enhancement # (RFE / IDEA) |
Description |
|
|
Items included in release version 10.0.2 |
|
|
None |
|
|
Items included in release version 10.0.1 |
|
|
Initial Release |
Closed Issues
Internal# |
Known Issue# / Case# |
Description |
|
|
Items closed in release version 10.0.2 |
SVGAD - 877 |
DT243395 / TS013668645 |
- Question about account add for SVG admin realm
adapter. |
SVGAD - 1334 |
|
Internal defect resolved: Errors while modifying User account. |
SVGAD - 987 |
|
Added definition of attributes (erisvgadmrealmurl,erisvgadmrealmapikey,erisvgadmrealmapiuser,erisvgadmrealmalfilesystempath,erisvgadmrealmdisablealcache,erisvgadmrealmmaxconnectioncnt) in schema file of ISVG-Admin-Realm Adapter to resolve the error: CTGIMU716E The erISVGAdmRealmAccount schema class is not in the directory. |
|
|
Items closed in release version 10.0.1 |
|
|
Initial Release |
Known Limitations
Internal# |
APAR# / PMR# |
Description |
|
|
|
See the IBM Security Verify Governance Admin Realm Adapter Installation and Configuration Guide for detailed instructions.
The Adapter Installation and Configuration Guide can be obtained from the IBM Knowledge Center
Chapter 1: Overview
No updates for the current release
Chapter 2: Planning
-> Prerequisites
Directory
Integrator:
Update
the description as below:
IBM
Security Directory Integrator, consult the release notes for the currently
supported versions
Chapter 3: Installing
-> Installing in the Verify Governance
Virtual Appliance
( Please add this new section at knowledge centre guide of ISVG
(under Installing > Installing in the Verify Governance Virtual Appliance) for
ISVG Admin Realm Adapter to describe
installation procedure of adapter in Verify Governance Virtual Appliance: https://www.ibm.com/docs/en/svgaa?topic=ldap-installing-in-virtual-appliance.
Please add this below note as well after adding the description.)
Note: While uploading the Adapter package, you may
receive System Error: A file included in the SDI Adapter zip already exists on the
system and the Server Message log under Appliance tab of VA will have a
reference to error com.ibm.identity.sdi.SDIManagementService E File ibm.com_IBM_Security_Verify_Governance_xxxx.swidtag
found in the adapter zip at location ILMT-Tags/ already exists in system. This is because, you can install the same swidtags only once. So, if another adapter of the same type
is installed, remove the swidtags.
The ibm.com_IBM_Security_Verify_Governance_Enterprise-xxxx.swidtag file is common to all adapters. In addition to the
common swidtag file, an application adapter needs ibm.com_IBM_Security_Verify_Governance_Application_Adapters-xxxx.swidtag file and an infra adapter needs ibm.com_IBM_Security_Verify_Governance_Lifecycle-xxxx.swidtag and ibm.com_IBM_Security_Verify_Governance_Compliance-xxxx.swidtag files. So, if an application adapter is already
installed and this is an infra adapter, then only install the infra-specific swidtags and the other way around. Please visit IBM Security Verify Governance
Adapters v10.x link to identify the adapter type of the installed
adapters.
Chapter 4: Upgrading
->
Upgrading the adapter binaries or connector
(Please Add
Upgrading the adapter binaries or connector section at Upgrading >
Upgrading the adapter binaries or connector)
- Take backup of adapter binaries or connector
Procedure:
Take backup of below files before performing upgrade:
<SDI-HOME>/jars/connectors/ ISVGAdmRealmConnector.jar
Note: Stop the dispatcher service before the upgrading the connector and start it again after the upgrade is complete.
- Upgrade adapter binaries or connector Procedure:
Copy
ISVGAdmRealmConnector.jar from the adapter package to the
<SDI-HOME>/jars/connectors directory
- Upgrading the adapter profile
Read the adapter Release Notes for any specific instructions before you import a new adapter profile.
There is ISVGAdmRealmConnector.jar included in the IBM Security Verify Governance Admin Realm Adapter distribution package.
Note: Restart the Dispatcher service after importing the profile. Restarting the Dispatcher clears the assembly lines cache and ensures that the dispatcher runs the assembly lines from the updated adapter profile.
Chapter 5: Configuring
No updates for the current release
Chapter 6: Troubleshooting
No updates for the current release
Chapter 7: Uninstalling
No updates for the current release
Chapter 8: Reference
No updates for the current release
Configuration Notes
The following configuration notes apply to this release:
None.
The IBM Security Verify Governance Manager adapters can be customized and/or extended. The type and method of this customization may vary from adapter to adapter.
Refer to the ‘IBM Security Verify Governance Adapter Development and Customization Guide’
Support for Customized Adapters
The integration to the IBM Security Verify Manager server "the adapter framework" is supported. However, IBM does not support the customizations, scripts, or other modifications. If you experience a problem with a customized adapter, IBM Support may require the problem to be demonstrated on the GA version of the adapter before a Case is opened.
Installation Platform
The IBM Security Verify Governance Adapter for IBM Security Verify Governance Admin Realm Adapter was built and tested on the following product versions.
Adapter Installation Platform
Due to continuous Java security updates that may be applied to your IBM Security Verify server, IBM Security Verify Privilege Vault and IBM Security Verify- Governance server, the following SDI releases are the officially supported versions:
· Security Directory Integrator 7.2 + FP11
Earlier versions of SDI that are still supported may function properly, however to resolve any communication errors, you must upgrade your SDI releases to the officially supported versions by the adapters. Please refer to the adapters installation and configuration guides for the latest update on IBM Security Directory Integrator versions and fix packs
Managed Resource
IBM Security Verify Governance v10.0
Supported IBM Security Verify servers
IBM Security Verify Governance v10.0
3rd Party Client Libraries:
commons-logging-1.2.jar
Download the commons-logging-1.2.jar from https://mvnrepository.com/artifact/commons-logging/commons-logging/1.2
httpclient-4.5.13.jar
Download the httpclient-4.5.13.jar from https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient/4.5.13
httpcore-4.4.4.jar
Download the httpcore-4.4.4.jar from https://mvnrepository.com/artifact/org.apache.httpcomponents/httpcore/4.4.4
json-simple-1.1.1.jar
Download the json-simple-1.1.1.jar from https://mvnrepository.com/artifact/com.googlecode.json-simple/json-simple/1.1.1
commons-codec-1.16.0.jar
Download the commons-codec-1.16.0.jar from https://mvnrepository.com/artifact/commons-codec/commons-codec/1.16.0
JSON4J.jar
Download the JSON4J.jar from https://mvnrepository.com/artifact/org.apache.wink/wink-json4j/1.4
This
information was developed for products and services offered in the U.S.A. IBM
may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that
IBM product, program, or service may be used. Any functionally equivalent
product, program, or service that does not infringe any IBM intellectual
property right may be used instead. However, it is the user's responsibility to
evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan
This information could
include technical inaccuracies or typographical errors. Changes are
periodically made to the information herein; these changes will be incorporated
in new editions of the publication. IBM may make improvements and/or changes in
the product(s) and/or the program(s) described in this publication at any time
without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this
IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged should contact:
IBM Corporation
2ZA4/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Such
information may be available, subject to appropriate terms and conditions, including
in some cases, payment of a fee.
The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments
may vary significantly. Some measurements may have been made on
development-level systems and there is no guarantee that these measurements
will be the same on generally available systems. Furthermore, some measurements
may have been estimated through extrapolation. Actual results may vary. Users
of this document should verify the applicable data for their specific
environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available
sources. IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
Trademarks
IBM,
the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions
worldwide. Other product and service names might be trademarks of IBM or other
companies. A current list of IBM trademarks is available on the Web at "Copyright
and trademark information" at www.ibm.com/legal/copytrade.shtml.
Microsoft, Windows, and the Windows logo are trademarks of Microsoft
Corporation in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Oracle and/or its affiliates.