Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Div
classbreadcrumbs

/wiki/spaces/E2D/pages/29982926  /  

...

Web Access Management  /  Current: Creating a WAM SSO Application for

...

the Sample App


To enable the EmpowerID Agent to protect the Andy's Beans Web site, you neet to create an application for it with URL subcomponents for each URL or group of URLs on the site you want to protect in EmpowerID and link that application to a SAML SSO Connection to provide single sign-on capabilities to all authorized users.

For the

...

Andy's Beans Web site, there are a number of URLs that need to be restricted. These include the following:


AndysBeans/Employees
AndysBeans/

...

EmployerAndysBeans/

...

ProductManager
AndysBeans/Employees/

...

DetailsAndysBeans/

...

EmployeeManager/

...

CreateAndysBeans/

...

ProductManager/

...

Create
AndysBeans/

...

Employees/MyHRAndysBeans/EmployeeManager/

...

DetailsAndysBeans/

...

ProductManager/Details
AndysBeans/

...

Employees/

...

MyMedicalAndysBeans/EmployeeManager/

...

EditAndysBeans/ProductManager

...

/

...

Edit
AndysBeans/

...

Employees/

...

UpdatePlanAndysBeans/

...

EmployeeManager/

...

DeleteAndysBeans/ProductManager/Delete



There are a number of ways in which these URLs can be protected, depending on the granularity of your security policy:

...

  • Add a URL subcomponent that is an exact match for a specific URL, limiting the scope of the subcomponent to that one URL

...

  • .
  • Create a URL subcomponent that uses a

...

  • JavaScript regular expression to block access to all URLs meeting the condition (pattern match) of the expression

...

  • .
  • Create a path-specific URL subcomponent that restricts access to any URL with a matching beginning path.

...

This example uses a combination of the second two,  pattern matches and beginning paths, to protect the

...

Andy's Beans URLs.

To create

...

a WAM SSO application for AndysBeans

...


  1. In the Navigation Sidebar of the EmpowerID Web interface,

...

  1. expand Applications and

...

  1. click Manage Applications.
  2. From the Application page, click the Create Application Action link.

...



  1. Image Added


    This opens the Application Details

...

  1. form

...

  1. with fields and options for

...

  1. registering applications in EmpowerID.

