Create the SSO Mapping File - Precisely_EnterWorks - EnterWorks - 11.0

EnterWorks Guide

Product type
Software
Portfolio
Verify
Product family
EnterWorks
Product
Precisely EnterWorks
Precisely EnterWorks > EnterWorks
Version
11.0
Language
English
Product name
Precisely EnterWorks
Title
EnterWorks Guide
Copyright
2024
First publish date
2007
Last updated
2025-01-07
Published on
2025-01-07T07:44:20.997000

The mapping feature allows EnterWorks to recognize attribute statement tags in the IDP's response that are different than what EnterWorks expects. To configure create the mapping file EnterWorks uses to recognize the new statement tags:

  1. Create a JSON file that maps the attribute statements EnterWorks is looking for to the tags the IDP is using. The JSON file must be named:
    sso-mappings.json
    and must be located in:
    <drive>:\Enterworks\enable2020\services\sso-mappings\
  2. The sso-mappings.json file has five key:value pairs:
    {
    	"login": "login",
    	"firstName": "firstName",
    	"lastName": "lastName",
    	"email": "email",
    	"groups": "groups"										
    }
  3. The key is what EnterWorks is looking for. Replace the value with the tag the IDP is using. For example, if the IDP is using the "email" tag as the login value, the sso-mappings.json file would have a key:value pair of "login": "email" as shown below.
    {
    	"login": "email",
    	"firstName": "firstName",
    	"lastName": "lastName",
    	"email": "email",
    	"groups": "groups"
    }
  4. The sso-mappings.json file only needs to contain key:value pairs for the attribute statement tags that are different from what EnterWorks is searching for. For example, if the IDP is using the "email" tag as the login value but the rest of the attribute statements are tagged as expected, the sso-mappings.json file could only have the key:value pair for "login": "email" as shown below.
    {
    	"login": "email"
    }
    
  5. Save the file.