> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/risk-management/posture/microsoft-app-posture.md).

# Microsoft app posture

Microsoft 365 tiles provide a snapshot of your organizational posture across all company departments using Microsoft 365 apps: OneDrive, SharePoint, Teams and Microsoft Entra ID. With DoControl's exposure analysis, you can focus on the main vulnerabilities and security risks in your organization.

The terminology used in Microsoft 365 tiles is specific to Microsoft.

## Overview

The Overview tile displays high-level metrics about Microsoft 365. It presents the total number of assets across all Microsoft 365 apps, internal and external users in Microsoft 365, as well as the total number of external domains that have access to assets in Microsoft 365.

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FKh36YFgYrcZVv8KeSyGt%2FMS%20posture%20overview.png?alt=media&amp;token=67e5e169-9e3a-443f-9488-b8cf8a6c0017" alt=""><figcaption><p>Microsoft 365 posture overview</p></figcaption></figure></div>

The Microsoft 365 posture overview displays these parameters:

<table><thead><tr><th width="225">Overview parameter</th><th>Description</th></tr></thead><tbody><tr><td>Connected</td><td><p>Indicates if your Microsoft 365 apps are connected to DoControl:</p><ul><li>OneDrive</li><li>SharePoint</li><li>Teams</li><li>Microsoft Entra ID</li></ul><p>If an app is not indicated as connected, contact Customer Success.</p></td></tr><tr><td>Internal users</td><td>Number of users that belong to your organization and operate within the organization's domains.</td></tr><tr><td>External users</td><td>Number of users outside your organization with access to company assets, such as Microsoft 365 files.</td></tr><tr><td>External domains</td><td>Number of domains with external users who have access to assets in your organization.</td></tr><tr><td>Assets</td><td><p>Total number of Microsoft 365 assets, with distribution between </p><p>OneDrive, SharePoint, and Teams assets.</p></td></tr><tr><td>All apps</td><td><p>Select <strong>All apps</strong> to display posture data for all Microsoft 365 apps, or select a specific app to display posture data only for that app:</p><ul><li>OneDrive</li><li>SharePoint</li><li>Teams</li></ul></td></tr></tbody></table>

## Asset exposure

This data shows how and where your organization's assets are exposed according to Microsoft 365 sharing statuses. Exposed assets are risky, since unintended people can access your company's sensitive data, leading to data exfiltration, compliance issues, and reputational damage.

