> 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-users/slack-users/slack-external-users.md).

# Slack external users

External users are users outside your organization with access to company assets. After you filter a specific user's assets, you can generate a CSV report. 

The external users page displays the following data:

* [External user list](#external-user-list)
* [External user details](#external-user-details)
* [Assets](#assets)
* [Events](#events)

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FGYBiNxG7kw5gdS5vDlnR%2FSlack%20external%20user%20details.png?alt=media&amp;token=feb4a9ba-0fc8-4057-9a8b-dd9069d89db6" alt=""><figcaption><p>Asset and event details for an external user in Slack</p></figcaption></figure>

## Locate an external user

To view personal details, asset and event data for a specific external user in Slack:

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **Slack** and **External**.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FvBnv0n577hHeTEc1E9WK%2FSlack%20users.png?alt=media&amp;token=da0c19e3-8e21-4220-ab3b-345fb0f5471b" alt=""><figcaption></figcaption></figure>
3. Filter for a specific user.
4. Click the user's **email address** to open the external user details.
5. Click any **app** icon to display user details, assets and events for that SaaS app.

## External user list

All external users in Slack are displayed with these parameters:

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FtUIuIWqJZRPKvLvtEh0S%2FSlack%20external%20user%20list.png?alt=media&amp;token=ea98a655-7a19-4848-8887-31adb8b0167a" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="223.87890625">External user parameter</th><th>Description</th></tr></thead><tbody><tr><td>Email</td><td>External user's email address. Click the email to open the external user details with asset and event data. </td></tr><tr><td>Channel count</td><td>Number of Slack channels the external user has access to</td></tr><tr><td>Updated at</td><td>Date when the user's metadata was last updated</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of external Slack users in CSV format.
{% endhint %}

## External user details

Metadata for a specific external user is displayed as follows:

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FubLKX7NuSBlG9eBI9NCA%2FSlack%20external%20user.png?alt=media&amp;token=71ee4f85-edbe-407e-b70f-e0541fa0dc74" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="271">External user detail</th><th>Description</th></tr></thead><tbody><tr><td>Email </td><td>Email of external user</td></tr><tr><td>Related active alerts</td><td>Number of active alerts where this user is the target. Click <strong>View</strong> to open the Alerts page filtered for this user's alerts.</td></tr></tbody></table>

## Assets

View and filter metadata for Slack assets that an external user can access.

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **Slack** and **External**.
3. Filter for a specific user.
4. Click the user's **email address** to open the external user details.
5. Scroll down to view metadata for all Slack assets that this external user can access.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FLs4LkaHP0Tchw0UkT1wY%2FSlack%20public%20channels.png?alt=media&amp;token=a4fd631c-28a7-4ce8-ad81-9510b9627a56" alt=""><figcaption></figcaption></figure>

The metadata displayed for Slack assets that can be accessed by an external user includes these parameters:

<table><thead><tr><th width="223.87890625">Slack asset parameter</th><th>Description</th></tr></thead><tbody><tr><td>Public channel</td><td>Name of the public Slack channel</td></tr><tr><td>Purpose</td><td>Aim of Slack channel</td></tr><tr><td>Shared externally</td><td>Indication if the Slack channel is shared with external users</td></tr><tr><td>Members</td><td>Number of members in the channel</td></tr></tbody></table>

{% hint style="info" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of accessible Slack assets in CSV format.
{% endhint %}

## Events

DoControl monitors real-time events of user activities in Slack. If no date range is selected, events are displayed from the last 30 days.

#### To view events for a specific external user:

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **Slack** and **External**.
3. Filter for a specific user.
4. Click the user's **email address** to open the external user details.
5. Scroll down to view metadata for the user's events in Slack.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FrmLBrzNjuHJv3hT3XHmT%2FSlack%20events%20internal.png?alt=media&amp;token=5cd4fddd-385a-4dec-8d18-98488d60d21f" alt=""><figcaption></figcaption></figure>

The metadata displayed for a user's events in Slack includes these parameters:

<table><thead><tr><th width="271">Event parameter</th><th>Description</th></tr></thead><tbody><tr><td>Date and time</td><td>When the event occurred</td></tr><tr><td>Actor </td><td>The user who triggered the event</td></tr><tr><td>Target</td><td>The user whom the actor shared data with</td></tr><tr><td>App</td><td>App involved in the event: Slack</td></tr><tr><td>Asset</td><td>Name of the asset involved</td></tr><tr><td>Event type</td><td>Type of event as defined in Slack (File public, File shared, etc)</td></tr><tr><td>Triggered</td><td>Number of workflows or alerts that were triggered by this event</td></tr><tr><td>Event ID</td><td>Unique identifier for the event</td></tr><tr><td>Event JSON</td><td>Click to open the JSON file with raw details about the event</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of event metadata for a specific Slack user.
{% 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-users/slack-users/slack-external-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.