# Connect your identity provider and create your first access rule (video)

A two-and-a-half-minute video of the nine steps from connecting Okta to the first access request in Slack: your first application, an access rule with an Okta group, and an approval.

Watch the whole setup in two and a half minutes: connect Okta to Risotto, create your first application and its first access rule, and test it in Slack. It picks up where the [Slack setup video](https://www.tryrisotto.com/docs/guides/initial/slack-setup-video) ends. Each step below links to its written guide, and [Initial IdP Setup](https://www.tryrisotto.com/docs/guides/initial/idp-setup) is the starting point for the identity provider.

[Video: Connect your identity provider and create your first access rule](https://media.tryrisotto.com/videos/idp-access-setup-desktop.mp4)

Before you start, make sure you are an admin in your Okta admin console, and that Risotto is already connected to Slack.

## The nine steps

1. **Open the Okta integration**

   Go to **Settings > Integrations**. Under **Identity**, choose **Okta**, and
   click **Connect** on the **Admin API** card. The dialog lists the Okta
   steps on the right, so keep it open. See [Okta](https://www.tryrisotto.com/docs/integrations/idp/okta).

2. **Create an API app in Okta**

   In your Okta admin console, go to **Applications**, and click **Create App
   Integration**. Choose **API Services**, give it a name, and save. Then copy
   the **Client ID**.

3. **Set up a key**

   Under **Client Credentials**, click **Edit**, and choose **Public key /
   Private key**. Add a key, generate a new one, and copy the private key
   JSON. Make sure the key is active, uncheck **Proof of possession**, and
   save.

4. **Grant scopes and roles**

   On the **Okta API Scopes** tab, grant each scope the dialog lists. On the
   **Admin roles** tab, assign **Read-only Administrator**, **Group
   Membership Administrator**, and **Help Desk Administrator**. Group
   Membership Administrator is what lets Risotto add people to groups. See
   [Okta](https://www.tryrisotto.com/docs/integrations/idp/okta) for the full list.

5. **Connect Risotto**

   Back in Risotto, paste your Okta URL, without `-admin`. Paste the Client ID
   and the private key, then click **Save**. Risotto tests the connection
   first, and the badge turns to **Connected**. [Microsoft Entra
   ID](https://www.tryrisotto.com/docs/integrations/idp/microsoft-entra) and [Google
   Workspace](https://www.tryrisotto.com/docs/integrations/idp/google-workspace) connect from the same
   Integrations page, with their own steps.

6. **Create your first application**

   Go to **Settings > Applications**, and click **Create app**. Name it after
   an app your team asks for, like Figma, and click **Create**. See
   [Applications](https://www.tryrisotto.com/docs/dashboard/applications).

7. **Create an access rule**

   On the app's page, click **Create rule**. Name the access, like Figma
   Editor, and click **Create rule**. Under **Identity Provider Group**, click
   **Select group**, and pick the Okta group that grants it. See [Access
   rules](https://www.tryrisotto.com/docs/dashboard/applications/access-rules).

8. **Add an approval, and turn the rule on**

   Under **Approvals**, choose **Require approval**, and enter your approver's
   email. Click **Save**. New rules start turned off, so switch **Enabled?**
   on.

9. **Test it in Slack**

   In your help channel, ask for access to Figma. Risotto finds the rule, and
   messages the approver. When they click **Approve**, Risotto adds the person
   to the Okta group, and lets them know.

Next, add a rule for each app your team asks for, and set up [approval policies](https://www.tryrisotto.com/docs/dashboard/settings/approval-policies).

Source: https://www.tryrisotto.com/docs/guides/initial/idp-access-setup-video
