> 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.md).

# External collaborator sharing

**SaaS security problem**

Files stored in SaaS applications retain their sharing permissions indefinitely. External collaborators, including third-party vendors, retain access to sensitive documents, and old sharing links remain active unless permissions are manually changed.&#x20;

Even IDP solutions cannot remove data access permissions from all SaaS files, meaning access to this information often remains long after it is needed. This is not only bad business practice, but it significantly increases the amount of sensitive data vulnerable to exfiltration by malicious actors.&#x20;

**DoControl solution**

DoControl allows you to limit external sharing by approaching SaaS data permissioning from a position of least privilege. You can remove access when assets are no longer needed by the parties with whom they were shared. This helps to minimize data overexposure, and mitigate the risk of data loss.

DoControl leverages these tools to automatically monitor, mitigate, and remediate the risks associated with external collaborator sharing across a variety of apps:

* [Inventory](#docontrol-inventory-of-external-collaborators)
* [Events](#events-with-external-collaborators)
* [Alerts](#alerts-for-external-collaborators)
* [Playbooks](#playbooks-for-external-collaborators)

## Who's an external collaborator?

External collaborators include external actors, such as partners, customers, services agencies, third-party vendors, and other parties not employed by your organization.

## What's the risk?

Sharing assets externally means they are now accessible to specific users outside of the organization. While that might be OK in some cases, you need to be careful that internal or sensitive data is not exposed. Sharing a large number of assets externally in a short time span increases the risk of data overexposure and potential data loss.

## Inventory of external collaborators

DoControl's rich inventory exposes external collaborators for assets, by indicting the sharing status for each asset (internal or external). From the Assets page, you can:

* Filter assets per app for external collaborators
* Remediate assets using[ inventory actions](/docontrol-user-guide/workflows/inventory-actions-quick-actions.md), such as removing external collaborators

The External sharing status varies slightly across different SaaS apps:

<table><thead><tr><th width="286">External sharing in SaaS app</th><th>Description</th></tr></thead><tbody><tr><td>Box</td><td>Asset is shared outside the organization.</td></tr><tr><td>Google Drive</td><td>Specific internal or external users with the link can access the asset, after authentication.</td></tr><tr><td>SharePoint, OneDrive, Teams</td><td>Anyone with the link can access the asset, after authentication.</td></tr></tbody></table>

{% hint style="success" %}
DoControl indicates assets as **external** when they are shared with at least one external user. Based on data from Google API, DoControl can distinguish between internal and external users.&#x20;
{% endhint %}

Filters for externally shared assets vary according to app:

<table><thead><tr><th width="194">SaaS app</th><th>Filter for externally shared assets</th></tr></thead><tbody><tr><td>Box</td><td>Sharing status includes External</td></tr><tr><td>Google Drive</td><td>Sharing status includes External</td></tr><tr><td>OneDrive</td><td>Click the External assets <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FoNRhyH1iiY7UUgJPtv82%2Fexternal%20assets%20icon.png?alt=media&amp;token=b22b6049-3b1c-4d4d-b969-16fd3b128bab" alt="" data-size="line"> icon</td></tr><tr><td>SharePoint</td><td>Click the External assets <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FoNRhyH1iiY7UUgJPtv82%2Fexternal%20assets%20icon.png?alt=media&amp;token=b22b6049-3b1c-4d4d-b969-16fd3b128bab" alt="" data-size="line"> icon</td></tr><tr><td>Slack</td><td><ul><li>Files > External channels equals True</li><li>Channels > Shared externally equals Shared</li></ul></td></tr><tr><td>Teams</td><td>Click the External assets <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FoNRhyH1iiY7UUgJPtv82%2Fexternal%20assets%20icon.png?alt=media&amp;token=b22b6049-3b1c-4d4d-b969-16fd3b128bab" alt="" data-size="line"> icon</td></tr></tbody></table>

#### To filter and remediate assets that are shared externally:

1. In the Assets page, select the relevant SaaS app.
2. Filter for a **sharing status** that **includes** External, or any other external sharing filter.\
   For example: Filter for externally shared Google Drive assets within a specific department.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FlUfyyzMcWYjm2u1EPt9F%2Fimage.png?alt=media&amp;token=5c2a6a03-addc-410b-885f-f6441a6246af" alt=""><figcaption></figcaption></figure>
3. Select one of more assets.
4. Click **Remediate > Inventory** **actions**, and select the relevant inventory action:

   * Remove external collaborators
   * Remove all collaborators<br>

   The external collaborators are removed from the assets.

{% hint style="info" %}
For more uses cases of filtering for external collaborators in specific apps, see [Assets](/docontrol-user-guide/saas-data-monitoring/inventory/inventory-assets.md).
{% endhint %}

## Events with external collaborators

DoControl monitors real-time events of external sharing. In the Events page you can apply a quick filter to display all events where assets were shared with external collaborators in the last 7 days:

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F0YEdioCM5XaRmB2IQBOA%2Fexternal%20sharing%20events.png?alt=media&amp;token=ced84188-c7da-40e0-a319-00d582f5d136" alt=""><figcaption></figcaption></figure>

#### To filter events for external collaborators:

1. From the DoControl side menu, click **Events**.
2. Select the **External sharing** quick filter.

Each [event](/docontrol-user-guide/saas-data-monitoring/events.md) shows user and asset activity, the event type, and raw details in the JSON file.

## Alerts for external collaborators

DoControl alerts automatically notify your organization when anomalous user behavior occurs. External sharing alerts indicate that excess permission privileges were granted to external users outside your organization.

<table><thead><tr><th width="139">Alert type</th><th width="198">DoControl alert name</th><th>Alert description</th></tr></thead><tbody><tr><td>DC3</td><td>External sharing of sensitive files</td><td>This alert will trigger when an internal user externally shares potentially sensitive files.<br>A file is considered sensitive if its name includes one or more sensitive keywords, or a user-defined <a href="/docontrol-user-guide/system-management/settings/lexical-lists.md#default-lexical-lists">keyword</a> was detected in the file name.</td></tr></tbody></table>

{% hint style="info" %}
For details about DoControl alerts, go to **Help > DoControl Alert Specifications**.
{% endhint %}

### How to remediate alerts?

If you receive external sharing alerts, you can remove external sharing permissions from exposed assets by using the **Remove external collaborator** inventory action. It is also recommended to set up a workflow that will auto-expire sharing with external users and minimize risk over time.

{% hint style="info" %}
You can apply inventory actions to remove external collaborators from assets in these SaaS apps:

* [Box](/docontrol-user-guide/workflows/inventory-actions-quick-actions/box-inventory-actions.md)
* [Google Drive](/docontrol-user-guide/workflows/inventory-actions-quick-actions/google-drive-inventory-actions.md)
* [OneDrive](/docontrol-user-guide/workflows/inventory-actions-quick-actions/onedrive-inventory-actions.md)
* [SharePoint](/docontrol-user-guide/workflows/inventory-actions-quick-actions/sharepoint-inventory-actions.md)
  {% endhint %}

## Playbooks for external collaborators

To address the use cases of external collaborator sharing across various SaaS apps, you can define automated workflows with DoControl's out-of-the-box playbooks. These playbooks will:

* Notify your security team whenever an asset is shared with an external party (immediately or after a given time frame)
* Automatically remove external collaborators
* Automatically delete shared files that contain PII or sensitive information
* Notify when external users are added to internal Teams channels

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FZ6qnY3ZZsAlkwSuesPbn%2Fexternal%20collab%20playbooks.png?alt=media&amp;token=20a3ddb2-ce5e-4fd2-80df-9a7a7707a392" alt=""><figcaption><p>Select a predefined DoControl playbook to remediate external collaborator sharing</p></figcaption></figure>

{% hint style="info" %}
You can configure workflows that will auto-expire external sharing in specific SaaS apps. See the DoControl **demo videos** for [Google Drive ](https://youtu.be/x9ayyk05BjA)and [Box](https://youtu.be/TnJbsclIX_c) as a best practice to help minimize data overexposure, and mitigate the risk of data loss.
{% endhint %}

<table><thead><tr><th width="252" valign="top">Playbook name</th><th width="139.33333333333331" valign="top">SaaS app</th><th>Playbook description</th></tr></thead><tbody><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/box-playbooks-for-external-sharing.md">Auto-expire external sharing</a> </td><td valign="top">Box</td><td>When someone shares a file externally in Box, the actor is notified in Slack, and external collaborators are removed after 30 days.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/box-playbooks-for-external-sharing.md#remove-collaborators-on-demand">Remove collaborators on-demand</a></td><td valign="top">Box</td><td>When a user triggers a DoControl inventory action to remove collaborators from Box, external collaborators are automatically removed from the asset.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/dropbox-playbooks-for-external-sharing.md">Notify on external sharing</a></td><td valign="top">Dropbox</td><td>When someone shares externally in Dropbox, the security team is notified by Slack, Teams or webhook.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#auto-expire-external-sharing-with-private-accounts">Auto-expire external sharing with private accounts</a></td><td valign="top">Google Drive</td><td>When someone shares with private accounts in Google Drive, notify the actor by email, wait 30 minutes, and then remove external collaborators who have private email domains.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remediate-external-sharing-with-3rd-party-vendors">Remediate external sharing with 3rd party vendors</a></td><td valign="top">Google Drive</td><td>When someone shares a file externally in Google Drive with at least one collaborator who is not in a trusted domain, and collaborators with private email domains are added, the collaborators are removed, and the actor is notified in Slack.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#notify-when-non-admin-users-move-files-outside-the-organization">Notify when non-admin users move files outside the organization</a></td><td valign="top">Google Drive</td><td>When a non-admin user moves Google files to an external organization by changing the owner to an external user, the SecOps team is notified in Slack.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remediate-external-over-exposure-with-a-loop-function">Remediate external over-exposure with a loop function</a></td><td valign="top">Google Drive</td><td>When someone shares a file externally in Google Drive and approval is not given, external collaborators who are not in trusted domains are removed. If approval is given, a 60-day grace period will elapse until sending the approval request again.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remediate-external-sharing-of-pii">Remediate external sharing of PII</a></td><td valign="top">Google Drive</td><td>When someone shares a file externally in Google Drive, the file is scanned for PII labels:<br>- If the probability of containing PII is high, remove external collaborators who are not in trusted domains, and notify the actor by email<br>- If the probability of containing PII is medium, ask the actor to approve the external file sharing. If he doesn't approve, remove external collaborators who are not in a trusted domain.<br>- If the probability of containing PII is not medium, wait 30 days and ask the actor to approve. If the file sharing is not approved, remove any external collaborators who are not in trusted domains.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remediate-external-sharing-of-files-having-sensitive-google-labels">Remediate external sharing of files having sensitive Google labels</a></td><td valign="top">Google Drive</td><td>When someone shares files externally in Google Drive with a sensitive Google label, such as "Restricted,"  the external collaborators from non-trusted domains are automatically removed from the assets, and the actor is notified in Slack. If the SecOps team approves the file sharing, the external collaborators are not removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remediate-external-sharing-if-user-has-active-alerts">Remediate external sharing if user has active alerts</a></td><td valign="top">Google Drive</td><td>When someone shares files with external collaborators in Google Drive, check if the actor has any active alerts. If yes, remove external sharing permissions until the alerts are handled.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remediate-external-sharing-of-sensitive-content">Remediate external sharing of sensitive content</a></td><td valign="top">Google Drive</td><td>When someone shares an asset that contains sensitive content - data classifiers or regex patterns - externally in Google Drive, the actor is asked to approve the file sharing. If the sharing is not approved, the external collaborators are removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remediate-external-sharing-of-sensitive-regex-content">Remediate external sharing of sensitive Regex content</a></td><td valign="top">Google Drive</td><td>When someone shares an asset that contains a sensitive keyword externally in Google Drive, the security team is notified and external collaborators who are not in trusted domains are removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remove-collaborators-from-a-specific-domain-on-demand">Remove collaborators from a specific domain on-demand</a></td><td valign="top">Google Drive</td><td>When a user triggers an on-demand, aggregated inventory action to remove external collaborators, who belong to a specific domain, from Google Drive assets.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remove-external-collaborators-and-restore-after-approval">Remove external collaborators and restore after approval</a></td><td valign="top">Google Drive</td><td>When someone shares a Google Drive asset with a private email, the external user permissions are instantly removed from the asset. If the file sharing is approved, for example by the SecOps team or the actor's manager, then the external user permissions are automatically restored, and the actor is notified in Slack that the sharing was approved.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remove-external-collaborators-on-demand">Remove external collaborators on-demand</a></td><td valign="top">Google Drive</td><td>When a user triggers a DoControl inventory action to remove external collaborators from Google Drive, external collaborators are automatically removed from the asset.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remove-external-sharing">Remove external sharing</a></td><td valign="top">Google Drive</td><td>When someone shares a file externally in Google Drive, the actor is notified by email, and any external collaborators who are not in trusted domains are removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/onedrive-playbooks-for-external-sharing.md#remove-external-sharing">Remove external sharing</a></td><td valign="top">OneDrive</td><td>When someone shares externally in OneDrive, the security team is notified in Slack, and external collaborators not in trusted domains are removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/google-drive-playbooks-for-external-sharing.md#remove-internal-and-external-collaborators-on-demand">Remove internal and external collaborators on-demand</a></td><td valign="top">Google Drive</td><td>When a user triggers a DoControl inventory action to remove internal and external collaborators, all internal and external access permissions are automatically removed from selected My Drive assets. </td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/onedrive-playbooks-for-external-sharing.md#remove-sharing-on-demand">Remove sharing on-demand</a></td><td valign="top">OneDrive</td><td>When a user triggers a DoControl inventory action to remove sharing from OneDrive, external collaborators are automatically removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/onedrive-playbooks-for-external-sharing.md#notify-on-external-sharing">Notify on external sharing</a></td><td valign="top">OneDrive</td><td>When someone shares externally in OneDrive with someone not from a trusted domain, the security team is notified in Slack.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/sharepoint-playbooks-for-external-sharing.md#notify-on-external-sharing">Notify on external sharing</a></td><td valign="top">SharePoint</td><td>When someone shares externally in SharePoint with someone not from a trusted domain, the security team is notified in Slack.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/sharepoint-playbooks-for-external-sharing.md#remove-sharing-on-demand">Remove sharing on-demand</a></td><td valign="top">SharePoint</td><td>When a user triggers a DoControl inventory action to remove sharing from SharePoint, the external collaborators are automatically removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/sharepoint-playbooks-for-external-sharing.md#remove-external-sharing">Remove external sharing</a></td><td valign="top">SharePoint</td><td>When someone shares externally in SharePoint with someone not from a trusted domain, the security team is notified in Slack, and external collaborators are removed.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/slack-playbooks-for-external-sharing.md#auto-delete-files-in-externally-shared-channels">Auto-delete files in externally shared channels</a> </td><td valign="top">Slack</td><td>When someone uploads a file containing sensitive keywords to an external Slack channel, the security team and actor are notified, and the file is deleted.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/slack-playbooks-for-external-sharing.md#remediate-pii-sharing-in-external-channels">Remediate PII sharing in external channels</a></td><td valign="top">Slack</td><td>When someone shares a file with an external Slack channel and the file contains PII (personally identifiable information), the file is deleted.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/slack-enterprise-playbooks-for-external-sharing.md#remove-pii-from-slack-enterprise-shared-channels">Remove PII from Slack Enterprise shared channels</a></td><td valign="top">Slack Enterprise</td><td>When someone shares a message or file in a shared Slack Enterprise channel containing PII (personally identifiable information), the message and file are quarantined in near real-time for further analysis. If approved, the message and file are restored. If not approved, both the message and file are deleted.</td></tr><tr><td valign="top"><a href="/docontrol-user-guide/risk-management/threat-model-coverage/external-collaborator-sharing/teams-playbooks-for-external-sharing.md#notify-when-external-users-are-added-to-internal-teams-channels">Notify when external users are added to internal Teams channels</a></td><td valign="top">Teams</td><td>If an external user is added to an internal company channel, the Security Ops team is notified by both email and a Teams message.</td></tr></tbody></table>


---

# 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.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.
