> 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/saas-data-monitoring/inventory/inventory-assets.md).

# Assets

In a single pane of glass, DoControl provides a consolidated view of data access exposure across all your SaaS applications. For each integrated SaaS app, assets are displayed according to the native SaaS content structure.

The Assets page gives you insight into the exposure for each asset (what is shared, and with whom). DoControl enables you to manage your assets in various ways:

* Filter assets according to app-specific options.&#x20;
* View detailed information about a [specific asset](#asset-details), including [sharing status](#sharing-status) (for example, shared internally or externally)
* Perform [inventory actions](/docontrol-user-guide/workflows/inventory-actions-quick-actions.md) per asset or in [bulk](/docontrol-user-guide/workflows/bulk-remediation/apply-a-bulk-action.md), such as:
  * Remove public sharing for a large number of files
  * Remove specific collaborators
  * Remove internal collaborators
  * Remove external collaborators
  * Change asset ownership&#x20;

{% hint style="info" %}

* You can access your assets by clicking **Inventory** > **Assets**. The **Remediate** button appears where applicable.
* Learn how to apply inventory actions on multiple assets with [bulk actions](/docontrol-user-guide/workflows/bulk-remediation/apply-a-bulk-action.md).
* Learn more about asset management with [DoControl videos](/docontrol-user-guide/help/videos.md#asset-management-in-docontrol).
  {% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FcQoiRgUE3T0GUpGfYvOC%2FGoogle%20all%20assets.png?alt=media&amp;token=d06e312d-d62e-4ce3-b699-44e479c52f5b" alt=""><figcaption><p>Example of Google Drive assets page</p></figcaption></figure>

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

<table><thead><tr><th width="150">Option</th><th>Details</th></tr></thead><tbody><tr><td>Asset name (link)</td><td>Click an asset name to open the <a href="#individual-assets">Individual assets </a>page, where you can get more information on the asset and perform actions.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FtS4NVRcY1t3dYrsSJlfB%2Fadd%20filter.png?alt=media&amp;token=562d19a7-d350-47a9-ad5f-27e62a3c6e19" alt="" data-size="line">Filters</td><td>Filter assets according to relevant options appearing in each app.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FvyxjlxWbIGus04YqOfiy%2Fimage.png?alt=media&amp;token=17240c05-7b94-42fc-ba3f-8abdd49bd916" alt=""></td><td>Sort column</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FKpzXbWlNgJJ7TUIHxlcs%2Fimage.png?alt=media&amp;token=edfc00aa-1948-4add-89a2-ae70cb70c67f" alt=""></td><td>Search in current loaded results. Load more pages if needed.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F7HWCxQOdvbIBrSCpxiwX%2Fimage.png?alt=media&amp;token=aafda7d7-7599-48b8-8002-412aad59807d" alt=""></td><td>Export to CSV</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FspnnLDJTmYyhXVOKqljG%2Fimage.png?alt=media&amp;token=784c4d9f-9b5b-4517-83ce-238092abdf37" alt=""></td><td>Select assets to remediate (only in apps that support inventory actions)​.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FJal54Ya7tRn4IpSFpqk4%2Fremediate%20button.png?alt=media&amp;token=078208f1-7c4d-4c9c-ba13-c7ac471bda13" alt=""></td><td>Click to apply an <a href="/docontrol-user-guide/workflows/inventory-actions-quick-actions.md">inventory action</a> on selected assets (only in apps that support inventory actions)​</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FIoME2tHye2tK6clT5wrD%2Fimage.png?alt=media&amp;token=17656ac7-ba12-4999-bcd8-84b9a1fd2a18" alt=""></td><td>Click<img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FP6FC7Fm3hfFDsHody3sH%2Fimage.png?alt=media&amp;token=c4049e17-ca91-45db-add8-980712d92204" alt="">to load more pages. Every page up until the currently displayed page is loaded in memory for searching.</td></tr></tbody></table>

## Asset details

When you click a specific asset from the Assets page, you can view detailed information about the asset, including:

* Sharing status, owner, member, creation and last modified dates
* Application and external domains related to the asset
* Events related to the asset
* Internal and external collaborators with access to the asset

#### To view an individual asset:

1. Click **Inventory** > **Assets.**
2. Select a SaaS app, and filter.
3. Click an asset name.
4. Click **Open file**<img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FA6moXGFtgbj8QLIldqQW%2Fopen%20file.png?alt=media&amp;token=358a8bb7-57d5-4c32-a0b5-b709ee542b0b" alt="" data-size="line">to view the actual asset in its SaaS app. You need to have sufficient permissions to access the asset.

{% hint style="warning" %}
In some SaaS apps, even users with Global Administrator access cannot access specific files unless the account holder or owner has granted them appropriate permissions.&#x20;
{% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FUJtZPkQMpl9Qw9eqggXU%2Fasset%20individual.png?alt=media&amp;token=4d13bb9c-7602-4c0a-9a77-cddcacc2183e" alt=""><figcaption><p>Individual asset page displays events and collaborators related to asset</p></figcaption></figure>

## Sharing statuses

The sharing status of assets varies according to the integrated app. Not all statuses are clear-cut. Common sharing statuses per app include:

### Box

* **People with a link** - Anyone with a link can access the asset, without requiring a Box account. For extra security, you can:
  * Set a password or expiration for the link
  * Restrict download or preview access for link viewers&#x20;
* **People in your company** - Users with a Box account (Starter and above), or users with an email domain that was registered in your Box account can access the link.&#x20;
* **Invited people only** - Only invited users who are authenticated can access the asset.&#x20;
* **No sharing link** - No sharing link was created for this asset. Collaborators invited to a file or a folder (not using a link) can access it.
* **Internal** - Asset is shared within the organization.
* **External** - Asset is shared outside the organization.

{% hint style="info" %}
For more details on sharing statuses in Box, [see here](https://support.box.com/hc/en-us/articles/360043697094-Creating-Shared-Links#:~:text=send%20your%20link.-,Shared%20link%20access,-When%20you%20create).
{% endhint %}

### Google Drive

Sharing statuses for Google Drive include:

* **Public** - Anyone with the link can access the asset, without authentication.
* **External** - Specific external users can access the asset&#x20;
* **Internal with link** - Anyone with the link can access the asset after authentication.
* **Searchable** - Internal users can search for the asset within the organization.
* **Internal** - Only specific internal users can access the asset.&#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%2F1zyca14MDXVC5wLwOVgR%2Fsharing%20status.png?alt=media&amp;token=10b20642-d0f8-4280-a429-1e7461812579" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}

* DoControl indicates assets as **External** when shared with at least one external user. Based on data from Google API, DoControl can distinguish between internal and external users.&#x20;
* For more details on sharing statuses in Google Drive, [Google Support](https://support.google.com/drive/answer/7166529).&#x20;
  {% endhint %}

### Sharepoint, OneDrive, Teams

* **Public** - Anyone with the link can access the asset, without authentication.
* **Organization** - Only internal users with the link can access the asset.
* **External** - Anyone with the link can access the asset, after authentication.
* **Internal** - Only specified internal users can access the asset.&#x20;

{% hint style="info" %}
For more details on sharing statuses in Microsoft, [see here](https://docs.microsoft.com/en-us/sharepoint/modern-experience-sharing-permissions#shareable-links).&#x20;
{% endhint %}


---

# 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/saas-data-monitoring/inventory/inventory-assets.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.
