# Microsoft Teams

In this guide, you will create the Microsoft Teams credentials needed to integrate Radiant Security with Microsoft Teams. This integration allows Radiant Security to communicate with our customer’s users, so that we can them send messages and receive responses.

For example, when Radiant Security detects a suspicious login that uses a VPN, a message is sent to the user to confirm whether that person really did it.

### Prerequisites

* [ ] You must be an administrator for Microsoft Teams to complete these steps

### Obtain the Directory (Tenant) ID

1. Navigate to the [Microsoft Entra ID](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview).
2. Copy the **Tenant** **ID**.

<figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FGGXG9vDHiRauQIN6G6HW%2FMicrosoft_Teams_01.webp?alt=media&#x26;token=666c2125-a94a-4966-a9b2-3d54ec03aa72" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important note:** Ensure that you save the **Tenant ID** as you will need to provide it to Radiant Security to complete the configuration.
{% endhint %}

### Add the credentials in Radiant Security

1. Log in to [Radiant Security](https://app.radiantsecurity.ai/).
2. From the navigation menu, select **Settings** > **Credentials** and click **+ Add Credential**.
3. Select the **Microsoft Teams** vendor from the list and click **Configure Credential.**
4. Under **Credential Name**, give the credential an identifiable name (e.g. `Teams Integration`).
5. Under **Required** **Credentials**, add the **Tenant ID** that you copied from the previous step.
6. Click **Add Credential** to save the changes.

### Create the app in Microsoft Teams

In this step, you will install the Radiant Security Teams application in Microsoft Teams.

1. Download the zip file from [this location](https://drive.google.com/drive/folders/1YmUXBs_XEShcsKiVRWWnOkxX8jcd1zpB), and store it in your local hard drive.
2. As an administrator, go to your [Teams application](http://admin.teams.microsoft.com/).
3. On the left sidebar, click **Teams** **Apps** and then click **Manage apps**.
4. Click **Actions**, then **Upload new app**, and then **Upload an app to your org’s app catalog**.
5. Upload the zip file that you downloaded in the first step. This will install the **Radiant Security** app in your organization’s app catalog.

### Push app to end users automatically

After installing the app for the organization, it must be added to each user's catalog. There are several ways in which your users can add the application and start receiving notifications. We outlined each of them below:

* [#recommended-option-modify-global-policy-for-all-users](#recommended-option-modify-global-policy-for-all-users "mention")
* [#create-a-new-policy-for-select-users](#create-a-new-policy-for-select-users "mention")
* [#request-users-manually-add-the-application](#request-users-manually-add-the-application "mention")

### Recommended option: Modify global policy for all users

This option will deliver the app to all users within your organization.

1. To modify an existing Setup Policy, visit the [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/).
2. From the left side navigation, go to **Teams Apps** > **Setup policies**.
3. Find and open the `Global (Org-wide default)` policy.
4. In the **Installed Apps** section, click on the **+ Add Apps** button.
5. Search for the **Radiant Security** application and click on the **Add** button.
6. Optionally, you can also add the application to the **Pinned Apps** section for the users to access the application easily.

   <figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FC18u8OsPNKIve4omXpLQ%2FMicrosoft_02.jpg?alt=media&#x26;token=516efda5-745e-4545-852f-ff1f9a20fddb" alt=""><figcaption></figcaption></figure>

### Create a new policy for select users

This option will deliver the app to a select group of users within your organization.

1. To create a Setup Policy:
   * Go to **Teams Apps** section > **Setup policies**.
   * Click on the **Add** button.
   * In the **Installed Apps** section, click on **Add apps** button.
   * Search for the **Radiant Security** application and click on the **Add** button.
   * Optionally, you can also add the application to the **Pinned Apps** section for the users to access the application easily.
   * Click on the **Save** button to create the policy.
2. Next, you must assign the policy to specific users or groups.

   * To assign to a user(s), select the policy and click **Manage Users > Assign users**. Search for the user and click **Apply.**

     <figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2F3sKHQZ7S63F0e6OJwHAn%2FMicrosoft_Teams_06.webp?alt=media&#x26;token=00f5660b-f38b-4d2c-aa36-c2f3b55cdc6d" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://help.radiantsecurity.ai/hs-fs/hubfs/Knowledge%20Base%20Articles/Microsoft%20Teams/Untitled%20(13).png?width=688&#x26;height=378&#x26;name=Untitled%20(13).png" alt=""><figcaption></figcaption></figure>

   * To assign to a group(s), click the **Group Policy assignment** tab and the **Add** button. Search for the group and the policy, and click **Apply.**

     <figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FoWCWVOJN6FwZdDG1CCj6%2FMicrosoft_Teams_07.webp?alt=media&#x26;token=426af591-4b63-401b-84c4-2420ba3939b2" alt=""><figcaption></figcaption></figure>

### Request users manually add the application

This option allows the end user to manually add the application. We do not recommend this as it is likely users will forget to install the application and fail to receive notifications from Radiant Security.

1. From the Microsoft Teams application, use the left-side navigation to go to **Apps**.
2. Click on **Built for your org**.
3. Here, they should see the Radiant Security application you installed previously. Click the **Add** button to install the app in their personal catalog.

<div align="left"><figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FdLfejGacpyZPTAqbTZ9l%2FMicrosoft_Teams_08.webp?alt=media&#x26;token=66f56c32-5299-4d5f-9b2f-8bd493869da2" alt="" width="375"><figcaption></figcaption></figure></div>