...


  1. Image Added

  2. In the General section of the form, do the following:

    ...

      1. In the Name field, enter AndysBeans.

    ...

      1. In the Display Name and Description fields, enter Andy's Beans Web Site

    ...

      1. .
      2. Leave the Icon field as is.
      3. Leave the Full URL (Exact Match Path) blank. This field is used with Reverse Proxy applications.

    ...

      1. Fill in the Base URL for HTTP Module field

    ...

      1. with your base URL. 
      2. Leave Allow Access Requests

    ...

      1. selected so that the application appears in the IT Shop, allowing users to request or claim an account in the application.
      2. Leave Allow Claim Account

    ...

      1. selected so that users can claim their accounts and

    ...

      1. gain instant access after passing the requisite identity proofs.
      2. Select Login Is Email Address (Receive OTP to Claim)

    ...

      1. to receive a one-time password to claim the account

    ...

      1. and to pass the identity assertion to the application when logging in from EmpowerID.
      2. Leave Allow Request Account checked. When this option is selected and Allow Access Requests is selected, users can request an account in the application.

    ...

      1. Select Make me the Application Owner so that

    ...

      1. application owners can manage the application and approve or deny access requests.
      2. Leave Configure Advanced Claim and Request Account Options

    ...

      1. cleared.

    ...

      1. This is what the General section of the Application Details form looks like after

    ...

      1. completing these steps.

    ...


      1. Image Added

    1. Click the Single Sign-On tab, select Web Access Management (HTTP Header) from the Single Sign-On Connection Type drop-down.

    ...

    1.  

      Image Added

      This opens the WAM Connection Information section of the form. You use this section to build the SSO Connection

    ...

    1. for the Web application.

    ...


    1. Image Added

    2. In the WAM Connection Information section, do the following:
      1. Leave the Display Name field as is.

    ...

      1. In the Base URL for Reverse Proxy field, enter https://sso.empowersso.com/andybeans

    ...

      1. ,replacing sso.empowersso with the FQDN of the server hosting the application in your environment.

    ...

      1. In the Description field, enter Andy's Beans WAM connection

    ...

      1. .
      2. Leave Allow Anonymous Access to Unprotected paths

    ...

      1. cleared.
      2. Leave Use Target Hostname in Requests (Reverse Proxy Only)

    ...

      1. cleared.
      2. Select the certificate used in your environment for signing SAML assertions from the Certificate drop-down.

        Info

        This certificate can be a self-signed certificate that you can generate using the EmpowerID Certificate Manager. The certificate must be mapped to an EmpowerID Person with

    ...

      1. access

    ...

      1. to make calls to the EmpowerID API.

        For information on using the Certificate Manager to generate the certificate and mapping it to an EmpowerID Person, expand the

    ...

      1. drop-down

    ...

    titleTo generate and map a self-signed certificate

    ...

    EmpowerID stores each certificate in the CertificateStore table of the EmpowerID Identity Warehouse.

    ...

    • Select the X509 Certificate certificate type.
    • Enter a password for the certificate in the Password field.
    • Browse to and select an Output Folder for the certificate.
    • Check Import to EmpowerID Certificate store.
    • Check Import to Local Certificate Store.
    • Click Generate.

    Next, map the certificate to an EmpowerID Person with the access to make API calls by doing the following:

    1. From the EmpowerID Web interface, navigate to the View page for the Person to whom you want to map the certificate.
    2. From the View page for the person, expand the Role, Accounts, and Login Security accordion and then click the Edit link in the Mapped Login Certificates pane.
    3. Search for and select the self-signed certificate and then click Save.

    ...

      1. below.





        When you have finished, the WAM Connection Information section

    ...

      1. looks similar to the following image.

    ...


      1. Image Added

    1. On the Users tab

    ...

    1. , select Create a New Account Directory

    ...

    1.  to create a "tracking-only" account store

    ...

    1. that exists as a container within EmpowerID

    ...

    1. that stores user and group records for SSO or attestation

    ...

    1. without making a connection to the external application directory

    ...

    1. .

      Info

      Opting to create a new

    ...

    1. account store when registering applications in EmpowerID is advantageous in that doing so creates a one-to-one

    ...

    1. correlation between the account store and the application, as well as the SSO connection for the application.

      When you create a new Account Directory, EmpowerID

    ...

    1. gives the directory

    ...

    1. the same name

    ...

    1. as the application.

    ...



    1. Image Added


    2. On the Extension tab

    ...

    1. , enter 1111 in the AppExtensionAttribute12 field.

    ...



    1. Image Added

    2. Click Add to Cart.
    3. Click the My Cart icon and in the dialog that appears, enter a reason for creating the application and

    ...

    1. click Submit.


    Now that the WAM application has been created, the next step is to add protected application subcomponents for each of the URLs that need to be protected for unauthorized access.


    To add protected application subcomponents (URLs)


    1. From the Navigation Sidebar

    ...

    1. , expand Applications and

    ...

    1. click Manage Applications.
    2. Search for Andy's Beans Web Site and then click the Display Name link for it.

    ...



    1. Image Added


      This directs you to the View One page for the application. View One pages allow you to view information about an object in

    ...

    1. EmpowerID and manage it as needed.

    ...

    1.  

      Image Added


    2. From the View One page, expand the Protected Application Components accordion and

    ...

    1. click the Add Protected Application Subcomponent (+) button.
    2. In the dialog that appears do the following to protect all pages of Andy's Beans that start

    ...

    1. with productmanager:

      ...

        1. From the Type drop-down, select URL.

      ...

        1. In the Name, Display Name and Description fields, enter AB Product Manager Pages.
        2. Leave the Icon field as is.

      ...

        1. Select Allow Access Requests

      ...

        1.  to let users

      ...

        1. request access to the page from the IT Shop.

      ...

        1. In the Starts

      ...

        1. with Path field, enter andysbeans/productmanager.
        2. Leave ABAC Check

      ...

        1. cleared.

          The Protected Application Subcomponent dialog looks like this:

          Image Added

        2. Click Save.

      ...


      1. Expand the Protected Application Components accordion and click the Add Protected Application Subcomponent (+) button.
      2. In the dialog that appears do the following to protect the all pages in Andy's Beans beginning

      ...

      1. with employees:

        ...

          1. From the Type drop-down, select URL.

        ...

          1. In the Name, Display Name and Description fields, enter AB Employee Pages.
          2. Leave the Icon field as is.

        ...

          1. Select Allow Access Requests

        ...

          1.  to let users

        ...

          1. request access to the page from the IT Shop.

        ...

          1. In the Starts

        ...

          1. with Path field, enter andysbeans/employees.
          2. Leave ABAC Check

        ...

          1. cleared.

            The Protected Application Subcomponent dialog looks like this:

            Image Added

          2. Click Save.

        ...


        1. Expand the Protected Application Components accordion

        ...

        1. and click the Add Protected Application Subcomponent (+) button.
        2. In the dialog that appears do the following to protect

        ...

        1. all pages in Andy's Beans beginning

        ...

        1. with employeemanager:

          ...

            1. From the Type drop-down, select URL.

          ...

            1. In the Name, Display Name and Description fields, enter AB Employee Manager Pages.
            2. Leave the Icon field as is.

          ...

            1. Select Allow Access Requests

          ...

            1.  to let users

          ...

            1. request access to the page from the IT Shop.

          ...

            1. In the Starts

          ...

            1. with Path field, enter andysbeans/employeemanager.
            2. Leave ABAC Check

          ...

            1. cleared.

              The Protected Application Subcomponent dialog looks like this:

              Image Added

            2. Click Save.

          ...


          After completed the above steps, the Protected Application Subcomponents accordion should look like the below image

          ...

          .

          ...


          Image Added


          Now that the application and the protected application subcomponents for the application

          ...

          are created, the next step is to create a number of people in EmpowerID with accounts in Andy's Beans.

          ...

           


          To add user accounts to the Andy's Beans WAM application account store


          1. Navigate to the User Accounts page by expanding Identities and clicking User Accounts.
          2. Click the Create User (Person Optional) action link.

          ...



          1. Image Added


            This opens the Create User form.

          ...


          1. Image Added

          2. From the Account Type drop-down

          ...

          1. , select Personal Standard.
          2. In the First Name field

          ...

          1. , enter Charles, and in the Last Name field

          ...

          1. , enter Stripe.
          2. In the Display Name field, enter Charles Stripe.

            Tip

            Charles Stripe is the Employee Manager for Andy's Beans.

          ...


          1. Below Account Creation Location, click the Select a Location link

          ...

          1. .
            1. In the Location Selector, search for AndysBeans and

          ...

            1. click the node for AndysBeans

          ...

            1. .
            2. Click Save to close the Location Selector.

          ...



            1. Image Added

          1. In the Logon Name field, enter charles.stripe@andysbeans.com

          ...

          1. .
          2. In the Description field, enter Andy's Beans user account for Charles Stripe

          ...

          1. .
          2. Optionally, enter

          ...

          1. comments in the Comments or Justification field.

          ...

          1. Select Create a new EmpowerID Person object. The person created will be the owner of the user account.

          ...

          1. Below Person Business Role, click the Select a Role and Location link to open the Business Role and Location selector.

          ...



          1. Image Added

            1. Search for the Temporary Role Business Role and

          ...

            1. click the node for that role to select it.

          ...



            1. Image Added

            2. Click Location to open the Location panel of the Business Role and Location selector.
            3. Search for the Temporary Location Location and

          ...

            1. click the node for that location to select it.

          ...



            1. Image Added

            2. Click

          ...

            1. Select to select the Business Role and Location combination and close the Business Role and Location selector.

          ...



          1. Select Allow me to enter a password and then enter pass@word1 in the Password and Confirm Password fields.

          ...



          1. Image Added

          2. Ensure that Allow Joining Account to Person and Allow Provisioning a Person from Account are selected

          ...

          1. .

            Image Added

          2. Click Save.

            After EmpowerID creates the user account and the person owning the account, your browser

          ...

          1. is directed to the Account Details page for the account.

          To assign access to the Account Store 

          1. From the Account Details page that opens, click the EmpowerID Logon link. This

          ...

          1. directs your browser to the View page for the Charles Stripe person.

          ...



          1. Image Added

          2. From the View page for Charles Stripe, expand the Access Assignments accordion

          ...

          1. and do the following to give Charles Stripe access to the employees and employeemanager pages of the AndysBeans application.

            1. Click the Add New Assignment (+) button.

          ...

            1. From the Assign direct to resource or other method drop-down, select Direct.

          ...

            1. From the Resource Type drop-down, select Pages and Reports.

            2. In the Enter a Pages and Reports Name to Search field, enter AB Employee Manager Pages and

          ...

            1. click the tile to select

          ...

            1. it.

          ...

            1. From the Access Level drop-down, select Viewer.

              Image Added

            2. Click Save to add the assignment to the Shopping Cart.

            3. Repeat the above, this time giving Charles Stripe Viewer access to AB Employee Pages

          ...

            1. .

          1. From the View page for Charles Stripe, click the Edit link to put the page in edit mode.

          ...



          1. Image Added


          2. Locate the Login field and change the value from charles.stripe@andysbeans.com to charles.stripe.
          3. Enter Self-Service User in the Management Roles field and

          ...

          1. click the tile for the role to select it.

          ...



          1. Image Added


          2. Click Save.
          3. Finally, click the Shopping Cart and in the dialog that appears, enter a reason for the assignment and

          ...

          1. click Submit.

          ...



          1. Image Added


          2. Repeat these steps for the following Andy's Beans users:
            • George Varghese

          ...

            •  is the Product

          ...

            • Manager  and needs access to the employees and productmanager pages

          ...

            • .
            • Barry Chandler

          ...

            •  is an employee

          ...

            • and needs access to the employees pages

          ...

            • .
            • Fritz Dame

          ...

            •  is an employee

          ...

            • and needs access to the employees pages

          ...

            • .
            • Tim Johnson

          ...

            •  is an employee

          ...

            • and needs access to the employees pages

          ...

            • .
            • Maria Hansen

          ...

            •  is an employee

          ...

            • and needs access to the employees pages

          ...

            • .
            • Rhonda Black

          ...

            •  is an employee

          ...

            • and needs access to the employees pages

          ...

          Concepts:

          ...

          Administrative Procedures:

          ...

          References:

          ...

          Now that you have created the WAM application for AndysBeans, the next step is to create an OAuth application for it.





          Div

          ...

          stylefloat: left; position: fixed; top: 105px; padding: 5px;
          idtoc
          classtopicTOC


          Div
          stylemargin-left: 40px; margin-bottom: 40px;

          Live Search
          spaceKeyE2D
          placeholderSearch the documentation
          typepage


          Div
          stylefont-size: 1rem; margin-bottom: -45px; margin-left: 40px;text-transform: uppercase;

          On this page



          Table of Contents
          maxLevel2
          stylenone