Calling the Microsoft Graph REST API from Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More‘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…). More:
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) |
|
TokenThe API token is a multi-digit code that allows a user to authenticate with cloud applications. More 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 moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More 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.
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. More.
-
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 itemItems are rows in records (order/request/invoice/purchase...).
Scope separator
Select SPACESubunits are created within modules to maintain organization and clarity, even with large amounts of data. More.
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
Token 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.