12 Setting Up Single Sign-On for Pricing Design Center
Learn how to set up a single sign-on (SSO) login method for Oracle Communications Pricing Design Center (PDC) using SAML.
SSO allows you to log in to applications using a single user name and password combination. You set up SSO for PDC by using SAML 2.0.
To implement SSO for PDC:
-
Create a SAML assertion provider. See "Creating a SAML Assertion Provider".
-
Create a SAML authenticator. See "Creating a SAML Authenticator".
-
Define SAML 2.0 general information. See "Performing SAML 2.0 General Configurations".
-
Define the SAML service provider. See "Configuring the SAML Service Provider".
-
Generate a metadata file and publish it to all SAML identity providers. See "Publishing the Service Provider Metadata".
-
Update the PDC deployment plan. See "Updating the Deployment Plan for PDC".
Creating a SAML Assertion Provider
The SAML assertion provider validates a client's identity by mapping a client-supplied token to a user name.
To create a SAML assertion provider for PDC:
-
Log in to PDC WebLogic Server Administration Console.
-
In the Domain Structure section, click the Security Realms link.
The Summary of Security Realms page appears.
-
Click the myrealm link.
The Settings for myrealm page appears.
-
Click the Providers tab and then click the Authentication subtab.
-
Click New.
The Create a New Authentication Provider page appears.
-
In the Name field, enter samlPDC.
-
From the Type list, select SAML2IdentityAsserter.
-
Click OK.
-
Activate your changes and then restart WebLogic Server.
-
Click the Providers tab and then click the Authentication subtab.
-
In the Authentication Providers table, click the samlPDC link.
The Settings for samlPDC appears.
-
Click the Management tab.
-
In the table under Identity Provider Partners, click New and then New Web Single Sign-On Identity Provider Partner.
-
In the Create a SAML 2.0 Web Single Sign-on Identity Provider Partner page, do the following:
-
In the Name field, enter WebSSO-IdP-Partner-1.
-
In the Path field, specify or browse to the full path of the metadata partner file.
-
Click OK.
-
-
In the Identity Provider Partners table, click WebSSO-IdP-Partner-1.
-
Select the Enabled, Virtual User, and Process Attributes checkboxes.
-
In Redirect URIs, enter /pdc/*.
-
Click Save.
-
Verify the Identity Provider details in the Site Info and Single Sign-on Signing Certificate tabs.
Creating a SAML Authenticator
The SAML authenticator verifies the identity of users or system processes, and makes identity information available to PDC when that information is needed.
To create a SAML authenticator for PDC:
-
Log in to PDC WebLogic Server Administration Console.
-
In the Domain Structure section, click the Security Realms link.
The Summary of Security Realms page appears.
-
Click the myrealm link.
The Settings for myrealm page appears.
-
Click the Providers tab and then click the Authentication subtab.
-
Click New.
The Create a New Authentication Provider page appears.
-
In the Name field, enter samlPDCAuth.
-
From the Type list, select SAMLAuthenticator.
-
Click OK.
-
Click the samlPDCAuth link and then set Control Flag to SUFFICIENT.
-
Click Save.
-
Click the DefaultAuthenticator link and then set Control Flag to SUFFICIENT.
-
Click Save.
-
In the Settings for myrealm page, click Reorder.
-
Arrange the providers in the following order:
-
samlPDCAuth
-
samlPDC
-
DefaultAuthenticator
-
DefaultIdentityAsserter
-
-
Click OK.
-
In the Change Center, click Activate Changes.
Performing SAML 2.0 General Configurations
To perform SAML 2.0 general configurations:
-
Log in to PDC WebLogic Server Administration Console.
-
In the Domain Structure section, click Environment, Servers, and then AdminServer.
The Settings for AdminServer page appears.
-
Select Configuration, Federation Services, and then SAML 2.0 General.
-
In the Site Info section, enter the following information about your SAML 2.0 site:
-
Published Site URL: Enter http://pdc_hostname:port/saml2, where pdc_hostname is the PDC application host and port is the port on which PDC is listening on.
-
Entity ID: Enter samlPDC.
-
-
Click Save.
-
Activate your changes and then restart WebLogic Server.
Configuring the SAML Service Provider
To configure the SAML service provider:
-
Log in to PDC WebLogic Server Administration Console.
-
In the Domain Structure section, click Environment, Servers, and then AdminServer.
The Settings for AdminServer page appears.
-
Select Configuration, Federation Services, and then SAML 2.0 Service Provider.
-
Select the Enabled checkbox.
-
From the Preferred Binding list, select POST.
-
In the Default URL field, enter http://pdc_hostname:port/pdc/faces/oracle/communications/brm/pdc/ui/pages/login.jspx, where pdc_hostname is the PDC application host and port is the port on which PDC is listening on.
-
Activate your changes and then restart WebLogic Server.
Publishing the Service Provider Metadata
To publish the service provider metadata:
-
Log in to WebLogic Server Administration Console.
-
In the Domain Structure section, click Environment, Servers, and then AdminServer.
The Settings for AdminServer page appears.
-
Click Configuration, Federation Services, and then SAML 2.0 General.
-
Click Publish Meta Data.
The Publish SAML 2.0 Meta Data page appears.
-
In the Path field, enter the full path and name of the spmeta.xml file.
-
Click OK.
Updating the Deployment Plan for PDC
To update your deployment plan for PDC:
-
Create a new plan.xml file with the PDC deployment plan, or edit your existing plan.xml file.
-
In the file, add a logoutURL variable set to your identity provider (IDP) logout URL:
<variable-definition> <variable> <name>logoutUrl</name> <value>IDP_LOGOUT_URL</value> </variable> </variable-definition>
-
Add the following module-override element:
<module-override> <module-name>BPA.war</module-name> <module-type>war</module-type> <module-descriptor external="false"> <root-element>web-app</root-element> <uri>WEB-INF/web.xml</uri> <variable-assignment> <name>logoutUrl</name> <xpath>/web-app/context-param/[param-name="loginURL"]/param-value</xpath> <operation>replace</operation> </variable-assignment> </module-descriptor> </module-override>
-
Save and close your plan.xml file.
-
Redeploy the PDC application with your new plan.xml file.
For more information about updating and deploying your deployment plan, see the "Create and Use a Deployment Plan in Oracle WebLogic Server" tutorial.