Skip to main content

Protecting Web Applications with IBM Security Verify

Overview

IBM Security Verify (formerly IBM Cloud Identity) helps you secure user productivity with cloud-delivered Single Sign-On (SSO), multifactor authentication, and identity governance. It can be configured to act as an identity provider for the IBM Application Gateway (IAG) by acting as an OpenID Connect Provider (OP).

OpenID Connect is a simple identity protocol and open standard that is built using the OAuth 2.0 protocol. It enables client applications to rely on authentication that is performed by an OpenID Connect Provider (OP) to verify the identity of a user. OpenID Connect uses OAuth 2.0 for authentication and authorization, and then builds identities that uniquely identify users.

The IAG provides a native OpenID Connect relying partner (RP) capability that is able to consume an identity token which has been provided by the IBM Security Verify OP in order to establish an authenticated session.

Authentication Flows

The OIDC specification states that authentication can follow one of three paths: the Authorization Code Flow, the Implicit Flow, or the Hybrid Flow. The flow determines how the ID Token and Access Token are returned to the Client. The Authorization Code Flow and the Implicit Flow are described below (please note that the IAG does not support the Hybrid Flow).

The Authorization Code flow is the default and recommended flow for the IAG, but it does require direct connectivity from the IAG container to the IBM Security Verify OP. If direct connectivity is not possible the Implicit Flow may be used - although this flow is not recommended and is now considered a security best practices anti-pattern. There are two subtle variations to the Implicit flow, differentiated by the originator of the self-posting form (this form is used to POST the authentication tokens to the RP):

  1. The 'fragment' sub-flow uses a self-posting form which is served from the IAG container;
  2. The 'form-post' sub-flow uses a self-posting form which is returned from the IBM Security Verify OP as a result of the authentication process.

Authorization Code Flow

Authorization Code Flow

Implicit Flow (fragment)

Implicit Flow (fragment)

Implicit Flow (form-post)

Implicit Flow (form-post)

Configuration

IBM Security Verify

To configure the OIDC flow between IBM Security Verify and IAG you have to first create a IBM Security Verify application, using the 'IBM Application Gateway' template, to represent the IAG application.

IBM Security Verify Application

Information on how to create an application can be found in the IBM Security Verify documentation: https://www.ibm.com/support/knowledgecenter/en/SSCT62/com.ibm.iamservice.doc/tasks/tapplications.html#tapplications_createapp.

The application configuration screen will have some of the application fields pre-configured for IAG. At a minimum the following sign-on fields will need to be provided:

  1. Application URL;
  2. Redirect URIs.

IBM Security Verify Admin Console

In order to configure the IAG to act as an RP the following IBM Security Verify information will be required:

  1. Security Verify endpoint;
  2. Client ID;
  3. Client Secret.

IAG Container

The following initial tasks should be completed in order to protect a Web application using IBM Security Verify:

Task Reference Page
Complete the first steps to understand how to access the IAG image and run a container. First Steps
Create a server certificate for the IAG container. Managing Certificates
Configure the container so that it is able to consume tokens from the IBM Security Verify OP. Configuring as an OIDC Relying Party for IBM Security Verify
Define the location of the applications which are to be protected. Protecting an Application
Define the rules which control access to the application resources. Defining the Authorization Policy

An example configuration yaml file which illustrates this scenario is available at: ../examples/authorization.