> 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/integrations/onedrive.md).

# OneDrive

OneDrive enables users to share and collaborate on documents across an organization. The cloud storage platform grants users within your organization significant storage space, while allowing users to access files from any device. Organization-level sharing settings are managed via Microsoft SharePoint.

## Use cases

Integrating DoControl with OneDrive enables you to detect and prevent unnecessary exposure and address these use cases:

* **Get full inventory visibility -** Discover your data exposure for all assets, internal and external users, permissions, external domains and exposed sites in a single view, including:
  * Name and URL of asset
  * Sharing status of asset (public, external, organization, internal)
  * Type of link used to share asset, expiration date of link
  * User data (email, role, collaborators)
  * If asset is password-protected
  * Triggered events related to asset
* **Trigger alerts based on file overexposure** - Get real-time event notifications for anomalous activity, such as external or public sharing of sensitive files, 4th party sharing, extensive file downloads, former employees downloading or sharing assets, sharing assets with or by a malicious domain
* **Remediate past exposure** - Leverage on-demand bulk remediation to remove public and organization sharing links, remove external collaborators
* **Remediate future data exposure** - Leverage automated workflows to prevent future exposure with these remediation actions in OneDrive:

  * [Remove a collaborator](/docontrol-user-guide/workflows/define-workflow-settings/action-settings/remediate/onedrive-remediation.md#remove-collaborator) - You can remove collaborator access from a OneDrive file for one or more collaborators. When an asset exists in a parent folder, collaborator access is removed from all assets in the folder.&#x20;
  * [Remove sharing links](/docontrol-user-guide/workflows/define-workflow-settings/action-settings/remediate/onedrive-remediation.md#remove-sharing-links) - You can remove public or organization sharing links from an asset in OneDrive.

  In addition, you can leverage workflows to prevent ethical wall violations, prevent sharing with private and personal email accounts, revoke 4th party sharing, and notify on ransomware and encryption key uploads.&#x20;

## Prerequisites&#x20;

To integrate OneDrive with DoControl, make sure you have fulfilled these prerequisites:

* OneDrive is a Business Basic Plan.
* You have [Microsoft 365](/docontrol-user-guide/integrations/microsoft-365.md) required permissions.
* The integrator must be one of the following:
  * [ ] Global Administrator
  * [ ] Privileged Role Administrator
* Before starting to integrate, you need to sign up with DoControl. Follow the onboarding steps in [Create first account](/docontrol-user-guide/getting-started/quick-start/set-up-docontrol-basics.md#create-first-account).
* You must activate the Microsoft 365 audit log. After turning on the audit log, it may take up to 12 hours for this action to take effect.<br>

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>See <a href="https://docs.microsoft.com/en-us/microsoft-365/compliance/turn-audit-log-search-on-or-off?view=o365-worldwide">Microsoft online help</a> to turn on the Audit log. </p></div>

## Integrate OneDrive with DoControl

![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FQpVtYcqkL1rLJdLilZhq%2Fimage.png?alt=media\&token=5ee1c9a2-8893-4074-a0a5-ac9a62647c13)

1. From the DoControl side menu, click **Integrations**.
2. Under **OneDrive**, click **Connect**, then **Let's go.**
3. Select the **Write** scopes to enable remediation actions, and click **Next**.<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%2FHlo2eFvUafP1OWIVR75f%2FConnect%20to%20OneDrive.png?alt=media&amp;token=6957352c-b2b4-43b1-a3d6-3d3223110ce6" alt="" width="563"><figcaption></figcaption></figure></div>
4. Select your Microsoft account.
5. Enter your Microsoft admin credentials, then click **Allow**. \
   You are returned to the DoControl **Integrations** page, and OneDrive is now integrated.


---

# 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/integrations/onedrive.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.
