# Microsoft

Microsoft provides a standardized way to access their APIs through Microsoft Azure. This can be done using **OAuth**. Once configured, you can use your credentials to authenticate the following nodes:

## Microsoft compatible nodes

| Node                     | OAuth                                 |
| ------------------------ | ------------------------------------- |
| Microsoft Dynamics CRM   | <mark style="color:green;">Yes</mark> |
| Microsoft Excel          | <mark style="color:green;">Yes</mark> |
| Microsoft Graph Security | <mark style="color:green;">Yes</mark> |
| Microsoft OneDrive       | <mark style="color:green;">Yes</mark> |
| Microsoft Outlook        | <mark style="color:green;">Yes</mark> |
| Microsoft Teams          | <mark style="color:green;">Yes</mark> |
| Microsoft To Do          | <mark style="color:green;">Yes</mark> |

## Account integration using OAuth

To begin, you will need:

* An [Microsoft Azure](https://azure.microsoft.com/) account.

**STEP 1:** Access the [Microsoft Application Registration Portal](https://aka.ms/appregistrations).

**STEP 2:** Click on the **\[Register an application]** button.

<figure><img src="/files/cQf7fqrjBFvuaGmhvr6F" alt=""><figcaption></figcaption></figure>

**STEP 3:** Enter a name for your app in the **Name** field.

<figure><img src="/files/CiExJBMt5ReLkJcYoVps" alt=""><figcaption></figcaption></figure>

**STEP 4:** Select **Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (eg. Skype, Xbox)** under the **Supported account types** section.

<figure><img src="/files/xW9sals9YQP4zlHvGQO6" alt=""><figcaption></figcaption></figure>

**STEP 5:** In iMBrace, copy the **OAuth Callback URL** provided in the Microsoft node credentials.

<figure><img src="/files/ksx712A5UkzqknHUOMpG" alt=""><figcaption></figcaption></figure>

**STEP 6:** Paste it in the **Redirect URI (optional)** field on the **Register an application** page.

<figure><img src="/files/hRQyXHEUWkrutxIfaG5Y" alt=""><figcaption></figcaption></figure>

**STEP 7:** Click on the **\[Register]** button.

<figure><img src="/files/ewXF1ROLdJfyRj36YZEh" alt=""><figcaption></figcaption></figure>

**STEP 8:** Copy the **Application (client) ID**.

<figure><img src="/files/YWR8UJanyt4Aw0DfJj90" alt=""><figcaption></figcaption></figure>

**STEP 9:** In iMBrace, enter the name for your credentials in the **Credentials Name** field in the Microsoft node credentials (In this case, Microsoft Outlook).

**STEP 10:** In iMBrac&#x65;**,** paste the Application ID in the **Client ID** field in the Microsoft node credentials.

<figure><img src="/files/WjlhP64od1FXJyCVx49U" alt=""><figcaption></figcaption></figure>

**STEP 11:** On your Microsoft application page, click on **\[Certificates & secrets]** in the left sidebar.

<figure><img src="/files/RgQSYJC0c6b3O70ELLU3" alt=""><figcaption></figcaption></figure>

**STEP 12:** Click on the **\[+ New client secret]** button under the **Client secrets** section.

<figure><img src="/files/jeKkJQAXuBKskEG7wdsY" alt=""><figcaption></figcaption></figure>

**STEP 13:** Enter a description in the **Description** field.

<figure><img src="/files/0utEv8SJmSVpiODhxLaz" alt=""><figcaption></figcaption></figure>

**STEP 14:** Click on the **\[Add]** button.

**STEP 15:** Copy the displayed secret under the **Value** column.

<figure><img src="/files/lYOdZUIJSKqzfNR1IstA" alt=""><figcaption></figcaption></figure>

**STEP 16:** In iMBrace, paste the secret in the **Client Secret** field in the Microsoft node credentials.

<figure><img src="/files/IvnPpxvA9jT6JWxl8rBb" alt=""><figcaption></figcaption></figure>

**STEP 17:** Click on the **\[Connect]** button in the OAuth section to connect a Microsoft account to iMBrace.

**STEP 18:** Login to your Microsoft account and allow the app to access your info.

**STEP 19:** In iMBrac&#x65;**,** click on the **\[Save]** button in the Microsoft node credentials to save your credentials.

**DONE:** The credential can then be used for Microsoft nodes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://imbrace.gitbook.io/imbrace-documentation/integrations/microsoft.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
