# OX Security Alerts for Microsoft Teams

You can use the Microsoft Teams Bot Identity Provider connector to send OX notifications from an organization app, verified in [Azure Marketplace](https://marketplace.microsoft.com/en-us/product/office/WA200008847?tab=Overview), instead of from individual user identities.

This gives consistent sender identity (“OX Security”), allows org-wide rollout through Teams policies, and works from issues and workflows with deep links back to OX.

<figure><img src="/files/636QXZdwnl6Y71PldVIV" alt="" width="563"><figcaption></figcaption></figure>

### Prerequisites

* Microsoft Teams admin with permission to manage apps and policies in the Teams Admin Center.

### Step 1: Publish the OX Security app to your Teams tenant

1. Go to the **Teams Admin Center**.
2. Go to **Teams apps** > **Manage apps**.\
   Search for **OX Security** and open the app from the Azure Marketplace.

<figure><img src="/files/HeoI1n5VipZBPPtxwemz" alt="" width="563"><figcaption></figcaption></figure>

3. Set the app to **Allowed** for your organization, if required by your app permission policies.
4. Go to **Teams apps** > **Setup policies**.
5. Create a new **App setup policy** or edit an existing one; for example, edit the default policy **Global (Org-wide default)**.

<figure><img src="/files/ioovqTkhxTn39vKSuDyU" alt="" width="563"><figcaption></figcaption></figure>

6. In **Installed apps**, select the **OX Security Alerts** app.

<figure><img src="/files/sHqwk2kLH991ytoyeoEJ" alt="" width="281"><figcaption></figcaption></figure>

7. Select **Add**. This installs the app for everyone covered by the policy, which means all the users within the organization assigned to the policy.

### Step 2: Connect OX to the Bot Identity Provider

1. In OX, go to **Settings** > **Connectors**.
2. Select **Microsoft Teams**.

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

3. Choose **Bot Identity Provider** and select **Connect**.
4. Complete the Microsoft consent flow, then return to OX and confirm the connector shows **Connected**.

### Step 3: Send notifications from a workflow (optional)

1. In OX, go to **Settings** > [**Workflows**](/automate-with-ox-workflows/creating-a-workflow.md).
2. Create or edit a workflow and with a **Send Teams notification** action.

<figure><img src="/files/IyvGqJP4QB4ZL90bJ4nL" alt="" width="155"><figcaption></figcaption></figure>


---

# 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.ox.security/ticketing-and-messaging/messaging/microsoft-teams/microsoft-teams-bot-identity-provider.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.