ServiceNow

Setup Guide

Follow these steps to connect ServiceNow to your CData Virtuality account:

1. In the Web UI, open the Sources page:
   

   

    

2. Type ServiceNow into the search field, then click the data source button:
   

   

3. On the Basic Settings tab of the new connection, enter a data source name or keep the default name.

4. Enter the base URL of your ServiceNow instance (for example, https://MyInstance12345.service-now.com/).

5. Select the Authentication method, then proceed to the relevant section and follow those instructions.

Authentication Methods

Basic

1. Enter the ServiceNow username for authentication in the User Field.

2. In Password, enter the user password.

3. At the top of the CData Connect Cloud Add ServiceNow Connection page, click Save & Test.

   • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

   • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

OAuth

1. Enter the OAuth Client Id in your app settings.

2. Enter the OAuth Client Secret in your app settings.

3. Click Sign in to connect securely through OAuth. This action opens the ServiceNow sign-in page in a new tab.

4. Log into your ServiceNow account and provide the requested permissions (if applicable).

5. At the top of the CData Connect Cloud Add ServiceNow Connection page, click Save & Test.

   • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

   • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

OauthPassword

1. Enter the ServiceNow username for authentication in the User Field.

2. In Password, enter the user password.

3. Enter the OAuth Client Id in your app settings.

4. Enter the OAuth Client Secret in your app settings.

5. At the top of the CData Connect Cloud Add ServiceNow Connection page, click Save & Test.

   • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

   • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

OKTA

1. Enter the OKTA User Id.

2. Add the Password for that account.

3. Set the SSO Login URL to the URL use by the SSO provider.

4. Enter the SSO Properties, with the format ‘ssoproperty1=value1;sooproperty2=value2;sooproperty3=value3;’. Make sure to separate all property-value pairs with semicolons.

5. At the top of the CData Connect Cloud Add ServiceNow Connection page, click Save & Test.

   • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

   • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

ADFS

1. Enter the ADFS User Id.

2. Add the Password for that account.

3. Set the SSO Login URL to the URL use by the SSO provider.

4. Enter the SSO Properties, with the format ‘ssoproperty1=value1;sooproperty2=value2;sooproperty3=value3;’. Make sure to separate all property-value pairs with semicolons.

5. At the top of the CData Connect Cloud Add ServiceNow Connection page, click Save & Test.

   • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

   • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

OneLogin

1. Enter the OneLogin User Id.

2. Add the Password for that account.

3. Enter the SSO Properties, with the format ‘ssoproperty1=value1;sooproperty2=value2;sooproperty3=value3;’. Make sure to separate all property-value pairs with semicolons.

4. At the top of the CData Connect Cloud Add ServiceNow Connection page, click Save & Test.

   • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

   • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

PingFederate

1. Enter the PingFederate User Id.

2. Add the Password for that account.

3. Set the SSO Login URL to the URL use by the SSO provider.

4. Enter the SSO Properties, with the format ‘ssoproperty1=value1;sooproperty2=value2;sooproperty3=value3;’. Make sure to separate all property-value pairs with semicolons.

5. At the top of the CData Connect Cloud Add ServiceNow Connection page, click Save & Test.

   • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

   • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

More Information

For more details on the ServiceNow driver, see this information page.