# Slack (Quick Setup)

## What You'll Need

* Your Tozny account - [create one free here](https://dashboard.tozny.com/register)
* Admin access to your Slack team configuration and a Slack Plus subscription or better
* About 15 minutes of time

## Configure TozID for Slack SSO

Create a new client application by logging into your TozID realm, selecting clients from the left menu, and clicking "create" on the top right. Select Slack from the drop down menu as shown in the screenshot below.

![Slack Configuration](/files/-M-lNrhjOkFFohohpZs0)

{% hint style="info" %}
Your Slack domain is simply your organization name assigned by slack. So if you sign in at acme.slack.com your site domain is "<https://acme.slack.com>"
{% endhint %}

## Configure Slack

Navigate to your organization authentication settings and enable SAML Single Sign-On. To find this setting go to your Slack admin page, select Authentication from the left menu, and select the "SAML Authentication Settings" menu button. Below is a table of the configuration settings and the corresponding values as well as a screenshot of the completed settings.

| Setting                      | Value                                                                    |
| ---------------------------- | ------------------------------------------------------------------------ |
| SAML 2.0 Endpoint            | <https://id.tozny.com/auth/realms/\\><realm>/protocol/saml/clients/slack |
| Identity Provider Issuer     | <https://id.tozny.com/auth/realms/\\><realm>                             |
| Public Certificate           | Paste your certificate                                                   |
| Update profile on login      | Checked                                                                  |
| Allow users to change email  | Unchecked                                                                |
| Advanced - Sign AuthnRequest | Unchecked                                                                |
| Service Provider             | <https://slack.com>                                                      |
| Responses Signed             | Checked                                                                  |
| Assertions Signed            | Checked                                                                  |

![Basic Settings for TozID SAML with Slack](/files/-M-lP9SWPyLZoBDQBxNM)

![Advanced Settings for TozID SAML with Slack](/files/-M-lPEPKnZuksGe1l2Wr)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.tozny.com/toz-id/enterprise-sso/slack-quick-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.