Access Manager Appliance 4.5 Service Pack 2 Release Notes

April 2020

Access Manager Appliance 4.5 Service Pack 2 (4.5.2) includes enhancements, improves usability, and resolves several previous issues.

Many of these improvements are made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure our products meet all your needs. You can post feedback in the Access Manager forum on our community website that also includes product notifications, blogs, and product user groups.

For information about the previous release, see Access Manager Appliance 4.5 Service Pack 1 Hotfix 1 Release Notes.

For more information about this release and for the latest release notes, see the Documentation page. To download this product, see the Product page.

If you have suggestions for documentation improvements, click comment on this topic at the bottom of the specific page in the HTML version of the documentation posted at the Documentation page.

For information about Access Manager support lifecycle, see the Product Support Lifecycle page.

1.0 What’s New?

This release provides the following enhancements and fixes:

1.1 Enhancements

This release includes the following enhancements:

Support for Mapping SaaS Applications Authorizations to LDAP Groups in Access Manager User Stores

Access Manager now provides the LDAP Groups and Authorizations page when configuring a SAML2/Account Management application. Using this page, you can map authorizations returned by a SaaS application (for example, O365), such as licenses, service plans, roles, and groups to the local LDAP groups in the Access Manager user stores.

To use this feature, you must have SaaS Account Management (SAM) registered with Access Manager. While provisioning qualified users from the LDAP user stores to a SaaS application, SAM creates these users with the authorizations as mapped in the LDAP Groups and Authorizations page.

For more information about SAML2/Account Management applications, see SAML/Account Management Connectors in the Access Manager Appliance 4.5 Applications Configuration Guide.

Support for the Advanced Authentication Multi-Tenancy Feature

Access Manager now supports the multi-tenancy feature of Advanced Authentication. Instead of using only the default tenant (TOP), you can now use any tenant configured in the Advanced Authentication server. For more information about the new multi-tenancy option, see Configuring Advanced Authentication Server in the NetIQ Access Manager Appliance 4.5 Administration Guide.

Support for Delaying the Initial Token Revocation Check of Client Applications

Access Manager introduces a new UI option, Perform Revocation Check After. When you use a user store as an LDAP load balancer, which has a read-only and write-only replica, token verification can fail if there is any delay in the data synchronization of the user store LDAP replicas. Using this new option, you can delay the initial token revocation check. For more information about the new option, see Configuring OAuth and OpenID Connect in the NetIQ Access Manager Appliance 4.5 Administration Guide.

Support for Choosing the Format of Audit Events

Access Manager now offers an option to choose the format you want to send the audit events. You can send these events to multiple audit servers in either CSV or JSON format. For more information about the new option, see Setting Up Logging Server and Console Events in the NetIQ Access Manager Appliance 4.5 Administration Guide.

Support for the c3p0 Connection Pool Libraries

Access Manager now allows configuration of the c3p0 connection pool libraries to enhance performance and scalability. For more information about c3p0 connection pool libraries and how to configure it, see Enabling c3p0 Connection Pooling for Database in the NetIQ Access Manager Appliance 4.5 Administration Guide.

1.2 Updates for Dependent Component

This release adds support for Tomcat 8.5.51 (CVE-2020-1938).

Upgrading to this version adds a secret required attribute to the Apache JServ Protocol (AJP) Connector. You might need to specify this attribute in server.xml file. For more information, see Changes Required in server.xml for Apache Tomcat 8.5.51 after Upgrading to Access Manager 4.5 Service Pack 2 in the NetIQ Access Manager Appliance 4.5 Installation and Upgrade Guide.

1.3 Software Fixes

This release includes the following software fixes:

Component

Bug ID

Issue

Administration Console

1089317

Any change made in the auditing page updates the server IP address and port in both auditlogging.cfg and nam.conf files instead of logging the information only in the nam.conf file.

OAuth 2.0

1148869

Changed the format of the acr claim value of the ID Token from array to string, as per the OpenID Connect Core 1.0 specification.

OAuth 2.0

1129521

Accessing a resource protected using OAuth gives an error because Active Directory Lightweight Directory Services does not have the userAccountControl attribute.

OAuth 2.0

1165233

The n (Modulus) parameter of the RSA public key contains an extra zero-valued octet in the JSON Web Key Set. The cryptographic library prefixes this additional octet.

