Calling the Microsoft Graph REST API from Boost.space IntegratorPart of the Boost.space system, where you can create your connections and automate your processes.‘s HTTP > Make an OAuth 2.0 request requires you to:
Both the Azure portal and Boost.space Integrator require information to create a connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…).:
Values entered in Boost.space Integrator created or found in the Azure portal:
|
Value required in Boost.space Integrator |
Value as named in Azure portal UI |
|---|---|
|
Client ID |
Application ID |
|
Client secret |
Secret ID Value |
|
Authorize URI |
OAuth 2.0 authorization endpoint (v2) |
|
TokenA secure code used to authenticate and authorize access to API endpoints, enabling users to connect with third-party applications. URI |
OAuth 2.0 token endpoint (v2) |
Values entered in the Azure portal related to Boost.space Integrator:
|
Value required in the Azure portal |
Value to enter |
|---|---|
|
Redirect URI (Web) |
https://integrator.boost.space/oauth/cb/oauth2 |
To create your OAuth connection for Microsoft, complete these steps in the Azure portal:
When you create and register a web application in the Azure portal, Azure automatically creates your Client ID. This procedure only creates the web application. You still need to create your client secret and grant any required permissions.
-
Log in to your Azure portal account.
-
Under Manage Azure Active Directory, click View.
-
In the left sidebar, click App registrations, and then click New registration.
-
Enter a name for your application.
-
Under Redirect URI, click Web and enter the redirect URL:
https://integrator.boost.space/oauth/cb/oauth2 -
Click Register.
-
Save your Application (client) ID in a safe place. You need to enter in the module configuration on Boost.space Integrator.
![[Note]](https://docs.boost.space/wp-content/themes/bsdocs/docs-parser/HTML/css/image/note.png)
After registering your app, you can create a client secret in the Azure portal. Keep your client credentials in a safe place. If you lose your client secret, you can use this procedure to create a new one.
-
In the Azure AD B2C – App registrations page, click the application you created in the above procedure.
-
In the left sidebar, under Manage, click Certificates & secrets.
-
Click New client secret.
-
In the Description box, enter a description for the client secret.
-
Under Expires, select a duration for which the secret is valid, then click Add.
-
Your client secret appears in the Value field. Save your client secret in a safe place. Enter this client secret in the module configuration on Boost.space Integrator. You cannot retrieve this client secret once you leave this page.
After registering a web application and getting your OAuth credentials, you need to grant the required permissions.
-
Click App registrations.
-
Select the app you created in the above procedure and open its Overview page.
-
Under Manage, click API permissions.
-
Click + Add a permission.
-
Select the required Microsoft API.
-
Click Delegated permissions and use the search bar to find and select the permissions required by the app you are configuring.
-
Click Add permissions. The selected permissions now appear under Configured permissions.
-
Click Grant admin consent for {your Azure AD tenant name}.
-
A pop-up prompts you to confirm. Click Yes.
You can verify success by checking the Status column. A green checkmark appears with the text Granted for {your Azure AD tenant name}.
Boost.space Integrator‘s HTTP > Make an OAuth 2.0 request requires URIs to authorize your API calls and obtain a token. You can find these URIs in the Azure portal:
-
Click App registrations.
-
Select the app you created in the above procedure and open its Overview page.
-
Click Endpoints.
-
In the pop-up, use the Copy to clipboard button to copy and save or enter the following in the module configuration on Boost.space Integrator:
Value required in Boost.space Integrator
Value as named in Azure portal UI
Authorize URI
OAuth 2.0 authorization endpoint (v2)
Token URI
OAuth 2.0 token endpoint (v2)
-
In Boost.space Integrator dashboard, go to Create a new scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive..
-
Insert the HTTP > Make a OAuth 2.0 request module.
-
Open the module’s configuration and click Add next to the Connection field to create a new connection.
-
Click Show advanced settings.
-
Fill the connection setup as follows:
Flow type
Select Authorization Code.
Authorize URI
Enter the OAuth 2.0 authorization endpoint (v2) URI you found previously.
Token URI
Scope
Click + to add each permission you granted previously.
Check that:
-
All necessary permissions are listed.
-
Each permission is a separate item.
Scope separator
Select SPACE.
Client ID
Enter the Application ID from the app you created in the Azure portal.
Client Secret
Enter the client secret you created previously.
Authorize parameters
Enter the following keys and values:
Key
response_modeValue
queryKey
promptValue
consentRefresh token parameters
Enter the following key and value
Key
scopeValue
Enter all scopes you have in the Scopes field separated spaces.
Example:
offline_access opened profile User.ReadToken placement
Select In the header.
Header token name
Select Bearer.
-
-
Click Continue.
-
A window pops up. Review the permissions and click Accept.
The connection is successfully created. You can perform your API call.