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.

 

Contents

 



Table of Contents

Contents 1

Preface 2

Adapter Features and Purpose 2

Service Groups Management  2

Directory Service Support 3

License Agreement 3

Contents of this Release 3

Adapter Version 3

New Features 3

Closed Issues 6

Known Issues 9

Known Limitations 10

Installation and Configuration Notes 11

Corrections to Installation Guide 11

Configuration Notes 12

Allow $ in password 12

Allowed password maximum age limit in Linux and Solaris 12

Installing the adapter language pack 12

Enabling TLSv1.2 in Security Directory Integrator 12

Installing ILMT-Tags File 13

Troubleshooting 13

Know Adapter Issues 13

Customizing or Extending Adapter Features 14

Support for Customized Adapters 14

Supported Configurations 14

Notices 16



 

Preface

 

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

 

 

Adapter Features and Purpose

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.

 

Service Groups Management 

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.

 

Directory Service Support

·         This adapter supports LDAP as a user registry on AIX only.

·         This adapter does not support Network Information Service (NIS).

 

 

License Agreement

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.

Contents of this Release

Adapter Version

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



New Features

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
Bug 2591

 

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
RHEL 7.3
Oracle Linux 7.3
Oracle Linux 7.2

SUSE 12.2

 

 

Items included in the release (7.1.38)

RTC 151776

 

Add support for IGI 5.2.x

This adapter is now designed for use with IBM Security Verify Manager, Privileged Identity Manager, and Identity Governance and Intelligence.

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)
RTC 131797

 

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

 

Closed Issues

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
RTC136970
RTC105577

 

Adding user to an AIX target with ISIM UnixLinux adapter fails.
-Handled the NPE during user creation if the registry and/or primary group was null or invalid.

 

 

 

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

 

 

Known Issues

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.

 

Known Limitations

 

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.

 

 

 

 

Installation and Configuration Notes

See the IBM Security Verify Governance Adapter for UNIX and Linux Installation Guide for detailed instructions.

 

Corrections to Installation Guide

The following corrections to the Installation Guide apply to this release: 

Configuration Notes

Allow $ in password

·         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.

Allowed password maximum age limit in Linux and Solaris

·         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.

 

Installing the adapter language pack


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



Enabling TLSv1.2 in Security Directory Integrator



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







Installing ILMT-Tags File

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

 

 



Troubleshooting

Know Adapter Issues

Remove paragraph "Home directory permissions"

Customizing or Extending Adapter Features

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 

Support for Customized Adapters

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.

 

 

Supported Configurations

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

 

Notices

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