OAuth2.0 is the most popular authorization type being used by apps. It notifies a resource server that the resource owner (user) is granting permission to a third-party app to access their account information. The resource server is assured of user’s identity through a third-party app, this is called Three Legged Communication. For more info about OAuth2.0, read our guide.
Note: When you create Integry app in your app, the callback URI for Integry for authentication is always: https://app.integry.io/auth/redirect
This article is a step-by-step guide on how to set up OAuth2.0 in Integry to connect to your app. When you set up your app, the first step is to create your app authorization. The authorization is created under the App Credentials tab in your app. Authorizations display all the authorization types configured with your app. By default, we create API-Key auth type, in case you want to create a different one you can delete it. So let’s walk through the entire authorization creation process.
Once you select the authorization type, a form will appear that will take the basic information associated with that particular type. In this case, you need to provide the following information
Client ID: The client ID of your app. This is later used to authenticate your app with other apps.
Client Secret: The client secret of your app.
Authorization URI: The URL where the authorization request will be sent by Integry or the third party app.
Configurations: Any information that needs to be added as parameters in the authorization URI. These parameters may vary from app to app. A common example is response_type. The field takes input as a valid JSON object as shown by the simple example below:
The parameters that need to be attached with the URI are mentioned in the documentation of the app.
Scopes: Permission scope of your app, multiple permissions to be separated by a comma or space or the way your app accepts it.
Token Endpoint: The endpoint that requests the access token and optionally a refresh token. To create a new token endpoint select Create a new endpoint option from the drop-down menu. Read, how to create a new token endpoint.
User Information Endpoint: The endpoint that returns the details of the logged in user. To create a new user information endpoint select Create a new endpoint option from the drop-down menu. Read, how to create a new user information endpoint.
Once all the fields are provided with the data required, your authorization is created. Click the Create Authorization button at the end. Yayy!!