SAML 2.0

1155505

Desktop email client configuration with POP3, IMAP, MAPI, and ActiveSync fails if the Office 365 SAML service provider is configured with the default metadata.

Advanced Authentication Integration

1155906

While using the Advanced Authentication Generic class, users gain access to a protected resource without performing the second-factor authentication.

Identity Server

1137700

Authentication takes longer if you enable the device fingerprinting feature. The row-lock of the database hangs when Identity Server is under load, causing this issue.

User Stores

1134145

Social Authentication fails when write and read attributes of LDAP requests go to a different user store replica.

2.0 Installing or Upgrading

After purchasing Access Manager Appliance 4.5.2, you can access the product in the Customer Center. The activation code is in the Customer Center where you download the software. For more information, see Customer Center Frequently Asked Questions.

To access a full version of Access Manager:

  1. Log in to the Customer Center.

  2. Click Software.

  3. On the Entitled Software tab, click the appropriate version of Access Manager Appliance for your environment to download the product.

The following files are available:

Table 1 Files Available for Access Manager Appliance 4.5.2

Filename

Description

AM_452_AccessManagerAppliance.iso

Contains Access Manager Appliance .iso file.

AM_452_AccessManagerAppliance.tar.gz

Contains Access Manager Appliance .tar file.

NOTE:This release does not support installation or upgrade of Analytics Server. For a fresh installation of Analytics Server, use AM_442_AnalyticsServerAppliance.iso file, then upgrade Analytics Server to 4.4 SP3 version by using AM_443_AnalyticsServerAppliance.tar.gz file. If you are already using a previous version of Analytics Server, then upgrade to Analytics Server 4.4 SP3. For more information about installing Analytics Server, see Installing Analytics Server in the NetIQ Access Manager Appliance 4.5 Installation and Upgrade Guide.

For information about the upgrade paths, see Supported Upgrade Paths. For more information about installing and upgrading, see the NetIQ Access Manager Appliance 4.5 Installation and Upgrade Guide.

3.0 Verifying Version Number after Upgrading to 4.5.2

After upgrading to Access Manager Appliance 4.5.2, verify that the version number of the component is indicated as 4.5.2.0-125. To verify the version number, perform the following steps:

  1. In Administration Console Dashboard, click Troubleshooting > Version.

  2. Verify that the Version field lists 4.5.2.0-125.

4.0 Supported Upgrade Paths

To upgrade to Access Manager Appliance 4.5.2, you need to be on one of the following versions of Access Manager:

  • 4.4 Service Pack 4

  • 4.4 Service Pack 4 Hotfix 1

  • 4.4 Service Pack 4 Hotfix 2

  • 4.5

  • 4.5 Hotfix 1

  • 4.5 Service Pack 1

  • 4.5 Service Pack 1 Hotfix 1

IMPORTANT:If you are using SQL database with the existing Risk-Based Authentication (RBA) data and you are upgrading to Access Manager 4.5.2, you must run a utility to de-normalize the database. This is to ensure that your existing RBA data does not become irrelevant. For more information about this utility and how to run it, see Denormalizing SQL Database in the NetIQ Access Manager Appliance 4.5 Installation and Upgrade Guide.

For more information about upgrading Access Manager Appliance, see Upgrading Access Manager Appliance in the NetIQ Access Manager Appliance 4.5 Installation and Upgrade Guide.

5.0 Known Issues

NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. There are no new issues other than the issues mentioned in Access Manager Appliance 4.5 Service Pack 1 Hotfix 1 Release Notes. If you need further assistance with any issue, please contact Technical Support.

6.0 Contact Information

Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please email Documentation-Feedback@netiq.com. We value your input and look forward to hearing from you.

For detailed contact information, see the Support Contact Information website.

For general corporate and product information, see the NetIQ Corporate website.

For interactive conversations with your peers and NetIQ experts, become an active member of our community. The NetIQ online community provides product information, useful links to helpful resources, blogs, and social media channels.

7.0 Legal Notice

For information about legal notices, trademarks, disclaimers, warranties, export and other use restrictions, U.S. Government rights, patent policy, and FIPS compliance, see https://www.netiq.com/company/legal/.

Copyright © 2020 NetIQ Corporation. All Rights Reserved.