> 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/public-sharing.md).

# Public sharing

**SaaS security problem**

Sharing company assets publicly means they are accessible to anyone on the web.&#x20;

When employees create new documents in SaaS apps such as Google Drive or Dropbox, they often set permissions to “anyone with a link” so everyone can view, edit or share. This is a convenient option for group collaboration since employees might not want to continually get notifications to approve documents. But it means that company assets are now accessible to anyone on the web. Publicly shared links can easily become overexposed entry points to sensitive data.&#x20;

When these links are shared in publicly accessible locations, such as public Slack channels accessible to all employees, the risk of data breaches and unauthorized access increases. Public sharing often leaves documents exposed, and can cause significant damage if these documents reach someone with malicious intent.&#x20;

{% hint style="info" %}
**Did you know?**\
DoControl’s annual SaaS Security Threat Landscape 2023 report audited the number of assets publicly shared across a subset of companies:

* In **medium** companies, an average of **6,516** assets stored in SaaS apps are shared publicly&#x20;
* In **large** companies, an average of **94,455** assets stored in SaaS apps are shared publicly

**Medium-sized** companies = 50 to 1,000 employees, and **large enterprises** = 1,001 to 6,700 employees
{% endhint %}

**DoControl solution**

DoControl allows you to limit public sharing by approaching SaaS data permissioning from a position of least privilege. You can auto-expire public sharing links to ensure they won’t be found and used by unauthorized personnel. 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 public sharing across a variety of apps:

