IBM® Security Identity Adapter for UNIX and Linux 7.1.41 - Release notes

 

IBM Security Identity Adapter for UNIX and Linux 7.1.41 is available. Compatibility, installation, and other getting-started issues are addressed.

 

Contents

 

Preface

Adapter Features and Purpose

License Agreement

Contents of this Release

Installation and Configuration Notes

Customizing or Extending Adapter Features

Supported Configurations

Notices

 

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 Identity 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 recommends this adapter (and the prerequisite Tivoli Directory Integrator) be installed on each node of an IBM Security Identity Server WebSphere cluster. A single copy of the adapter can handle multiple IBM Security Identity Server services. The deployment configuration is based, in part, on the topology of your network domain, but the primary factor is the planned structure of your IBM Security Identity Server Provisioning Policies and Approval Workflow process. Please refer the IBM Knowledge Centre for a discussion of these topics.

 

IBM Security Identity 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 Identity 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

The ability to manage service groups is a new feature introduced in Tivoli Identity Manager 5.1.  By service groups, IBM Security Identity Server is referring to any logical entity that can group accounts together on the managed resource.

 

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 Identity Adapter license prior to using this product. The license can be viewed from the      

            "license" folder included in the product package.

 

 

Contents of this Release

Adapter Version

Component

Version

Release Date

2017 November 24 04.04.10

Adapter Version

7.1.41

Component Versions

Adapter build: 7.1.41.159

Profile:  7.1.41.159

Connector:  7.1.41.159

Dispatcher:  6.1007 or higher (packaged separately) . Dispatcher version 7.0.33 or higher is required to take advantage of the adapter timeout feature.

Documentation

The following guides are available in the IBM Knowledge Centre

·         UNIX and Linux Adapter Installation and Configuration Guide

·         UNIX and Linux Adapter User Guide

 

New Features

Enhancement # (FITS)

Description

 

Items included in the current 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.2

This adapter is now designed for use with IBM Security Identity 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

For configuration refer to the following section:

Self-password change support for ISPIM

 

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#

PMR# / Description

 

 

Items included in the current 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#

PMR# / 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 ITDI.  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#

PMR# / Description

 

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 Identity 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: 

 

Replace the ‘Configuring self-password change for IBM Security Privileged Identity Manager’ section in Chapter 6 of the ‘IBM Security Identity Adapter for UNIX and Linux Installation Guide’ with the below content.

            Self-password change support for ISPIM

The adapter package contains a new folder called PIM-Specific. This folder contains AIX, Linux and Solaris profile jar files.  These profiles must be installed only on an ISPIM server and support the following limited functionality:

1.     Self-password change

2.     User look up.

The service forms in the ISPIM profile have a new required field Authentication Mode.  Set this field to "admin" if the adapter user is privileged -- root or a sudo user.  Set this field to "self" if the adapter user is not privileged.

During a password change operation, the adapter uses an interactive secure shell (SSH) session.  The adapter waits for default password prompts from the managed resource to complete the transaction.  If the managed resource has customized password prompts, you must specify those prompts on the adapter service form.  The PIM-Specific profiles introduce a new password prompt attribute,erPosixOldRegx that holds the regular expression string for the old password prompt.  The old password prompt is needed for self-password change operations.

The default old password prompt is .*old password:$.  If the managed system's old password prompt differs from this regular expression, customize the prompt on the service form by performing the following steps on the IBM Security Privileged Identity Manager console:

1.     Log on to IBM Security Privileged Identity Manager as an administrator.

2.     In the My Work pane, expand Configure System and click Design Forms to display the Design Forms page.

3.     From the applet, double-click Service to display the service form profiles.

4.     Double-click the service form profile whose service form you want to customize.  Select either Posix AIX Account or Posix Linux Account or Posix Solaris Account.

5.     From the Attributes List window, double-click the erPosixOldRegx attribute to add it to the service form.

6.     Click Save Form Template icon.

Once the form is saved, the Old Password Regular expression field is present on the service form and can be used to customize the prompt.

 

 

Note: For the PIM specific functionality (self-password change and user lookup) to work correctly on Solaris, the PIM user should have appropriate permissions on below listed files:

          /usr/bin/logins file: ‘execute’ permission to others.

 

Note: As ‘Self-password change support for ISPIM’ content is PIM specific, remove this content from adapter installation guide for ISIM and IGI.

 

Installing the adapter language pack
The adapters use a separate language package from the IBM Security Identity Server. See the IBM Security Identity Server Knowledge Center for information about installing the adapter language pack.

IBM Security Identity Server Knowledge Centre

 

 

Configuration Notes

No configuration notes apply to this release.

 

 

 

Customizing or Extending Adapter Features

IBM Security Identity adapters for Unix and Linux can be customized and/or extended. The type and method of this customization may vary from adapter to adapter.

 

Getting Started

Customizing and extending adapters requires a number of additional skills. The developer must be familiar with the following concepts and skills prior to beginning the modifications:

 

