JOSSO.orgCommunity Documentation

Chapter 12. Execution Environment Activation

12.1. Bringing SSO-Readiness to Execution Environments

As explained in Section 3.2.5.3, “Activation”, the activation feature allows you to provision Single Sign-On (SSO) support onto the execution environment (such as an application server or web container) where the application is hosted.

The activation procedure involves the installation of JOSSO-specific artifacts, such as the corresponding JOSSO agent and configuration descriptors; as well as the wiring that makes it possible for the execution environment to interoperate with JOSSO2 in a seamless and transparent manner.

Once an execution environment is activated, the applications executing within it will be able to harness the SSO capabilities that are provided by the target identity appliance.

In order to specify an activation procedure, there must be at least one Service Provider and one execution environment element, since specifying an activation relationship involves the connection of such elements.

To connect SP and execution environment elements and create an activation relationship, use the "Activation" edge available in the "Connections" palette drawer.

Click on the "Activation" element. Select the SP and drag the edge onto the target execution environment.

The following dialog will appear for defining the characteristics of the activation connection between the chosen entities.

On the Create JOSSO Activation screen, specify the endpoints used by the application to service requests from the target execution environment.

Field Descriptions

Field

Description

Name

The unique identifier of the Activation connection.

Description

A descriptive text for the Activation connection.

Partner Application Identifier

The Service Provider-facing unique identifier of the partner application.

By default, the name of the source SP element is used.

Partner Application Location

Specify the protocol, host, port and URI to which your partner application is bound for servicing requests from end-users.

In order to enable the SSO capabilities in your application, user requests should refer to the web application using URLs that match the values specified in this field.

If your SP is the example JOSSO application, make sure to specify "partnerapp" in the URI field.

Once the activation properties have been specified, the actual activation process may be run.

Select the SP element, and within the property sheet section, choose the "Activation" tab and mark the "Reactivate" check.

If activating an execution environment which was previously activated within the context of a different SP or identity appliance, mark the "Overwrite Original Setup" check.

To run the pre-integrated example applications included in the JOSSO distribution, mark the "Install Demo Applications" check.

Once the activation connection setup is complete, roll out from the property sheet in order for the activation procedure to take place.