Creating an OAuth2 Client

For examples of other providers, see our online help center inside X3.

Prerequisites

To set up OAuth2 with a Google account, you need:

1. The URL of your X3 solution. For example, https://mycompany.sagex3.com.
2. A Google account to administer the service. This can be created from this link.
3. A name for your OAuth2 service. It must start with a letter (A-Z or a-z), followed with any combination of letters (A-Z or a-z), digits, or underscores. In the following example, the name “Google” is used.

Creating a Client ID

1. Go to https://console.developers.google.com and create a project.

   

   

2. Enter the name of the project you want to create and click Create.

   

3. Go to the Credentials tab and click Create credentials.

   

4. Select OAuth client ID.

   

5. Click Configure consent screen if it is the first time you are creating credentials.

   

6. Enter a Product Name and save your changes.

   

7. Select Web Application.
   • Enter a Name.
   • In Authorized JavaScript origins, enter the URL to your X3 solution.
   • In Authorized redirect URLs, enter the redirection URL for the region in which your solution is hosted.
     • For solutions in North America, use https://na-oauth2.sagex3.com/api/Google/oauth2/redirect
     • For others, use https://eu-oauth2.sagex3.com/api/Google/oauth2/redirect
     • Note the use of “Google” in the path. It must match the name of the OAuth2 service in X3 exactly (case-sensitive).

   

8. Click Create.

   You will be given a client ID and a client secret.

   

Next steps

• Configuring OAuth2 in X3
• Using OAuth2 to Make a Web Service Call