> 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/threat-model-coverage/external-collaborator-sharing/onedrive-playbooks-for-external-sharing.md).
# OneDrive playbooks for external sharing
To mitigate the risk associated with external sharing in OneDrive, you can define automated workflows for these use cases:
* [Notify on external sharing](#notify-on-external-sharing)
* [Remove external sharing](#remove-external-sharing)
* [Remove sharing on-demand](#remove-sharing-on-demand)
## Notify on external sharing
When someone shares externally in OneDrive with someone not from a trusted domain, the security team is notified in Slack.
1. In Workflows, select **Playbooks**.
2. Filter the playbooks according to the OneDrive app, and select the **Notify on external sharing** playbook.
3. Give an action name.
4. Under the **Added to secure link** event, define the relevant conditions:
* The `Get actor` condition is in a specific group
* The `Get target` condition is **not** in a trusted domain
5. Add any relevant conditions.
6. Customize the Slack message to send to the Security team, notifying them that an actor shared an asset with an external user not from a trusted domain.
## Remove external sharing
When someone shares externally in OneDrive, the security team is notified in Slack, and external collaborators not in trusted domains are removed.
{% hint style="info" %}
When an asset exists in a parent folder, collaborator access is removed from all assets in the folder.
{% endhint %}
1. In Workflows, select **Playbooks**.
2. Filter the playbooks according to the OneDrive app, and select the **Remove external sharing** playbook.
3. Give an action name.
4. Under the **Added to secure link** event, define the relevant conditions:
* The `Get actor` condition is **not** in a specific group
* The `Get target` condition is **not** in a trusted domain
5. Add any relevant conditions.
6. Customize the Slack message to send to the Security team.\
\
Any external collaborators are removed.
## Remove sharing on-demand
You can trigger an inventory action to remove sharing from OneDrive assets on-demand.
{% hint style="success" %}
You can customize [inventory actions](/docontrol-user-guide/workflows/inventory-actions-quick-actions.md) to meet your organization's requirements. When you trigger the inventory action, select the relevant workflow you created.
{% endhint %}
1. In Workflows, select **Playbooks**.
2. Filter the playbooks according to External sharing, and select the **Remove sharing on-demand** playbook for OneDrive.
3. Add any actions, such as **Notify by email** or **Notify in Slack**.
4. Save the workflow with a new name.
5. When you trigger the inventory action, select the relevant workflow you created.
---
# 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/threat-model-coverage/external-collaborator-sharing/onedrive-playbooks-for-external-sharing.md?ask=&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.
