Data provisioning

Connector settings

Parameter	Description
Base address	Base address, for example: https://apis.egencia.com/openconnect/api/scim/v3
Authentication mode	OAuth2
OAuth Grant Type	Client credentials
URL for Authorization token	URL for Authorization token, for example: https://apis.egencia.com/auth/v1/token
OAuth Client ID	Client ID
OAuth Client Secret	Client secret
Token cache policy	Never cache
Security protocol	TLS 1.2
Content type header	application/json
Accept header	application/json
Timeout in seconds	100
Test connection	Select the checkbox
Test query	Users

Task mappings

The Omada Identity Egencia connectivity provides the following mappings:

Egencia user

The object is used for creating, updating, and deactivating user (account).

Parameter	Operator	Source
Object Id	Expression	Operation != "Create" ? Extensions.GetFirstValue(ROPE_DistinguishedName, ROPE_ExternalAnchor, JobAnchor) : "IGNORED"
Object type	Constant	Users
Operation	Map	Operation
schemas	Expression	Operation == "Create" || Operation == "Update" ? "urn:ietf:params:scim:schemas:core:2.0:User" : null
userName	Expression	Operation == "Create" || Operation == "Update" ? ROPE_ATTR_EMAIL : null
name.familyName	Expression	Operation == "Create" || Operation == "Update" ? ROPE_ATTR_LASTNAME : null
name.givenName	Expression	Operation == "Create" || Operation == "Update" ? ROPE_ATTR_FIRSTNAME : null
name.honorificPrefix	Expression	Operation == "Create" || Operation == "Update" ? ROPE_ATTR_C_HONORIFICPREFIX : null
userType	Expression	Operation == "Create" || Operation == "Update" ? "NORMAL" : null
emails[].type	Expression	Operation == "Create" || Operation == "Update" ? "WORK" : null
emails[].value	Expression	Operation == "Create" || Operation == "Update" ? ROPE_ATTR_EMAIL : null
emails[].primary	Expression	Operation == "Create" || Operation == "Update" ? "true" : null
phoneNumbers[].type	Expression	Operation == "Create" || Operation == "Update" ? "MOBILE" : null
phoneNumbers[].value	Expression	Operation == "Update" ? ROPE_ATTR_CELLPHONE : null
active	Expression	Operation == "Update" ? !ROPE_Disabled : true
id	Expression	(Operation == "Update" || Operation == "DeleteIfExists") ? ROPE_ExternalAnchor : null

Egencia roles

The object is used for assigning a role to users in Egencia.

Parameter	Operator	Source
Object Id	Expression	Extensions.GetFirstValue(ROPE_DistinguishedName, ROPE_AccountExternalAnchor, JobAnchor)
Object type	Constant	Users
Operation	Expression	(Operation=="Create" || Operation=="Update" || Operation=="Delete") ? "Update" : Operation
schemas	Constant	urn:ietf:params:scim:api:messages:2.0:PatchOp
Operations[].op	Expression	Operation == "Create" ? "add" : null
Operations[].value.roles[]	Map	ROPE_Resource
id	Map	ROPE_AccountExternalAnchor

Resource types

1. Go to Setup > Resource types. Click the Account resource category for your specific system.
2. Scroll down to Fulfillment (General).
3. Enable Reconcile account name. In the Reconciliation attributes map, enter the following:

CELLPHONE=cellphone

4. Click Apply and OK. Commit settings under the provisioning section.

Data object types

1. Go to Setup > Data object types and open Identities.
2. Click Properties and then Add.
3. Select the properties Egencia - id and cell phone.
4. Click OK, and then Close.
5. Click Apply, and then OK.

Omada Identity configuration

1. Go to Setup > All systems > Omada Identity.

2. Click Warehouse to portal mapping.

3. Click New and select Identities. Click OK. Enter the following details:

   1. Destination:

   • Operation: Update if exists

   • Key property: OISID

   • Import in single thread: No

   2. Source:
   • Warehouse view: Accounts
   • Scope: New and updated objects
   • Action on objects originating from ES: Include

4. Click Mappings and select the following options:

   • Cell phone > Map > cellphoneWOH
   • Egencia – id > Map > idWOH
   • OISID > Map > IdentityOISID

• Click OK to save.