{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21569,"path":"integrate-applications/integration-hub/setup-sapconcur-spk.md","title":"Set up the SAP Concur spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up the SAP Concur spoke\n\nIntegrate the ServiceNow instance and SAP Concur by creating a custom OAuth application in SAP Concur to authenticate ServiceNow requests.\n\n## Before you begin\n\n- Request an Integration Hub subscription.\n- Activate the SAP Concur spoke.\n- Role required: admin\n\n## Procedure\n\n1. Register SAP Concur as an OAuth provider.\n\n 1. Navigate to **System OAuth** > **Application Registry**.\n\n 2. Click **New**.\n\n The system displays the message **What kind of OAuth application?**\n\n 3. Select **Connect to a third party OAuth Provider**.\n\n The system displays a blank Application Registries form.\n\n 4. On the form, fill these values.\n\n |Field|Description|\n |-----|-----------|\n |Name|Name to uniquely identify the application registry. For example, `SAP Concur OAuth`.|\n |Client ID|Client ID of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.|\n |Client Secret|Client secret of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.|\n |Default Grant type|Grant type used to establish the token. Select **Resource Owner Password Credentials**.|\n |Token URL|URL from which the ServiceNow instance obtains the access token. Format of the token URL is, `https:///oauth2/v0/token`. Here, host name is the fully qualified domain name of the target host where SAP Concur is installed.|\n |Redirect URL|OAuth callback endpoint in this format: `https://.service-now.com/oauth_redirect.do`.|\n\n 5. Right-click the form header, and click **Save**.\n\n - The system validates the OAuth credentials and populates the **Redirect URL**.\n - 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**\n2. Create a credential record for the SAP Concur spoke.\n\n 1. Navigate to **Connections & Credentials** > **Credentials**.\n\n 2. Click **New**.\n\n The system displays the message **What type of Credentials would you like to create?**.\n\n 3. Select **OAuth 2.0 Credentials**.\n\n 4. On the form, fill these values.\n\n |Field|Value required|\n |-----|--------------|\n |Name|Name to uniquely identify the record. For example, enter `SAP Concur Cred`.|\n |Active|Option to actively use the credential record.|\n |OAuth Entity Profile|OAuth profile you created when you registered the custom SAP Concur application as an OAuth provider. For example, select **SAPConcur**.|\n |Applies to|Select the MID Servers that can use this credential. For example, select **All MID Servers**.|\n |Order|Select the order to apply this credential. For example, enter `100`.|\n\n 5. Save the record.\n\n3. Create a connection record for the SAP Concur spoke.\n\n 1. Navigate to **Connections & Credentials** > **Connection & Credential Aliases**.\n\n 2. Open for the record, **SAPConcur**.\n\n 3. From the **Connections** tab, click **New**.\n\n 4. On the form, fill these values.\n\n |Field|Value required|\n |-----|--------------|\n |Name|Name to uniquely identify the connection record. For example, enter `SAP Concur Connection`.|\n |Credential|Credential record you created for SAP Concur. For example, select **SAP Concur Cred**.|\n |Connection URL|Connection URL to connect to SAP Concur in this format: `/api`.|\n |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`.|\n |Protocol|`https`|\n |Base path|`/api`|\n\n 5. Click **Submit**.\n\n4. Generate OAuth token by providing the SAP Concur API user credentials.\n\n 1. Navigate to **Connections & Credentials** > **Credentials**.\n\n 2. Open the credential record you had created.\n\n Example: **SAP Concur Cred**\n\n 3. Click the **Get OAuth Token** related link and provide the SAP Concur API user credentials to generate the OAuth token.\n\n5. Configure the connection, **SAP Concur Event Subscription Service**.\n\n 1. Navigate to **Process Automation** > **Flow Designer**.\n\n 2. Click the **Connections** tab.\n\n 3. Locate the **SAP Concur Event Subscription Service** connection alias and click **View Details**.\n\n 4. To configure the spoke for the first time, select **Configure** or click **Edit**.\n\n 5. On the **Connection** form, fill in the fields.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nName\n\n\n\nName of the connection alias record.\n\n
\n\nConnection URL\n\n\n\nConnection URL in this format: `https://www-.api.concursolutions.com`.Replace `` with the appropriate SAP Concur region.\n\n
\n\nVersion\n\n\n\nEnter `v4`.\n\n
\n\nToken URL\n\n\n\nToken URL in this format: `https://.api.concursolutions.com/oauth2/v0/token`.Replace `` with the appropriate SAP Concur region.\n\n
\n\nClient ID\n\n\n\nClient ID of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.\n\n
\n\nClient Secret\n\n\n\nClient secret of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.\n\n
6. Click **Create and Get OAuth Token**.\n\n A confirmation message is displayed that the OAuth token is generated successfully.\n\n6. Configure the connection, **SAP Concur v4 APIs**.\n\n 1. Navigate to **Process Automation** > **Flow Designer**.\n\n 2. Click the **Connections** tab.\n\n 3. Locate the **SAP Concur v4 APIs** connection alias and click **View Details**.\n\n 4. Click **Edit** or if you are configuring the spoke for the first time, click **Configure**.\n\n 5. On the **Connection** form, fill in the fields.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nName\n\n\n\nName of the connection alias record.\n\n
\n\nConnection URL\n\n\n\nConnection URL in this format: `https://.api.concursolutions.com`.Replace `` with the appropriate SAP Concur region.\n\n
\n\nVersion\n\n\n\nEnter `v4`.\n\n
\n\nToken URL\n\n\n\nToken URL in this format: `https://.api.concursolutions.com/oauth2/v0/token`.Replace `` with the appropriate SAP Concur region.\n\n
\n\nClient ID\n\n\n\nClient ID of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.\n\n
\n\nClient Secret\n\n\n\nClient secret of your SAP Concur client application. Contact SAP Concur Implementation team to obtain this value.\n\n
6. Click **Create and Get OAuth Token**.\n\n In a new window, you will be prompted to enter **Username** and **Password**.\n\n 7. For **Username**, provide the Company ID of the SAP Concur instance and for **Password**, provide the value of Company Request Token.\n\n **Note:** Contact SAP Concur Implementation team to obtain the values of Company ID and Company Request Token.\n\n 8. Click **Get OAuth Token**.\n\n7. Map SAP Concur users to the ServiceNow user in the SAP Concur User Mappings module.\n\n 1. Navigate to **SAP Concur Spoke** > **SAP Concur User Mappings**.\n\n 2. Click **New**.\n\n 3. On the form, fill these values.\n\n |Field|Description|\n |-----|-----------|\n |ServiceNow User|Reference to the user record in the User \\[sys\\_user\\] table.|\n |SAP Concur User ID|User ID of the required user in SAP Concur.|\n\n 4. Click **Submit**.\n\n **Note:** If a user attempts to access data in the SAP Concur Expense Entries module without being mapped to the corresponding SAP Concur User ID in the SAP Concur User Mappings module, this error message is displayed.`A user with username adminn does not exist.`\n\n Map the ServiceNow user to the correspnding User ID in SAP Concur too access data in the SAP Concur Expense Entries module.\n\n - SAP Concur spoke is set up.\n - Data is retrieved and displayed in the SAP Concur Expense Entries and SAP Concur Expense Reports modules.\n\n"}}