Tutorial: Configure Concur for automatic user provisioning
The objective of this tutorial is to show you the steps you need to perform in Concur and Microsoft Entra ID to automatically provision and de-provision user accounts from Microsoft Entra ID to Concur.
This provisioning integration is no longer supported. As a result of this, the provisioning functionality of the SAP Concur application in the Microsoft Entra Enterprise App Gallery will be removed soon. The application's SSO functionality will remain intact. Microsoft is working with SAP Concur to build a new modernized provisioning integration, but there is currently no ETA on when this will be completed.
The scenario outlined in this tutorial assumes that you already have the following items:
- A Microsoft Entra tenant.
- A Concur single sign-on enabled subscription.
- A user account in Concur with Team Admin permissions.
Assigning users to Concur
Microsoft Entra ID uses a concept called "assignments" to determine which users should receive access to selected apps. In the context of automatic user account provisioning, only the users and groups that have been "assigned" to an application in Microsoft Entra ID is synchronized.
Before configuring and enabling the provisioning service, you need to decide what users and/or groups in Microsoft Entra ID represent the users who need access to your Concur app. Once decided, you can assign these users to your Concur app by following the instructions here:
Important tips for assigning users to Concur
It is recommended that a single Microsoft Entra user be assigned to Concur to test the provisioning configuration. Additional users and/or groups may be assigned later.
When assigning a user to Concur, you must select a valid user role. The "Default Access" role does not work for provisioning.
Enable user provisioning
This section guides you through connecting your Microsoft Entra ID to Concur's user account provisioning API, and configuring the provisioning service to create, update, and disable assigned user accounts in Concur based on user and group assignment in Microsoft Entra ID.
You may also choose to enabled SAML-based Single Sign-On for Concur, following the instructions provided in the Azure portal. Single sign-on can be configured independently of automatic provisioning, though these two features compliment each other.
To configure user account provisioning:
The objective of this section is to outline how to enable provisioning of Active Directory user accounts to Concur.
To enable apps in the Expense Service, there has to be proper setup and use of a Web Service Admin profile. Don't add the WS Admin role to your existing administrator profile that you use for T&E administrative functions.
Concur Consultants or the client administrator must create a distinct Web Service Administrator profile and the Client administrator must use this profile for the Web Services Administrator functions (for example, enabling apps). These profiles must be kept separate from the client administrator's daily T&E admin profile (the T&E admin profile should not have the WSAdmin role assigned).
When you create the profile to be used for enabling the app, enter the client administrator's name into the user profile fields. This assigns ownership to the profile. Once one or more profiles is created, the client must log in with this profile to click the "Enable" button for a Partner App within the Web Services menu.
For the following reasons, this action should not be done with the profile they use for normal T&E administration.
The client has to be the one that clicks "Yes" on the dialogue window that is displayed after an app is enabled. This click acknowledges the client is willing for the Partner application to access their data, so you or the Partner cannot click that Yes button.
If a client administrator that has enabled an app using the T&E admin profile leaves the company (resulting in the profile being inactivated), any apps enabled using that profile does not function until the app is enabled with another active WS Admin profile. This is why you are supposed to create distinct WS Admin profiles.
If an administrator leaves the company, the name associated to the WS Admin profile can be changed to the replacement administrator if desired without impacting the enabled app because that profile does not need inactivated.
To configure user provisioning, perform the following steps:
Log on to your Concur tenant.
From the Administration menu, select Web Services.
On the left side, from the Web Services pane, select Enable Partner Application.
From the Enable Application list, select Microsoft Entra ID, and then click Enable.
Click Yes to close the Confirm Action dialog.
Browse to Identity > Applications > Enterprise applications.
If you have already configured Concur for single sign-on, search for your instance of Concur using the search field. Otherwise, select Add and search for Concur in the application gallery. Select Concur from the search results, and add it to your list of applications.
Select your instance of Concur, then select the Provisioning tab.
Set the Provisioning Mode to Automatic.
Under the Admin Credentials section, enter the user name and the password of your Concur administrator.
Select Test Connection to ensure Microsoft Entra ID can connect to your Concur app. If the connection fails, ensure your Concur account has Team Admin permissions.
Enter the email address of a person or group who should receive provisioning error notifications in the Notification Email field, and check the checkbox.
Under the Mappings section, select Synchronize Microsoft Entra users to Concur.
In the Attribute Mappings section, review the user attributes that are synchronized from Microsoft Entra ID to Concur. The attributes selected as Matching properties are used to match the user accounts in Concur for update operations. Select the Save button to commit any changes.
To enable the Microsoft Entra provisioning service for Concur, change the Provisioning Status to On in the Settings section
You can now create a test account. Wait for up to 20 minutes to verify that the account has been synchronized to Concur.