Customize > OAuth Integration

You can use the OAuth Integration area to customize the OAuth integration settings,
allowing you to configure Single Sign-On (SSO) access to Incent using the OAuth 2.0
authorization framework.

note: You can configure a seamless single sign on (SSO) experience for your users that uses SAML and OAuth together. To do so, select the Enable SP-initiated SSO option when configuring SAML integration (in the Setup > Customize > OAuth Integration area) and then contact Xactly Support to enable SAML/OAuth integration. In this case, you do not need to configure OAuth using the OAuth Integration area (this page).

Screen

OAuth Integration Screen

All Fields

The following table describes the information you need to specify when customizing
OAuth integration:

How to…

This section describes the tasks you can perform when customizing OAuth integration.

Specify the OAuth Integration Settings

1. Click the Setup tab, then click Customize > OAuth Integration in the secondary
menu. The OAuth Integration screen appears.

2. In the OAuth Integration field, select either ON or OFF using the radio buttons

3. In the OAuth Authorization Server section, specify the OAuth authorization server
URL and parameters needed to obtain the access token.

Do the following:

a. In the OAuth Authorization Server URL field, type the URL to the OAuth authorization
server.
This is the authorization server used to obtain the access token.
b. In the Server Access Method field, select the method (either GET or POST) for
accessing the authorization server using the radio buttons.
c. In the URL Parameters field, click the button to add a new
parameter to the URL used to access the authorization server.

Specify the URL parameters, including a parameter name, parameter type,
and parameter value. Click the button to remove an existing parameter.

4. In the OAuth Authorization Response section, click the button
to specify the parameters associated with the access token in the response from
the authorization server.

Specify the parameter name in the text box that appears. Click thebutton to
remove an existing parameter.

5. In the OAuth Validation Server section, specify the OAuth validation server URL
and parameters needed to validate the access token.

Do the following:

a. In the OAuth Validation Server URL field, type the URL to the OAuth validation
server.
This is the validation server used to validate the access token.
b. In the Server Access Method field, select the method (either GET or POST) for
accessing the validation server using the radio buttons.
c. In the URL Parameters field, click the  button to add a new
parameter to the URL used to access the validation server.
Specify the URL parameters, including a parameter name, parameter type,
and parameter value. Click the button to remove an existing parameter.

6. In the JSON Object Parser section, specify the fields in the JSON object obtained
from the validation server that correspond to the Incent username and shared
key.

Do the following:

a. In the User Name Field box, type the user name in the JSON object that corresponds
to the Incent username.
b. In the Shared Key Field box, type the shared key in the JSON object that corresponds
to the Incent shared key.

7. Click the button to validate the OAuth integration configuration. A
dialog appears indicating either success or an explanation of the missing or
incomplete data. Click the OK button to dismiss the dialog.

8. Click the button to save the OAuth integration configuration. A dialog
appears indicating success (or an explanation of the missing or incomplete
data). Click the OK button to dismiss the dialog.