> 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/shadow-apps/google-shadow-apps/shadow-app-users.md).

# Shadow app users

DoControl allows you to drill down into data about the users who have installed or are using a specific shadow app.

Based on the displayed data, you can manually change the classification of a specific shadow app.&#x20;

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FnNbs6I9GyWYfX80VBD2D%2Fuser%20data%20shadow%20apps.png?alt=media&amp;token=236ccb34-07b0-41d3-9bfd-9e3559e63139" alt=""><figcaption><p>User data per shadow app</p></figcaption></figure>

{% hint style="success" %}
To remove a specific user from a specific shadow app, you can implement an automated workflow to revoke the user token. See [Google Workspace remediation](/docontrol-user-guide/workflows/define-workflow-settings/action-settings/remediate/google-workspace-remediation.md#remove-user-app-token) actions.
{% endhint %}

#### To display user data for each shadow app:

1. In the DoControl sidebar, go to **Shadow apps > Google Workspace**.
2. Apply any relevant filters to narrow your display of shadow apps.
3. In the **Users** column, click the number of users. The Shadow app users window is displayed.
4. Click the **Search** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FOMu4w5mAFJoSWvuWjnHg%2Fsearch%20icon.png?alt=media&amp;token=1ffb4e64-cbe3-49db-9e6e-220bd15825ed" alt="" data-size="line"> icon to look for an item in the currently loaded results.

## Data for shadow app users

DoControl displays metadata for each user using a specific shadow app:

<table><thead><tr><th width="172.5">User metadata</th><th>Description</th></tr></thead><tbody><tr><td>Installed by</td><td>Number of users who installed the shadow app</td></tr><tr><td>Type</td><td>Application client type for which the app was developed</td></tr><tr><td>Usage</td><td><p>How much the app is in use relative to the global use of all applications in your organization's SaaS platform over the last 30 days:</p><ul><li>Unknown</li><li>None</li><li>Low</li><li>Medium</li><li>High</li></ul><p>For more details, see <a href="#shadow-app-usage">Shadow app usage</a>.</p></td></tr><tr><td>Permissions</td><td>The permission level indicates to what extent these permissions are intrusive (low, medium, or high). See <a href="/docontrol-user-guide/saas-data-monitoring/shadow-apps/google-shadow-apps/risk-snapshot.md#permissions-and-scopes">Permissions and scopes</a>.</td></tr><tr><td>Origin</td><td>The app publisher origin based on the publisher domain, as well as your internal and trusted domains.</td></tr><tr><td>Risk score</td><td>Score from 1-10 that evaluates how risky the shadow app is in your organization. What is the score based on? See the <a href="/docontrol-user-guide/saas-data-monitoring/shadow-apps/google-shadow-apps/risk-snapshot.md#risks">Risks</a> card for more details.</td></tr><tr><td>Classification</td><td><p>Manually apply the classification category for each app:</p><ul><li><strong>Banned</strong> - App is risky and app use is not allowed by your organization.</li><li><strong>Sanctioned</strong> - App use is allowed by your organization.</li><li><strong>Unclassified</strong> - App isn't yet classified.</li><li><strong>Unsanctioned</strong> - App use is not allowed by your organization.</li></ul><p>For more details, see <a href="/docontrol-user-guide/saas-data-monitoring/shadow-apps/google-shadow-apps/classify-shadow-apps.md">Classify shadow apps</a>.</p></td></tr><tr><td>Data feedback</td><td>Provide data feedback about shadow apps to help us improve our app risk scoring, and general app data</td></tr><tr><td>User email</td><td>Email address of the shadow app user. Clicking the email opens the <a href="/docontrol-user-guide/saas-data-monitoring/inventory/inventory-users/google-workspace-users/internal-users.md#internal-user-details">internal user details</a>.</td></tr><tr><td>First name</td><td>User's first name</td></tr><tr><td>Last name</td><td>User's last name</td></tr><tr><td>Individual usage</td><td>How much a specific user used the app in the last 30 days, compared to other users of the app.</td></tr><tr><td>Last used</td><td>Date when the user most recently accessed the shadow app</td></tr><tr><td>Status</td><td><p>If the app is currently installed for the user:</p><ul><li><strong>Installed</strong> - User has an installed app.</li><li><strong>Reinstalled</strong> - After an app was removed, the user reinstalled the app.</li><li><strong>Not installed</strong> - User uninstalled the app.</li><li><strong>Removed</strong> - User was removed from the app.</li></ul><p>You can also <a href="#filter-shadow-app-users">filter shadow app users</a> according to status.</p></td></tr><tr><td>Remediate</td><td><ul><li>You can manually <a href="/docontrol-user-guide/workflows/define-workflow-settings/action-settings/remediate/google-workspace-remediation.md#remove-user-app-token">remove specific users</a> from an unauthorized shadow app in Google Workspace.</li><li>You can remove users one-by-one or in bulk.</li><li>After you remove a user app token, data is deleted for the affected users.</li></ul></td></tr></tbody></table>

## Filter shadow app users

You can filter shadow app users for a specific app based on these parameters:

1. DoControl sidebar, go to **Shadow apps > Google Workspace**.
2. Apply any relevant filters to narrow your display of shadow apps.
3. In the **Users** column, click the number of users. The Shadow app users window is displayed.
4. Click the **Filters** button, and select a parameter:
   * **Removed by DoControl** - All shadow app tokens that were revoked for specific users are displayed.&#x20;
   * **Status** - You can display shadow apps that are installed or not installed for specific users. Problematic statuses are displayed with a warning icon:

<table data-full-width="false"><thead><tr><th width="151">App status</th><th width="251">App removed by DoControl?</th><th width="71.33333333333331">Icon</th><th width="277">Description</th></tr></thead><tbody><tr><td>Installed</td><td>No</td><td></td><td>User installed the app</td></tr><tr><td>Reinstalled</td><td>Yes</td><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FeGUBqo4mS000WzqVwX5U%2Finstalled%20shadow%20app.png?alt=media&amp;token=c1309b4e-7a5e-4b0a-ae8a-ebe28cf2604d" alt=""></td><td>After the app was removed, the user reinstalled the app</td></tr><tr><td>Not installed</td><td>No</td><td></td><td>User uninstalled the app</td></tr><tr><td>Removed</td><td>Yes</td><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FVf5Vo9pgUz19mWQhv6d0%2Fnot%20installed%20shadow%20app.png?alt=media&amp;token=9518073d-a2e6-4447-8071-043daa9528f0" alt=""></td><td>User was removed from the app</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/saas-data-monitoring/shadow-apps/google-shadow-apps/shadow-app-users.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.