·         IBM Security Identity Server administration

·         IBM Tivoli Directory Integrator management

·         IBM Tivoli Directory Integrator Assembly Line development

·         LDAP schema management

·         Working knowledge of Java scripting language

·         Working knowledge of LDAP object classes and attributes

·         Working knowledge of XML document structure

 

Note: If the customization requires a new Tivoli Directory Integrator connector, the developer must also be familiar with Tivoli Directory Integrator connector development and working knowledge of Java programming language.

 

IBM Security Identity Server Resources:

Check the Learn section of the IBM Security Identity Server Support web site for links to training, publications, and demos.

 

Tivoli Directory Integrator Resources:

Check the Learn section of the IBM Tivoli Directory Integrator Support web site for links to training, publications, and demos.

 

IBM Security Identity Adapter for Unix and Linux Development:

Adapter Development Tool 

The Adapter Development Tool, ADT, is a tool used by IBM Security Identity Server customers and consultants to create custom IBM Security Identity adapters for Unix and Linux. It reduces adapter delivery time by about 50% and it helps in the development of custom adapters. The Adapter development tool is available on the IBM Open Process Automation Library (OPAL).

 

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 Identity Adapter for UNIX and Linux was built and tested on the following product versions.

 

Adapter Installation Platform: 

This adapter installs into Tivoli Directory Integrator (TDI) and may be installed on any platform supported by the TDI product and supported by the target system libraries or client, where applicable. IBM recommends installing TDI on each node of the IBM Security Identity Server WAS Cluster and then installing this adapter on each instance of TDI. Supported TDI versions include:

  

Due to continuous Java security updates that may be applied to your ISIM or PIM servers, the following TDI/SDI releases are the officially supported versions:

·         IBM Tivoli Directory Integrator 7.1.1 + .17.1-TIV-TDI-FP0004 + 7.2.0-ISS-SDI-LA0008

·         Security Directory Integrator 7.2 + FP3


Earlier versions of TDI that are still supported may function properly, however to resolve any communication errors, you must upgrade your TDI/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 Tivoli Directory Integrator versions and fix packs

 

Managed Resource:

 AIX

AIX 6.1

AIX 7.1

AIX 7.1 TL 3

AIX 7.2                                                                                                                                                    

 

HP-UX

            HP-UX 11i

            HP-UX 11i v2

            HP-UX 11i v3

           

            Supported operating system modes: non-trusted, trusted non-secure

 

Solaris

Solaris 10

Solaris 11

 

Oracle Linux

Linux 6.3

Linux 6.6

Linux 7

Linux 7.1

Linux 7.2

Linux 7.3

 

Red Hat Linux

 

At the time of the adapter 7.1.41 release, the most recent Red Hat Linux Enterprise Server releases and upgrades were:

 

Red Hat Linux Enterprise Server 5.7

Red Hat Linux Enterprise Server 5.9

Red Hat Linux Enterprise Server 5.10

Red Hat Linux Enterprise Server 6.3

Red Hat Linux Enterprise Server 6.4

Red Hat Linux Enterprise Server 6.5

Red Hat Linux Enterprise Server 7

Red Hat Linux Enterprise Server 7.1

Red Hat Linux Enterprise Server 7.2

Red Hat Linux Enterprise Server 7.3

 

Red Hat Linux Enterprise Server AS 5.7

Red Hat Linux Enterprise Server AS 5.9

Red Hat Linux Enterprise Server AS 5.10

Red Hat Linux Enterprise Server AS 6.3

Red Hat Linux Enterprise Server AS 6.4

Red Hat Linux Enterprise Server AS 6.5 

 

·         Red Hat Enterprise Server supported operating system modes are standard and SE Linux

·         Red Hat Linux Enterprise Server release updates, i.e., 5.x / 6.x, have a limited support life. See the RedHat Enterprise Linux Life Cycle page for more information. At any given time the range of release updates supported by Red Hat is also the range of release updates supported by the adapter. Any exceptions are documented in these release notes.

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

SUSE SLES 11 on zSeries

SUSE SLES 12

SUSE SLES 12.1
SUSE SLES 12.2

 

 

IBM Security Identity Manager:

            IBM Security Identity Manager 7.0

 

 

IBM Security Privileged Identity Manager (ISPIM):

            ISPIM v2.0

            ISPIM v2.1

 

 

Identity Governance and Intelligence (IGI):

            IGI v5.2.1

            IGI v5.2.2

            IGI v5.2.3

 

 

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

 

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

 

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

 

Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

 

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.

 

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

 

COPYRIGHT LICENSE:

 

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

 

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

 

© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights reserved.

 

If you are viewing this information in softcopy form, the photographs and color illustrations might not be displayed.

 

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.

 

Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, other countries, or both.

 

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce.

 

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

 

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

 

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.

 

UNIX is a registered trademark of The Open Group in the United States and other countries.

 

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

 

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

 

Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.

 

 

 

End of Release Notes