* [Inventory](#inventory-of-publicly-shared-assets)
* [Events](#events-with-public-sharing)
* [Alerts](#alerts-for-public-sharing)
* [Playbooks](#playbooks-for-public-sharing)

## What's the risk?

Sharing assets publicly means they are now accessible to anyone on the web, outside of the organization. While that might be OK in some cases, you need to be vigilant that internal or sensitive data is not exposed.&#x20;

Sharing a large number of assets publicly over a short time span aggravates the risk of data breaches and unauthorized access. Public sharing can cause significant damage if exposed documents reach someone with malicious intent.&#x20;

## Inventory of publicly shared assets

DoControl's rich inventory exposes publicly shared assets. From the Assets page, you can:

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

The filters for publicly shared assets vary according to app:

<table><thead><tr><th width="194">SaaS app</th><th>Filter for publicly shared assets</th></tr></thead><tbody><tr><td>Box</td><td>Sharing status includes People with the link</td></tr><tr><td>Dropbox</td><td>Sharing status includes Public</td></tr><tr><td>GitHub</td><td>Visibility includes Public, Public template</td></tr><tr><td>Google Drive</td><td>Sharing status includes Public</td></tr><tr><td>OneDrive</td><td>Sharing status includes Public</td></tr><tr><td>Salesforce</td><td>Sharing privacy includes Visible</td></tr><tr><td>SharePoint</td><td>Click the Public assets <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FkF8Z6ejSH3CINXulxFhA%2Fpublic%20assets%20icon.png?alt=media&amp;token=89a2c058-3cc4-4b8c-bab6-0417befb3236" alt="" data-size="line"> icon</td></tr><tr><td>Slack</td><td>Channels > Channel type includes Public</td></tr><tr><td>Teams</td><td>Click the Public assets <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FkF8Z6ejSH3CINXulxFhA%2Fpublic%20assets%20icon.png?alt=media&amp;token=89a2c058-3cc4-4b8c-bab6-0417befb3236" alt="" data-size="line"> icon</td></tr><tr><td>Zoom</td><td>Sharing status includes Public</td></tr></tbody></table>

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

1. In the Assets page, select the relevant SaaS app.
2. Filter for a **sharing status** that **includes** Public, or any other filter for publicly shared assets. \
   For example: Filter for publicly shared OneDrive assets.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FkdiJDSBG5gbcRC60gu43%2Fpublic%20share%20OneDrive.png?alt=media&amp;token=dbbe97ac-1c70-48fe-a993-b6a47e15f0dd" alt=""><figcaption></figcaption></figure>
3. Select one of more assets.
4. Click the **Remediate > Inventory actions > Remove public sharing**.&#x20;
5. From the dropdown list, select the relevant workflow. If you don't have one, [create a workflow](/docontrol-user-guide/workflows/create-a-workflow.md) based on the relevant playbook.
6. Click **Trigger workflow**. After confirmation, sharing status of the selected assets is removed.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F7DNouPavSUkO5gi3p5IQ%2Fremove%20public.png?alt=media&amp;token=4ba6716b-9a67-46e5-b308-31d6a096aa3f" alt=""><figcaption></figcaption></figure>

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

## Events with public sharing

DoControl monitors real-time events of public sharing. In the Events page you can apply a quick filter to display all events where assets were publicly shared 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%2F4aHjKHkaEhplPzDlGb5Y%2Fpublic%20share%20events.png?alt=media&amp;token=3439f824-fc79-4c52-9652-58abb984d1c7" alt=""><figcaption></figcaption></figure>

#### To filter events for public sharing:

1. From the DoControl side menu, click **Events**.
2. Select the **Public sharing** quick filter.\
   \
   ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FqSZiKgvLa9LAJUXLf6tw%2FEvent%20quick%20filters.png?alt=media\&token=582cb6ff-2a4d-4c0e-9dfd-df9c03c76f23)

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 public sharing

DoControl alerts automatically notify your organization when anomalous user behavior occurs. Public sharing alerts indicate that company assets were publicly shared; for example, a Google Drive asset was made public.

To mitigate the risk of exposed data as a result of public sharing, DoControl provides these alerts:

<table><thead><tr><th width="131.33333333333331">Alert type</th><th width="249">DoControl alert name</th><th>Alert description</th></tr></thead><tbody><tr><td>DC5</td><td>Extensive public burst sharing</td><td>This alert will trigger when an internal user publicly shares an anomalous number of assets or assets with a higher than average name sensitivity over a short timespan.</td></tr><tr><td>DC6</td><td>Public sharing of sensitive files</td><td>This alert will trigger when an internal user publicly shares potentially sensitive files. 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><tr><td>DC11</td><td>External user publicly shared</td><td>This alert will trigger when an external user shares assets publicly.</td></tr><tr><td>DC105</td><td>Unprotected sensitive cloud recording is public</td><td>This alert will trigger when an internal user has completed a cloud recording in Zoom that contains potentially sensitive files, is not passcode protected, and can be publicly shared. A recording 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 recording 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 your organization receives alerts notifying you of public sharing, you can delete the relevant sharing link on-demand using the **Remove public sharing** inventory action.&#x20;

You can also set up a workflow that will remove public sharing links whenever a file is uploaded to a public channel (immediately or after a given time frame).&#x20;

When you remove the sharing link, you change publicly shared assets to assets that can only be shared with collaborators (internal or external users). Asset owners will still have access.

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

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

## Playbooks for public sharing

To address the use cases of public 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 publicly (immediately or after a given time frame), or when a GitHub repository is made public
* Automatically remove public sharing links, including from files with a sensitive Google label
* Automatically delete shared files that contain PII or sensitive information
* Prevent publishing a Google Drive file to the web
* Prevent public sharing of sensitive files via private Teams chat

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F8y6AhMEoyklsUYsrTdw8%2Fpublic%20sharing%20PBs.png?alt=media&amp;token=56ab951f-6cfb-46b6-8069-b749c866e6b6" alt=""><figcaption><p>Select a predefined DoControl playbook to remediate public sharing</p></figcaption></figure>

<table><thead><tr><th width="264">Playbook name</th><th width="145.33333333333331">SaaS app</th><th>Playbook description</th></tr></thead><tbody><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/box-playbooks-for-public-sharing.md">Auto-expire public sharing</a></td><td>Box</td><td>When someone shares a file publicly in Box, the shared links are automatically removed after a defined waiting period.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/box-playbooks-for-public-sharing.md#remove-shared-links-on-demand">Remove shared links on-demand</a></td><td>Box</td><td>When a user triggers a DoControl inventory action to remove a shared link in Box, the link is automatically removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/dropbox-playbooks-for-public-sharing.md#change-visibility-of-shared-link">Change visibility of shared link</a></td><td>Dropbox</td><td>When someone changes the shared link visibility for a Dropbox asset, you can automatically notify the Security team and remove shared links.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/dropbox-playbooks-for-public-sharing.md#notify-on-public-sharing">Notify on public file sharing</a></td><td>Dropbox</td><td>When someone creates a public link for a Dropbox asset, you can automatically notify the Security team.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/dropbox-playbooks-for-public-sharing.md#remove-publicly-shared-link-upon-creation">Remove publicly shared link upon creation</a></td><td>Dropbox</td><td>When someone creates a publicly shared link for a Dropbox asset, you can automatically notify the Security team and remove the shared links.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/dropbox-playbooks-for-public-sharing.md#notify-on-changing-a-shared-link-to-public">Notify on changing a shared link to public</a></td><td>Dropbox</td><td>When someone changes the sharing link visibility to public for a Dropbox asset, you can automatically notify the Security team.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/github-playbooks-for-public-sharing.md">Notify on publicizing a repository</a></td><td>GitHub</td><td>When someone makes a GitHub repository public, you can automatically notify the Security team.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#remediate-public-over-exposure-with-a-loop-function">Remediate public over-exposure with a loop function</a></td><td>Google Drive</td><td>When someone shares a file publicly in Google Drive and approval is not given, the public sharing link is automatically removed from the asset. If approval is given, a 30-day grace period will elapse until sending the approval request again.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#remove-public-sharing-of-files-with-sensitive-google-labels">Remove public sharing of files with sensitive Google labels</a></td><td>Google Drive</td><td>When someone shares files publicly in Google Drive with a sensitive Google label, such as "Restricted,"  the public sharing links are automatically removed from the assets, and the actor is notified in Slack. If the SecOps team approves the file sharing, the public sharing links are not removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#remediate-public-sharing-of-pii">Remediate public sharing of PII</a></td><td>Google Drive</td><td><p></p><p>When someone publicly shares a sensitive file in Google Drive, the file is scanned for PII labels:</p><ul><li>If the probability of containing PII is <strong>high</strong>, any publicly shared links are removed, and the actor is notified by email.</li><li>If the probability of containing PII is <strong>medium</strong>, an approval request is sent to the actor to approve the public file sharing. If he doesn't approve, publicly shared links are removed.</li><li>If the probability of containing PII is <strong>not medium</strong>, 30 days must pass before asking the actor to approve the public file sharing. If he doesn't approve, publicly shared links are removed.</li></ul></td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#remove-public-sharing">Remove public sharing</a></td><td>Google Drive</td><td>When someone publicly shares a file in Google Drive, the actor is notified by email, and any publicly shared links are automatically removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#remove-public-sharing-link-on-demand">Remove public sharing link on-demand</a></td><td>Google Drive</td><td>When a user triggers a DoControl inventory action to remove a publicly shared link in Google Drive, the link is automatically removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#auto-expire-public-sharing">Auto-expire public sharing</a></td><td>Google Drive</td><td>When someone publicly shares a file in Google Drive, the actor is notified by email. After a 30-day grace period, any publicly shared links are removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#remove-public-sharing-of-sensitive-files">Remove public sharing of sensitive files</a></td><td>Google Drive</td><td>When an alert is triggered for publicly sharing sensitive files in Google Drive, any publicly shared links are removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/google-drive-playbooks-for-public-sharing.md#notify-and-remediate-publishing-a-file-to-the-web">Notify and remediate publishing a file to the web</a></td><td>Google Drive</td><td>When someone publishes a Google Drive file to the web, you can remove the URL of the file so it's no longer public or searchable on the web. </td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/onedrive-playbooks-for-public-sharing.md#notify-on-public-file-sharing">Notify on public file sharing</a></td><td>OneDrive</td><td>When someone from a specific group shares a file publicly in OneDrive, the security team is notified in Slack.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/onedrive-playbooks-for-public-sharing.md#remove-public-link-on-demand">Remove public link on-demand</a></td><td>OneDrive</td><td>When a user triggers a DoControl inventory action to remove a public link in OneDrive, the link is automatically removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/sharepoint-playbooks-for-public-sharing.md#notify-on-public-sharing">Notify on public sharing</a></td><td>SharePoint</td><td>When someone from a specific group shares a file publicly in SharePoint, the security team is notified in Slack.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/sharepoint-playbooks-for-public-sharing.md#remove-public-sharing-on-demand">Remove public sharing on-demand</a></td><td>SharePoint</td><td>When a user triggers a DoControl inventory action to remove a public link in SharePoint, the link is automatically removed.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/sharepoint-playbooks-for-public-sharing.md#notify-and-remediate-public-sharing-of-sensitive-pii">Notify and remediate public sharing of sensitive PII</a></td><td>SharePoint</td><td>When someone publicly shares a file in SharePoint, the file is scanned for PII labels. If PII labels are found, the relevant manager or security team is notified by email and webhook, and the public links are removed from the file.</td></tr><tr><td><a href="/docontrol-user-guide/risk-management/threat-model-coverage/public-sharing/slack-playbooks-for-public-sharing.md#notify-on-public-file-sharing">Notify on public file sharing</a></td><td>Slack</td><td>When someone from a specific group shares a file publicly in a Slack channel, the security team is notified in Slack.</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/public-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.