{% hint style="info" %}
The metrics reflect the total number of **data exposures**, not the number of assets. The same asset can be exposed more than once. For the total number of assets, see [Assets](#overview) in the mini-dashboard.
{% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FzV1PT58wvu9SmRCNUzB6%2FMS%20posture%20asset%20exposure.png?alt=media&amp;token=6047866b-bded-473b-a552-4297549ecf6e" alt=""><figcaption></figcaption></figure>

View the total number of public, external and internal exposures for your Microsoft apps. Asset exposure categories correspond to Microsoft 365 asset sharing statuses:

<table><thead><tr><th width="280">Exposure description</th><th width="257">Microsoft 365 sharing status</th><th>File permission</th></tr></thead><tbody><tr><td>Public assets open to the world</td><td>Public</td><td>Anyone with link</td></tr><tr><td>Assets shared with external collaborators</td><td>External</td><td>Specific people</td></tr><tr><td>Internally shared in org via link</td><td>Organization</td><td>People in your organization</td></tr></tbody></table>

{% hint style="success" %}
Click on each asset exposure category to open the [Assets](/docontrol-user-guide/saas-data-monitoring/inventory/inventory-assets.md) page for a specific Microsoft 365 app, already filtered by the selected category.
{% endhint %}

#### To remediate asset exposure:

1. Select the total number of exposed assets for a specific app (OneDrive, SharePoint or Teams), OR
2. Select the number of exposed assets for a specific app (OneDrive, SharePoint or Teams), and for a specific sharing status.
3. Filter and select the relevant assets.
4. Click **Remediate** and select the relevant inventory action:
   * [Remove public sharing](/docontrol-user-guide/workflows/inventory-actions-quick-actions/onedrive-inventory-actions.md#remove-public-sharing)
   * [Remove external collaborators](/docontrol-user-guide/workflows/inventory-actions-quick-actions/onedrive-inventory-actions.md#remove-all-external-collaborators)
   * [Remove organization link](/docontrol-user-guide/workflows/inventory-actions-quick-actions/onedrive-inventory-actions.md#remove-organization-link)

## Top exposed sites

Discover which sites have the most externally and publicly shared assets in your Microsoft 365 apps. The highest number of exposed sites is shown separately for OneDrive, SharePoint and Teams sites. This tile helps to direct attention to exposed areas in your organization.&#x20;

{% hint style="success" %}
Tip: In many cases, most external sharing is done from a small number of Microsoft sites.
{% endhint %}

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F6B4KhRXmSKxc4q6iIaMg%2FMS%20posture%20top%20exposed%20sites.png?alt=media&amp;token=127b59ee-dd87-4f3d-9672-0c7e47feb40e" alt=""><figcaption></figcaption></figure></div>

#### To remediate exposed sites:

1. Click an app site to open the relevant Microsoft 365 **Assets** page, filtered to display only externally and publicly shared assets for that specific site, OR
2. Click the **View all** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ff2uRypOQ53bfyiOH9FqL%2Fmenu%20button.png?alt=media&amp;token=427ed661-4e22-4590-a6aa-c9a7f30a6980" alt="" data-size="line"> icon to view all assets for a specific Microsoft 365 app:
   * VIew all OneDrive
   * View all SharePoint
   * View all Teams
3. Use the filters or select specific sites that are publicly or externally exposed.
4. Select specific OneDrive or SharePoint assets, and remediate with the [Remove public sharing](/docontrol-user-guide/workflows/inventory-actions-quick-actions/onedrive-inventory-actions.md#remove-public-sharing) or [Remove external collaborators](/docontrol-user-guide/workflows/inventory-actions-quick-actions/onedrive-inventory-actions.md#remove-all-external-collaborators) inventory action.

## Recent triggering events

This tile displays the number of workflows and alerts involving Microsoft 365 apps that were triggered by a specific actor over the last 30 days.

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FVpUjBq71UmqsEv4SYZ5v%2FMS%20posture%20triggered%20events.png?alt=media&amp;token=cfc803ce-4847-4a59-8ae2-9425a9d282e6" alt=""><figcaption></figcaption></figure></div>

#### To view recent triggering events:

1. Click the **Workflows** icon next to a specific actor's name.\
   The [workflows triggered](/docontrol-user-guide/saas-data-monitoring/events.md#triggered-entities) for this actor are displayed with the date and time when they were executed.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FzI8ltmJDS49VV6BR2MDb%2Ftriggered%20entities.png?alt=media&amp;token=1336dd74-b9f5-41d8-ab00-93dcaf8f9fbb" alt="" width="563"><figcaption></figcaption></figure></div>
2. Click the **Alerts** icon next to a specific actor's name.\
   The alerts triggered for this actor are displayed with the date and time when they were generated, and the alert severity.
3. Alternatively, click the **View all** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ff2uRypOQ53bfyiOH9FqL%2Fmenu%20button.png?alt=media&amp;token=427ed661-4e22-4590-a6aa-c9a7f30a6980" alt="" data-size="line"> icon to view all filtered [events](/docontrol-user-guide/saas-data-monitoring/events.md) for Microsoft 365 apps over the last 30 days.

## Alert status

The Alert status tile summarizes alert insights from anomalous activities, including the total number of active alerts (new or in-progress), and details of recent alerts for all Microsoft 365 apps. You can drill down into each alert parameter and investigate further.&#x20;

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F0noGiYV5BqtuzV1LaQI1%2FMS%20posture%20recent%20MS%20alerts.png?alt=media&amp;token=860d9ecc-5335-42d4-908d-0ce832433803" alt=""><figcaption></figcaption></figure>

DoControl displays these alert parameters in the posture page:

<table><thead><tr><th width="212">Alert parameter</th><th>Description</th></tr></thead><tbody><tr><td>Total active alerts</td><td>The number of active alerts (new or in-progress) with the increase or decrease compared to the last 30 days</td></tr><tr><td>Severity</td><td>The number of alerts according to severity level (high, medium, low)</td></tr><tr><td>Recent Microsoft 365 alerts</td><td>A list of alerts that was recently generated, including the severity level, specific app, date the alert was generated, and team member who's assigned to the alert</td></tr><tr><td>View all</td><td>Opens the Alert page filtered to display only alerts for Microsoft 365 apps: OneDrive, SharePoint, and Teams</td></tr></tbody></table>

## Remediation actions

This tile shows how many remediation actions were performed over the last 30 days per app for all your OneDrive, SharePoint, and Microsoft Entra ID assets.

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FmWpAkUeawm0qKrcLFqYU%2FMS%20posture%20remediation%20actions.png?alt=media&amp;token=f20740a4-7a78-4dd3-ae66-f26c7fa7a2a4" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Click **View all** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ff2uRypOQ53bfyiOH9FqL%2Fmenu%20button.png?alt=media&amp;token=427ed661-4e22-4590-a6aa-c9a7f30a6980" alt="" data-size="line"> to open the [Workflow list](/docontrol-user-guide/workflows/workflow-dashboard.md#workflow-list) displaying all **active** filtered workflows for Microsoft 365 apps: OneDrive, SharePoint, Teams, and Microsoft Entra ID.
{% endhint %}

You can perform these remediation actions on Microsoft 365 assets:&#x20;

<table><thead><tr><th width="258">Remediation action</th><th>Description</th></tr></thead><tbody><tr><td><a href="/docontrol-user-guide/workflows/define-workflow-settings/action-settings/remediate/onedrive-remediation.md#remove-collaborator">Remove collaborator </a></td><td>Remove sharing permission for a specific collaborator</td></tr><tr><td><a href="/docontrol-user-guide/workflows/define-workflow-settings/action-settings/remediate/onedrive-remediation.md#remove-sharing-links">Remove sharing links</a></td><td>Remove public or organization sharing links from a file</td></tr><tr><td><a href="/docontrol-user-guide/workflows/define-workflow-settings/action-settings/remediate/entra-id-remediation.md#remove-oauth-app">Remove OAuth app</a></td><td>Delete an OAuth app from Microsoft Entra ID</td></tr></tbody></table>

## Workflow activity

You can see the number of workflows involving Microsoft apps that have been triggered over the last 30 days. This helps to gain insights into potentially problematic user behavior.

Each graph represents the number of active workflows according to a specific status: Completed, In-progress, Warning and Failed.

&#x20;For full execution details, see the workflow's [execution details](/docontrol-user-guide/workflows/activity-dashboard.md).

{% hint style="success" %}
Click **View all** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ff2uRypOQ53bfyiOH9FqL%2Fmenu%20button.png?alt=media&amp;token=427ed661-4e22-4590-a6aa-c9a7f30a6980" alt="" data-size="line"> to open the [Workflow list](/docontrol-user-guide/workflows/workflow-dashboard.md#workflow-list) displaying all filtered workflows for Microsoft 365 apps: OneDrive, SharePoint, Teams, and Microsoft Entra ID.
{% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FrucQF47nC94GN2GqzhRW%2FMS%20posture%20workflow%20activity.png?alt=media&amp;token=7d8ee326-2cab-4b6a-b8c6-df992c849545" alt=""><figcaption></figcaption></figure>

## Top sites with shared organization links

Discover which Microsoft 365 sites have the highest number of exposed assets within your organization, according to specific app: OneDrive, SharePoint, and Teams.

These assets are internally shared, and indicated with the "People in your organization" sharing link.

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fnc4ID3KqDqtqFmG0HmHD%2FMS%20posture%20top%20sites%20with%20org%20links.png?alt=media&amp;token=3e98952f-f53b-4b8b-8b69-6c0561b10934" alt=""><figcaption></figcaption></figure></div>

#### To remediate sites with shared organization links:

1. Click an app site to open the relevant Microsoft 365 Assets page, filtered to display only assets shared within the organization for that specific site, OR
2. Click **View all** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ff2uRypOQ53bfyiOH9FqL%2Fmenu%20button.png?alt=media&amp;token=427ed661-4e22-4590-a6aa-c9a7f30a6980" alt="" data-size="line"> to view all assets shared for a specific Microsoft 365 app:
   * VIew all OneDrive
   * View all SharePoint
   * View all Teams\
     \
     The Assets page displays the specific app's assets sorted by the highest number of **organization** assets.
3. Select specific OneDrive or SharePoint assets, and remediate with the [Remove organization link ](/docontrol-user-guide/workflows/inventory-actions-quick-actions/sharepoint-inventory-actions.md#remove-organization-link)inventory action.

## Top exposed external users

You can discover which users outside your organization have the most access to data in your organization.

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ful0ti4pMGRkafWjbbGtD%2FMS%20posture%20top%20exposed%20external%20users.png?alt=media&amp;token=606fbf7c-fef9-4bca-94ed-9e954f9b1de9" alt=""><figcaption></figcaption></figure></div>

#### To remediate exposed external users:

1. Click an external user to view all assets externally shared with the user in a specific Microsoft 365 app, OR
2. Click **View all** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ff2uRypOQ53bfyiOH9FqL%2Fmenu%20button.png?alt=media&amp;token=427ed661-4e22-4590-a6aa-c9a7f30a6980" alt="" data-size="line"> to view the most exposed external users for a specific Microsoft 365 app:
   * VIew all OneDrive
   * View all SharePoint
   * View all Teams
3. Select specific OneDrive or SharePoint assets, and remediate with the [Remove all external collaborators](/docontrol-user-guide/workflows/inventory-actions-quick-actions/sharepoint-inventory-actions.md#remove-all-external-collaborators) inventory action.\
   These assets are externally shared, and indicated with the "Specific people" sharing link.

## Top exposed domains

You can discover which external domains have access to the highest number of assets in your organization.

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FVH9nQeCtxUsScUHufv4z%2FMS%20posture%20top%20exposed%20domains.png?alt=media&amp;token=0969388e-bc7f-4b06-8e23-c0b4ea8aa309" alt=""><figcaption></figcaption></figure></div>

#### To remediate exposed domains:

1. Click an external domain to view all external users with access to assets in a specific Microsoft 365 app.
2. Select specific OneDrive or SharePoint assets, and remediate with the [Remove all external collaborators](/docontrol-user-guide/workflows/inventory-actions-quick-actions/sharepoint-inventory-actions.md#remove-all-external-collaborators) or [Remove public sharing](/docontrol-user-guide/workflows/inventory-actions-quick-actions/sharepoint-inventory-actions.md#remove-public-sharing) inventory action.
3. Alternatively, click **View all** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Ff2uRypOQ53bfyiOH9FqL%2Fmenu%20button.png?alt=media&amp;token=427ed661-4e22-4590-a6aa-c9a7f30a6980" alt="" data-size="line"> to view all external domains that are sorted according to the highest number of total collaborations.

{% hint style="info" %}
Total collaborations is the number of external shares on all assets within a specific domain. For example:

* Asset A is shared with <admin@gmail.com> and <admin2@gmail.com>
* Asset B is shared with <admin@gmail.com> and <admin2@gmail.com>

The total number of collaborations is 4.
{% endhint %}

## Sites with encryption keys and certificates

Discover the number of encryption keys and certificates stored in Microsoft 365 sites. Leaving accessible files increases the risk of data exfiltration, since these keys can be potentially used to access sensitive data in your organization.&#x20;

<div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FmCc4VcfHdelfSgymeVEL%2FMS%20posture%20encryption%20keys.png?alt=media&amp;token=af807634-8490-447d-a59f-cf9ce6483b94" alt=""><figcaption></figcaption></figure></div>

#### To remediate the risk of insecure encryption keys:

1. Click the relevant Microsoft 365 site.\
   The site opens in Microsoft 365.
2. Move the assets to an appropriate location or remove them altogether from OneDrive or SharePoint.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/risk-management/posture/microsoft-app-posture.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
