# Microsoft Apps

## Prerequisites

<details>

<summary>Permissions required for registering and configuring an app in Microsoft Entra ID.</summary>

The account must have permission to manage applications in Microsoft Entra ID. Ideally the account should be in the Global Admin role to grant admin consent.

</details>

## Create an enterprise application for Coherent Spark

Since Coherent Spark uses the Service Provider-Initiated (SP-Initiated) Flow (reference [Federation](/identity-and-access-management/federation.md)), you must create an Enterprise Application in Microsoft 365 to enable user access to Spark.

This guide explains how to add a link to Coherent Spark in Microsoft 365 apps (<https://www.microsoft365.com/apps>), My Apps (<https://myapps.microsoft.com/>), and across the entire Microsoft 365 environment. This ensures that users can seamlessly access the external Spark application without needing to search for or remember its URL.

1. Go to Microsoft Entra ID at <https://entra.microsoft.com/#home.>
2. In the left menu, select Enterprise Applications under the Applications section.
3. Click **+ New Application**.
4. Click **Create your own application**.
5. Enter a name (e.g. `Coherent Spark`). &#x20;
6. Select *Integrate any other application you don’t find in the gallery (Non-gallery)* and click **Create**.
7. Once created, go to the *Single Sign-On* section.
8. Choose *Linked* as the SSO method. &#x20;
9. Enter your Spark URL in the format `https://spark.{environment}.coherent.global/{tenant}` into the *Sign on URL* field.
10. Click **Save**.
11. On the left pane, click *Users and Groups*.
12. Click **+ Add User/Group**.
13. Select the *Users or Groups* who should see the link.
14. Click **Assign**.

&#x20;Now, assigned users visiting Microsoft 365 or My Apps will see the external link to their Spark App.

## Pin the external Coherent app to the Microsoft 365 sidebar

Users can also pin the app for quick access in Microsoft 365 sidebar.

1. Navigate to <https://www.microsoft365.com/apps.>
2. Click on *All Apps*.
3. Scroll down to *Other Apps*.
4. Find your Spark App.
5. Click on the three-dot menu and select **Pin**.

&#x20;Your app will now appear on the Microsoft 365 sidebar for quick access.


---

# 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://docs.coherent.global/identity-and-access-management/single-sign-on/microsoft-apps.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.