> For the complete documentation index, see [llms.txt](https://imbrace.gitbook.io/imbrace-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://imbrace.gitbook.io/imbrace-documentation/integrations/microsoft.md).

# 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.
