Integrate EmpowerID Microservices with ServiceNow

Owned by
Phillip Hanegan
Last updated: Jan 23, 2024
4 min read

Organizations that have successfully connected EmpowerID to ServiceNow can leverage the powerful capabilities of EmpowerID's IAM Shop, Resource Admin, and Identity Manager microservices directly from the ServiceNow user interface. This is achieved by adding a widget to ServiceNow for each microservice you want to integrate. This article demonstrates how to add this functionality to ServiceNow by integrating the IAM Shop with a ServiceNow instance.

Although this article strictly demonstrates integrating the IAM Shop, you can follow the steps to integrate Resource Admin and Identity Manager microservices as well. When adding the widgets and pages for those microservices, use the appropriate naming convention and widget values for those microservices.

Procedure

Step 1 – Create a Service Portal Widget for the IAM Shop

  1. Log in to your ServiceNow instance.

  2. Navigate to All > Service Portal > Service Portal Configuration > Widget Editor.

  3. Click Create a new widget.

     

  4. Enter a name for the widget, such as “EmpowerID IAM Shop,” and click Submit.


    This opens the Widget Editor.

     

  5. Replace the code in the HTML Template with code similar to the following. Be sure to replace the URL shown with the URL pointing to your organization's IAM Shop portal.

    <iframe src="https://itshop.azurewebsites.net" style="width:100%;height:100vh"></iframe>

     

     

  6. Save the widget.

Step 2 – Create a Service Portal Page

  1. Navigate to Service Portal Configuration and click Add a new Page.

     

  2. Enter a Page Title, such as “IAM Shop Page,” and click Submit.


    This opens the Page designer.

     

  3. Under Layouts, select 12 and drag it onto the page.

     

  4. Search for the IAM Shop widget just created and drag it onto the designer.

     

  5. Click the Container link.

     

  6. Click the Edit icon for the container.

     

  7. Set the Container Width property to Fluid and save your changes.

 

Step 3 – Add a Navigation Menu Item for the IAM Shop Page

  1. Navigate to All > Service Portals > Portals.

  2. Select Service Portal.

     

  3. Next to the Main menu field, click Preview this record.

     

  4. Click Open Record.

     

  5. Under Menu Items, click New.

     

  6. On the Menu Item New Record form, enter the following information:

    1. Type – Page

    2. Label – This is the name that appears for the item in the menu.

    3. Page – Set this to the IAM Shop page created earlier.

    4. Glyph – Optionally, change the icon that appears next to the menu item.

    5. Click Submit.


      You should see the new menu item.

       

  7. Navigate to the Service Portal home.
    You should see the new IAM Shop menu item.

     

     

  8. Upon clicking the IAM Shop menu item, you should be prompted to authenticate and then directed to the IAM Shop for your organization.