> For the complete documentation index, see [llms.txt](https://help.nightfall.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.nightfall.ai/slack/quickstart.md).

# Nightfall for Slack: Quick Start

Learn how to set up your integration with Slack so that you can scan and protect sensitive data across your Slack workspace.

Welcome to Nightfall! This guide helps you install and set up Nightfall in a matter of minutes on your own. Within 24 hours of signing on as a customer, you will receive an invitation in your inbox to access your newly created account.

Once you receive your account, review the following pages in this guide to get set up.

## What Nightfall covers in Slack

What Nightfall can scan depends on your Slack plan.

* **Slack Pro and Slack Business+:** Nightfall scans public channels and private channels. For private channels, the Nightfall bot must be invited to each channel you want to scan. Direct messages (DMs) are **not** supported, because Slack does not allow bots in user DMs.
* **Slack Enterprise Grid:** Nightfall scans public channels, private channels, direct messages (1:1 and group DMs), and Slack Canvas. Nightfall uses the Slack Discovery API, so you do not need to invite a bot to any channel.

## **Installation**

Get ready to install by reviewing the [Requirements](/slack/getting_started/requirements.md). Then go through the installation flow for your Slack plan type:

* [Slack Pro and Business+](/slack/getting_started/install/slack_pro.md)
* [Slack Enterprise](/slack/getting_started/install/slack_enterprise.md)

{% hint style="info" %}
Slack Business+ uses the same bot installation flow as Slack Pro. To monitor direct messages, you need Slack Enterprise Grid with the Discovery API.
{% endhint %}

## Configuring Detection

Next, use the Detection Wizard to set up the right Detection Rules for your organization in your Nightfall dashboard. You can learn more about and access the **Detection Wizard** [**here**](https://help.nightfall.ai/nightfall-ai/detection-engine/detectors).

Once you have generated your Detection Rules with the Wizard, configure them on your Nightfall Dashboard.

On the [Detection Rules page](https://app.nightfall.ai/detection-engine/detection-rules), copy the Detection Rule UUIDs that you wish to use for DLP scanning.

## **Configuring Policies**

To configure a policy, follow the steps for your Slack plan type. Each guide covers how to create a policy, define its scope, select detection rules, choose automated actions, set advanced settings, and configure risk.

### Slack Pro and Business+

1. How to [create a policy](/slack/slack_pro_policy.md)
2. Defining the policy [scope](/slack/slack_pro_policy/scope.md)
3. Selecting [detection rules](/slack/slack_pro_policy/detection_rules.md) that you configured above
4. Determining what [automated actions](/slack/slack_pro_policy/automated_actions.md) you would like to take
5. Configuring the [advanced settings](/slack/slack_pro_policy/advanced_settings.md)
6. [Risk configuration](/slack/slack_pro_policy/policy_risk.md) and policy nomenclature

### Slack Enterprise

1. How to [create a policy](/slack/enterprise_policy.md)
2. Defining the policy [scope](/slack/enterprise_policy/scope.md)
3. Selecting [detection rules](/slack/enterprise_policy/detection_rules.md) that you configured above
4. Determining what [automated actions](/slack/enterprise_policy/automated_actions.md) you would like to take
5. Configuring the [advanced settings](/slack/enterprise_policy/advanced_settings.md)
6. [Risk configuration](/slack/enterprise_policy/risk_configuration.md) and policy nomenclature

## Configuring Alerts

Nightfall allows multiple methods of receiving alerts, via Slack, email, webhooks, or Jira tickets. Review the Configuring Alerts section to learn more.

## Test Detection

To confirm that sensitive data is getting scanned by Nightfall, you can run a few tests with Nightfall-provided sample data. In doing so, you will see Violations populate on the Nightfall dashboard on [the Violations page](https://app.nightfall.ai/violations). You will also start to see high-level metrics aggregate on [the Nightfall Dashboard page](https://app.nightfall.ai/dashboard).

To test detection, we recommend the following tutorials:

1. [Learn How Detection Works](/detection_platform/overview_platform.md)
2. [Use Sample Data from the Nightfall Library to Test Detection](/nightfall_policy_templates/sample_data.md)
3. [Learn How to Evaluate Detection Results](/detection_platform/evaluate_nightfall_detection.md)

**Congratulations, you are all set up. You have now successfully connected and tested Nightfall for Slack!**

If you have any questions, check out the [Frequently Asked Questions](/slack/slack-faqs.md) section for support.


---

# 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://help.nightfall.ai/slack/quickstart.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.
