Release notes - IBM® Security Verify Governance Adapter 10.0.3 for UNIX and Linux
IBM® Security Verify Governance Adapter 10.0.3 for UNIX and Linux is available. Compatibility, installation, and other getting-started issues are addressed.
Copyright
International Business Machines Corporation 2003, 2022. All rights
reserved.
US
Government Users Restricted Rights -- Use, duplication or disclosure
restricted by GSA ADP
Schedule Contract with IBM Corp.
Table of Contents
Adapter Features and Purpose 2
Installation and Configuration Notes 11
Corrections to Installation Guide 11
Allowed password maximum age limit in Linux and Solaris 12
Installing the adapter language pack 12
Enabling TLSv1.2 in Security Directory Integrator 12
Customizing or Extending Adapter Features 14
These Release Notes contain information for the following products that was not available when the IBM Security Identity Server manuals were printed:
· UNIX and Linux Adapter Installation and Configuration Guide
· UNIX and Linux Adapter User Guide
The IBM Security Verify Governance Adapter for UNIX and Linux is designed to create and manage accounts on AIX, HP-UX, Solaris, RedHat and SUSE Linux systems. The adapter runs in "agentless" mode and communicates using Secure Shell (SSH) to the systems being managed.
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 IBM Security Verify Governance Server will fail if the adapter is not given sufficient authority to perform the requested task. IBM recommends that this adapter run with administrative (root) permissions.
Managing service groups implies the following:
· Create service groups on the managed resource.
· Modify attribute of a service group.
· Delete a service group.
Note: Modify service group name is not supported.
· This adapter supports LDAP as a user registry on AIX only.
· This adapter does not support Network Information Service (NIS).
Review and agree to the terms of the IBM Security Verify Governance Adapter License prior to using this product. The license can be viewed from the "license" folder included in the adapter package.
Component |
Version |
Release Date |
2022 December 22 |
Adapter Version |
10.0.3 |
Component Versions |
Adapter build: 10.0.3.205 Profile: 10.0.3.205 Connector: 10.0.3.205 Dispatcher: Dispatcher 7.1.39 (or higher, packaged separately). |
Documentation |
The following guides are available in the IBM Documentation · UNIX and Linux Adapter Installation and Configuration Guide · UNIX and Linux Adapter User Guide |
Internal # |
Enhancement # (RFE) |
Description |
|
|
Items included in current release (10.0.3) |
RTC 191170 |
ADAPT-115 |
Fix umask recon for secure home directories (sudo) |
|
|
Items included in release (10.0.2) |
RTC 190965 |
ADAPT-I-190 |
Adapter certification on AIX 7.3 |
|
|
Items included in release (10.0.1) |
|
None |
|
|
|
Items included in release (7.1.46) |
RTC 185239 |
|
Certify UnixLinux adapter on RHEL 8, SuSe 15 |
|
|
Items included in release (7.1.45) |
RTC 183245 |
RFE 129090 (57162) |
Unix/Linux Adapter supporting current encryption/hashing for SSH. Note: Use SDI 7.2.0 Fix Pack 6 & TDI 7.1.1 Fix Pack 9 onwards version for the below newly supported algorithms: • rsa-sha2-256, rsa-sha2-512, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 • diffie-hellman-group14-sha256, diffie-hellman-group16-sha512, diffie-hellman-group18-sha512, ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521 • aes192-ctr, aes256-ctr |
RTC 184762 |
RFE 92534 (44991) |
Allowed password maximum age limit in Linux and Solaris. If password maximum age value is greater than LDAP limit value (2147483647), then adapter will set LDAP limit value for password maximum age. See Allowed password maximum age limit in Linux and Solaris section for more information.
|
RTC 184354 |
|
Attribute value lookup support for IGI 5.2.5 |
|
|
Items included in the release (7.1.44) |
RTC 183246 |
|
50336: Don't create private group on user creation although additional attributes cannot be set |
|
|
Items included in the release (7.1.43) |
RTC 177521 |
|
Adapter certification on RHEL7.4 |
RTC 177521 |
|
Adapter certification on RHEL7.5 |
|
|
Items included in the release (7.1.42) |
RTC
174565 |
|
Verify and Certify Suse 12.3 Suse 12. Fixpack 3 is supported or not |
|
|
Items included in the release (7.1.41) |
RTC 168740 |
|
US - As a UnixLinux adapter developer, I must support the new specialFlags attribute in targetProfile.json |
|
|
Items included in the release (7.1.40) |
RTC 165309 |
|
US - As a UnixLinux adapter developer, I must implement support for the latest IGI requirements |
|
|
Items included in the release (7.1.39) |
RTC 158753 |
|
US - As a UnixLinux adapter developer, I should remove the <replaceMultiValue> tag in service.def |
RTC 156577 |
|
Adapter
certification on following new Linux releases SUSE 12.2 |
|
|
Items included in the release (7.1.38) |
RTC 151776 |
|
Add
support for IGI 5.2.x |
PMR 04119,67E,760 Bugz 2174 |
|
Adapter certification on AIX 7.2 |
|
|
Items included in the release (7.0.37) |
40870 (82030) RTC 142443 |
|
Password change automation for PIM Solaris Profile |
|
|
Items included in the release (7.0.36) |
42052 (84783) RTC 142442 |
|
ISIM v6.0 Unix and Linux Adapter support for Oracle Linux 6.6 |
RTC 142444 |
|
Adapter certification on RHEL7.2 |
RTC 142445 |
|
Adapter certification on SuSE12.1 |
|
|
Items included in the release (7.0.35) |
RTC138252 |
|
Adapter certification on Oracle Linux 7.1 |
|
|
Items included in the release (7.0.34) |
76587
(38540) |
|
Support for Dormant accounts on Linux. |
|
|
Items included in the release (7.0.33) |
RTC 127027 |
|
Adapter certification on Oracle Linux 7 |
RTC 124805 |
|
Adapter certification on RHEL7.1 |
RTC 127026 |
|
Adapter certification on SLES 12 |
RTC 127028 |
|
Adapter certification on AIX 7.1 TL3 |
|
|
Items included in the 7.0.32 release |
|
|
Initial release |
Internal# |
APAR# |
Case# / Description |
|
|
Items included in current release (10.0.3) |
|
|
None |
|
|
Items included in release (10.0.2) |
RTC 187875 Bug 3315 |
IJ27274 |
"root all=(all:all) all" syntax in sudoers file causes recons to fail
It will fail for only 'root ALL=(ALL:ALL) ALL' As an alternate use 'root ALL=(ALL) ALL'
|
|
|
Items included in current release (10.0.1) |
|
|
None |
|
|
Items included in release (7.1.46) |
|
|
None |
|
|
Items included in release (7.1.45) |
RTC 184353 Bug 2951 |
Case TS002309060 |
Allow $ in password $ was prohibited in earlier release but since its common character used in password, its being allowed again from this release onwards. However, there are still some limitations, so we must ensure that $() and ${} is not allowed. To use $ in password Select Allow $ in password checkbox in service form. See Allow $ in password section for more information.
|
|
|
Items included in release (7.1.44) |
RTC 183393 Bug 2874 |
PMR TS002079080 |
UnixLinux - change the special flags for erPosixPrimaryGroup’s to none |
|
|
Items included in the release (7.1.43) |
RTC 177762 Bug 2644 |
IJ07579 |
Groups not returned during reconciliation, $ is escaped in sed command, sed -e 's/\$ |
|
|
Items included in the release (7.1.42) |
|
|
None |
|
|
Items included in the release (7.1.41) |
RTC 166794 |
|
US - As a Unix Linux adapter developer, I must ensure that '$' characters in attribute names are not subject to macro expansion |
|
|
Items included in the release (7.1.40) |
RTC 161484 |
|
PEN TEST - User account creation allows a rogue Linux start process command to be appended
|
RTC 161485 |
|
PEN TEST - Group creation allows a rogue Linux start process command to be appended
|
RTC 161486 |
|
PEN TEST - Identity Service Center allows directory creation under /root
|
|
|
Items included in the release (7.1.39) |
|
|
None. |
|
|
Items included in the release (7.0.38) |
|
|
None. |
|
|
Items included in the release (7.0.37) |
|
|
None. |
|
|
Items included in the release (7.0.36) |
Bugz2033 RTC142016 |
IV83309 |
Linux recon scripts do not handle usernames with period in them. |
|
|
Items included in the release (7.0.35) |
Bug
1964 |
|
Adding
user to an AIX target with ISIM UnixLinux adapter fails.
|
|
|
Items included in the release (7.0.34) |
RTC129909 |
IV76420 |
No need to add an user to "Security" group for creating as super user on AIX. |
|
|
Items included in the 7.0.33 release |
Bugz1757 RTC124805 |
|
UnixLinux connector claims RHEL 7 is not supported |
Items included in the 7.0.32 release |
||
|
|
Initial release |
Internal# |
APAR# |
Case# / Description |
Bug 2404 RTC 165305 |
|
PIM 2.1 Adapter not working for key based
SDI 7.2 must have following FP level installed for key based authentication to work correctly with the adapter –
Security Directory Integrator 7.2+ FP3 |
Bugz 2059, RTC 145019 |
PMR 44212,082,000 |
diffie-hellman-group-exchange-sha256 SSH key exchange algorithm does not work
Successful connection between the UNIX and Linux Adapter and a managed resource depends, in part, on the SSH key exchange algorithms configured on each of the systems. The underlying Remote Execution and Access (RXA) libraries used by the adapter define which SSH algorithms are supported. The RXA libraries are packaged with SDI. To get diffie-hellman-group-exchange-sha256 support, you must use ITDI 7.1.1 LA 0030 or later. |
|
|
Adding audit class value on AIX
During user add and user modify, if audit class attribute contains a valid value but some other attribute fails, then adapter returns failure instead of warning.
|
|
|
Deleting audit class value on AIX
Adapter returns success for deleting audit class value on AIX, but the changes do not reflect on resource. |
|
|
User add request with primary group value on Aix
Adapter returns failure status for useradd request if primary group contains value which does not exist on resource. |
|
|
Changing primary group values on AIX
When primary group and secondary groups values are updated in the same useradd or usermod request, the primary group value is added to the secondary groups list without removing the previous primary group name from the list. Example: Assume that a user is added with two attributes Primary group = gr01, Secondary Groups = gr02,gr03 Then the user is modified for the two attributes Primary group = grp1, Secondary Groups = grp2,grp3 Result: The new secondary group values are: grp1,grp2,grp3,gr01.
|
|
|
Password change with using LDAP registry on AIX
Configuring multiple AIX services to use the same LDAP may cause errors. If LDAP is configured to use password history checking, and IBM Security Identity Server is configured for password synchronization, any passwords changes initiated from the IBM Security Identity Server effectively cause IBM Security Identity Server to send the same password to each AIX service. The result is a history violation.
|
|
|
pwdadm process might be left running on AIX after root password change
If a failure occurs when changing root's password on AIX 7.1, the pwdadm command can consume a large number of CPU cycles. This can be resolved by installing AIX 7.1 TL3 or higher, which includes APAR IV63940. |
Internal# |
APAR# |
Case# / Description |
RTC 177762 Bug 2644 |
IJ07579 |
Groups not returned during reconciliation, $ is escaped in sed command, sed -e 's/\$
From this release (7.1.43), adapter does not support $ character in input values to avoid macro expansion or unwanted command execution.
Note: From release (7.1.45), adapter allows $ in password. $ was prohibited in earlier release but since its common character used in password, its being allowed again from this release onwards. However, there are still some limitations, so we must ensure that $() and ${} is not allowed. To use $ in password Select Allow $ in password checkbox in service form. (Ref. RTC 184353, Bug 2951, Case TS002309060)
|
Bug 2577 |
|
UNIX/Linux Adapter fails to create role on AIX 7.1 when authorization does not exist
On Aix 7.1, for creating a new role through adapter, make sure the authorization exists on Aix resource.
|
|
Bugz1098 IV50269 RTC96617 |
erPosixForcePwdChange request not working when set to 0
On Linux, Solaris and HPUX, the 'force password change' feature cannot be toggled. You can only set the 'force password change' option to true. The OS does not support resetting it back to false. On AIX, the 'force password change' feature can be toggled between true and false.
|
|
Supported shells
Only shells that support setting environment variables via "envvar = xxx; export envvar;" are supported for the service admin user. csh and tcsh in particular do not work (others might not work as well). The sh and bash shell works for the admin user. Note that on many systems, sh is a symlink to another shell. |
|
|
|
|
See the IBM Security Verify Governance Adapter for UNIX and Linux Installation Guide for detailed instructions.
The following corrections to the Installation Guide apply to this release:
· Add below note to Install guide at this location – Installing è Service/Target form details è On the Authentication tab
Select this check box to use $ in a password.
· Add below note to Install guide for erPosixMaxPwdAge attribute at this location – Reference Adapter attributes and object classes
If password maximum age value is greater than LDAP limit value, then adapter will set LDAP limit value for password maximum age.
The
adapters use a separate language package from the IBM Security
Identity Server. See the IBM Security Governance Adapters
Documentation Center
for information about installing the adapter language pack.
IBM Security Verify Governance Adapter Documentation
About this task
Procedure
Apply recommended fix packs and limited availability (LA) versions on the Security Directory Integrator. See Recommended fixes for IBM Tivoli Directory Integrator (TDI) & IBM Security Directory Integrator (SDI).
After applying the appropriate updates, modify the <SOLUTION_DIRECTORY>/solution.properties file by appending the following text to the bottom of the file:
##
# # Protocols to enforce SSL protocols in a SDI Server
# # Optional values for com.ibm.di.SSL* property (TLSv1, TLSv1.1, TLSv1.2). # # This can be a multi-valued comma separated property
# # Optional values for com.ibm.jsse2.overrideDefaultProtocol property (SSL_TLSv2, TLSv1,TLSv11,TLSv12).
# # This is a single value property.
##
-
com.ibm.di.SSLProtocols=TLSv1,TLSv1.1,TLSv1.2
com.ibm.di.SSLServerProtocols=TLSv1,TLSv1.1,TLSv1.2
com.ibm.jsse2.overrideDefaultProtocol=TLSv1
com.ibm.jsse2.overrideDefaultTLS=true
Please add new section “Installing ILMT-Tags File “under the section Installing in adapter install guide. Under Installing ILMT-Tags specify below steps.
Before
you begin:
The
Dispatcher must be installed
Procedure:
Copy the files from ILMT-Tags folder to the specified location:
1. Windows: <SDI-HOME>/swidtag
2. Unix/Linux: <SDI-HOME>/swidtag
Remove paragraph "Home directory permissions"
IBM Security Verify Governance Adapters for Unix and Linux 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
The integration to the Identity 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 PMR is opened.
The IBM Security Verify Governance Adapter for UNIX and Linux was built and tested on the following product versions.
Adapter Installation Platform:
This adapter installs into Security Directory Integrator (SDI) and may be installed on any platform supported by the SDI product and supported by the target system libraries or client, where applicable. IBM recommends installing SDI on each node of the IBM Security Identity Server WAS Cluster and then installing this adapter on each instance of SDI. Supported SDI versions include:
Due to continuous Java security updates that may be applied to your ISIM or PIM servers, the following SDI releases are the officially supported versions:
· Security Directory Integrator 7.2 + 7.2.0-ISS-SDI-FP0008 + 7.2.0-ISS-SDI-LA0019
Note:
Earlier
SDI supported versions may function properly, however to resolve any
communication errors, you must upgrade your SDI releases to the
officially supported versions.
Managed Resource:
AIX
AIX 7.1 TL 5
AIX 7.2 TL 4 or later
AIX 7.3
HP-UX
HP-UX 11i v3
Supported operating system modes: non-trusted, trusted non-secure
Solaris
Solaris 11
Oracle Linux
Linux 7
Linux 8
Linux 9
Red Hat Linux
At the time of the adapter 10.0.2 release, the most recent Red Hat Linux Enterprise Server releases and upgrades were:
Red Hat Linux Enterprise Server 8.4
· Red Hat Enterprise Server supported operating system modes are standard and SE Linux
· Red Hat Linux Enterprise Server release updates may introduce changes and/or features that are not supported by the adapter. In such a case, support for the changes or features will be added in a future release of the adapter.
SUSE Enterprise Linux Server
SUSE SLES 12.5
SUSE SLES 15 SP3
z System and LinuxONE
Red Hat Linux Enterprise Server 8.3
Ubuntu 20.04
SUSE SLES 15
Supported IBM Security Verify servers
· IBM Security Verify Governance Identity Manager v10.0
· IBM Security Verify Governance v10.0
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.
End of Release Notes