Set up the SAP Concur spoke

Integrate the ServiceNow instance and SAP Concur by creating a custom OAuth application in SAP Concur to authenticate ServiceNow requests.

Before you begin

• Request an Integration Hub subscription.
• Activate the SAP Concur spoke.
• Role required: admin

Procedure

1. Register SAP Concur as an OAuth provider.

   1. Navigate to System OAuth > Application Registry.

   2. Click New.

      The system displays the message What kind of OAuth application?

   3. Select Connect to a third party OAuth Provider.

      The system displays a blank Application Registries form.

   4. On the form, fill these values.

      Field	Description
      Name	Name to uniquely identify the application registry. For example, SAP Concur OAuth.
      Client ID	Client ID of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.
      Client Secret	Client secret of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.
      Default Grant type	Grant type used to establish the token. Select Resource Owner Password Credentials.
      Token URL	URL from which the ServiceNow instance obtains the access token. Format of the token URL is, https://<host-name>/oauth2/v0/token. Here, host name is the fully qualified domain name of the target host where SAP Concur is installed.
      Redirect URL	OAuth callback endpoint in this format: https://<instance>.service-now.com/oauth_redirect.do.

   5. Right-click the form header, and click Save.

      • The system validates the OAuth credentials and populates the Redirect URL.
      • The system populates OAuth Entity Profile with Grant Type as Resource Owner Password Credentials. For example, OAuth Entity Profile is created with default Name, SAPConcur
      • Create a credential record for the SAP Concur spoke.

   6. Navigate to Connections & Credentials > Credentials.

   7. Click New.

      The system displays the message What type of Credentials would you like to create?.

   8. Select OAuth 2.0 Credentials.

   9. On the form, fill these values.

      Field	Value required
      Name	Name to uniquely identify the record. For example, enter SAP Concur Cred.
      Active	Option to actively use the credential record.
      OAuth Entity Profile	OAuth profile you created when you registered the custom SAP Concur application as an OAuth provider. For example, select SAPConcur.
      Applies to	Select the MID Servers that can use this credential. For example, select All MID Servers.
      Order	Select the order to apply this credential. For example, enter 100.

   10. Save the record.

2. Create a connection record for the SAP Concur spoke.

   1. Navigate to Connections & Credentials > Connection & Credential Aliases.

   2. Open for the record, SAPConcur.

   3. From the Connections tab, click New.

   4. On the form, fill these values.

      Field	Value required
      Name	Name to uniquely identify the connection record. For example, enter SAP Concur Connection.
      Credential	Credential record you created for SAP Concur. For example, select SAP Concur Cred.
      Connection URL	Connection URL to connect to SAP Concur in this format: <Host>/api.
      Host	Fully qualified domain name of the target host where SAP Concur is installed. For example, us.api.concursolutions.com or eu.api.concursolutions.com.
      Protocol	https
      Base path	/api

   5. Click Submit.

3. Generate OAuth token by providing the SAP Concur API user credentials.

   1. Navigate to Connections & Credentials > Credentials.

   2. Open the credential record you had created.

      Example: SAP Concur Cred

   3. Click the Get OAuth Token related link and provide the SAP Concur API user credentials to generate the OAuth token.

4. Configure the connection, SAP Concur Event Subscription Service.

   1. Navigate to Process Automation > Flow Designer.

   2. Click the Connections tab.

   3. Locate the SAP Concur Event Subscription Service connection alias and click View Details.

   4. To configure the spoke for the first time, select Configure or click Edit.

   5. On the Connection form, fill in the fields.

6.  Click **Create and Get OAuth Token**.

A confirmation message is displayed that the OAuth token is generated successfully.

1. Configure the connection, SAP Concur v4 APIs.

   1. Navigate to Process Automation > Flow Designer.

   2. Click the Connections tab.

   3. Locate the SAP Concur v4 APIs connection alias and click View Details.

   4. Click Edit or if you are configuring the spoke for the first time, click Configure.

   5. On the Connection form, fill in the fields.

6.  Click **Create and Get OAuth Token**.

    In a new window, you will be prompted to enter **Username** and **Password**.

7.  For **Username**, provide the Company ID of the SAP Concur instance and for **Password**, provide the value of Company Request Token.

    **Note:** Contact SAP Concur Implementation team to obtain the values of Company ID and Company Request Token.

8.  Click **Get OAuth Token**.

1. Map SAP Concur users to the ServiceNow user in the SAP Concur User Mappings module.

   1. Navigate to SAP Concur Spoke > SAP Concur User Mappings.

   2. Click New.

   3. On the form, fill these values.