# Teams

## Introduction 

Teams is a cloud-based collaboration platform that enables teams to communicate, collaborate, and share content in real-time. Teams provides a wide range of features and capabilities, including instant messaging, video and audio conferencing, file sharing and collaboration, project management, and integration with other Microsoft and third-party applications and services. This guide will walk you through the steps required to integrate Teams with Perimeters.

## Available Features

* Misconfiguration Rules
* User Inventory
* Identity Rules

## Prerequisites

* A Microsoft Teams Essentials subscription, or alternatively, Microsoft 365  Business Basic subscription or higher.
* A User Account with Team member and Owner Permissions along with Privileged Role Administrator, Global Reader and Teams Administrator Role, or alternatively, a Global Administrator Role.

## Required Privileges

| Scopes                                                                   | Use                                                                                            |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| Access Microsoft Teams and Skype for Business data as the signed in user | Read Access to Microsoft Teams Settings and Configurations.                                    |
| Read directory data                                                      | Read Access to Organization Information, Roles, Role Assignments and Third Party Applications. |
| Read the names and descriptions of teams                                 | Read Access to Organization Teams.                                                             |
| Read the members of teams                                                | Read Access to Organization Team Members.                                                      |
| Read all users' full profiles                                            | Read Access to Users' Detailed Profiles.                                                       |
| Read and query your audit log activities                                 | Read Access to Organization Audit Logs                                                         |
| Read Reports                                                             | Read Reports                                                                                   |

#### Note: Perimeters utilizes Microsoft Graph APIs and Microsoft Teams Module for deep integration; therefore, Perimeters requests two types of OAuth tokens for both services.

## Onboarding Teams in your Perimeters account

1. Go to "Integrations" -> Select "Microsoft Teams" -> Click "+ Add" -> Click "+ Start Integration".
2. **“Step 1: OAuth” -** \
   Click "Sign in with Microsoft Teams" to give Perimeters access to your Organization's (Microsoft Teams) Inventory.
3. **"Step 2: OAuth" -**\
   Click "Sign in with Microsoft Teams" to give Perimeters access to your Microsoft Teams Settings.
4. Click **"Finish"** to complete the onboarding process.

Once you have completed these steps, Teams should be successfully integrated with your Perimeters account.


---

# 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://support.perimeters.io/perimeters-documentation/connecting-perimeters/integrations-for-security-insights/saas-applications/teams.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.