Source: https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/X_Pages/CustomizeX_Pages/IntegrateExtData.htm

## Integrating External Data with X-Pages

Content developers can create X-Pages content that integrates data and real-time services from external applications in a secure way, using Vault Session ID or SSO authentication. This allows users to view data from Vault CRM and external sources combined without navigating away from the Vault CRM app to authenticate to the external source.

For example, a content developer creates an X-Page that displays data from an internal chat bot. Since the information is from their own system, values are displayed in real-time.

**Who can use this feature?**

* Content Developers - Browser
* [Enabling X-Pages Integration with External Applications](#Enabling)
* End Users - Browser, iPad, iPhone
* [Using X-Pages Integrated with External Applications](#Using)
* Vault CRM Admins - Browser
* [Viewing Activity Logs](#Viewing)
* Users do not require an additional license

### Configuring X-Pages Integration with External Applications for

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Content Developers](#)

This configuration applies to SSO authentication only. Vault Session ID authentication does not require configuration.

To configure this feature:

1. Ensure [Configuring X-Pages](../X_PagesConfig.htm) is complete.
2. Navigate to **Business Admin > Objects** > **xpages\_sso\_configuration\_\_v**.
3. Select **Create**.
   ![](../../../Resources/Images/X-Pages/Custom_Scopes.png)
4. Enter the following information as found in your SSO configuration:

* API name
* Authentication endpoint
* Token endpoint
* Client ID
* Client secret

5. Copy the **Authorization Redirect URI** and add it to your SSO configuration.
6. Add a space-delimited list of custom scopes in the Custom Scopes field. These scopes are appended to the SSO IDP access token request. Only [valid OAuth scope-token characters](https://www.rfc-editor.org/rfc/rfc6749#section-3.3) and spaces are allowed. This step is optional.
7. Select **Save**.

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

To configure this feature:

1. Ensure[Configuring X-Pages](../X_PagesConfig.htm) is complete.
2. Navigate to Admin > Users & Groups > Permission Sets.
3. Select the appropriate permission set.
4. Select Objects.
5. Grant the following permissions:
6. | Object | Object ermission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | xpages\_sso\_configuration\_\_v | R | OAuth 2.0 / OIDC | * API Name * Authorization endpoint * Client ID * Client Secret * Created By * Created Date * Custom Scopes (optional) * Last Modified By * Last Modified Date * Status * Token endpoint | Read |

### Enabling X-Pages Integration with External Applications as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Content Developers](#)

External connections in Vault can be authorized using an SSO access token or a Vault Session ID. Content developers can use either of the following request methods to access data from the specified external application directly from an X-Page:

* Using SSO Authentication - If the external application uses OAuth-based SSO, content developers can use the [getSSOAccessToken](https://developer.veevacrm.com/doc/Content/CRM_topics/Vault/x-pages-library.htm) method to retrieve a valid access token that can be passed through a customer-defined authentication process for the external application.
* Using Vault Session ID Authentication - X-Pages content developers can use the [getVaultSessionId](https://developer.veevacrm.com/doc/Content/CRM_topics/Vault/x-pages-library.htm#getVaultSessionId) method to retrieve a valid session ID that can be used to communicate with Vault APIs or passed through a customer-defined authentication process for the external application.

### Using X-Pages Integrated with External Applications as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

End users can view data from Vault CRM and external sources combined without navigating away from the Vault CRM app to authenticate to the external source.

### Viewing Activity Logs as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Vault CRM Admins](#)

Vault CRM Admins can view information about session IDs or access token requests in the [Activity Log](https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/Getting_Started/MobileDeviceSetup/Sync/ActivityLogs.htm) to ensure only appropriate X-Pages content is using them.

### Related Topics

[X-Pages Overview](../X_PagesOverview.htm)

[Creating X-Pages Content](../CreateX_Pages/CreateRecord.htm)