Integrating with Transient Users with OpenID Connect

OpenID Connect (OIDC) is an identity protocol that enables clients to verify the identity of a user based on the authentication that is performed by an OpenID Connect Provider (OP). An OIDC client is called a Relying Party (RP). With OIDC, a user submits credentials to the OP only. The OP verifies these credentials to authenticate the user. The OP then identifies the user to the RP via secure channels. The following lab explores integrating HCL Digital Experience™ (DX) with two OIDC services, Auth0 and Google.

Architects may find OIDC services attractive options for meeting certain security requirements, like:

• Multi-factor authentication (MFA)
• Password policy enforcement
• Limiting failed login attempts
• Eliminating attack vectors against user credentials
• SSO integration

Relying on OIDC services for secure and well-tested implementations saves time and limits risk for DX developers, versus writing custom code.

HCL DX deprecated its legacy OpenID Authentication implementation in 8.5, due to changes in the interfaces of popular identity providers that rendered the DX trust association interceptor (TAI), com.ibm.portal.auth.OpenIDTAI, obsolete. HCL recommends that DX-based applications use a TAI from IBM WebSphere Application Server (WAS) instead.

To support OpenID Connect, WAS provides a TAI that acts as a Relying Party. To support environments where access to the actual or any mirrored user repository of the OP is restricted, DX provides transient users functionality that treats OIDC-authenticated users as members of All Authenticated Portal Users for access control purposes. Minimal custom code can bridge these components and provide DX-based applications a simple way to integrate with an OIDC OP.

Such simple login modules can be improved to read user attributes and group membership from the OP for use in DX. This enables greater integration for the purposes of access controls, personalization, and PUMA (read).

Note

OIDC authentication can be configured without transient users and corresponding custom JAAS login module, if Digital Experience has access to an actual or mirrored user repository of the OIDC Provider, e.g. LDAP. These labs do not apply exactly to such environments but may be a helpful reference for only specific parts of the configuration.

Refer to HCL DX Transient Users and OIDC Guide.pdf in the attached HCL DX Transient Users and OpenID Connect.zip for instructions on basic DX/OIDC integration. HCLDummyJAASLoginModule.jar includes the sample code referenced in the PDF.

Refer to HCL DX OpenID Connect Improvements.pdf in the attached HCL DX OpenID Connect Improvements.zip for a lab which explores tighter integration of attributes, group membership, and access control. HCLDummyJAASLoginModuleImproved.jar includes sample code for this lab and additional sample code for multiple OP integration.

Refer to HCL DX with Auth0 Social Connections.pdf in the attached HCL DX with Auth0 Social Connections.zip for a lab which explores logging in to Digital Experience with Facebook via a Social Connection from Auth0. HCLDummyJAASAuth0GoogleFacebook.jar includes sample code for this lab which also incorporates previous labs.