For the complete documentation index, see llms.txt. This page is also available as Markdown.

📓Okta Integration

Prerequisites

In order to configure Okta integration with Spreo you will need:

  • Admin access to your Spreo account.

  • Admin access to your Okta account.

  • One or more authorized domains adding to your Spreo account (see end of article).

  • A note of your organizations Spreo Account ID.

How to find your Spreo Account ID

Before you begin, you will need your organization's 12 character Spreo Account ID. You can find this in the under the management menu within Spreo: https://spreo.io/manage

Spreo Account ID

Integration Setup

From within the Okta dashboard, choose Applications and Create App Integration. Select SAML 2.0 and press Next. Set the name as Spreo and optionally add an icon. We have prepared an Okta compatible logo image here: https://s.spreo.io/site/logo/okta.png

General Settings

Click Next.

Under SAML Settings, set the Single Sign-On URL to https://spreo.io/login/saml and set Audience URI (SP Entity ID) to Your Account ID (see start of document).

SAML Settings

Under Attribute Statements, add the following mappings:

  • firstName (basic) -> user.firstName

  • lastName (basic) -> user.lastName

  • email (basic) -> user.email

Attribute Statements

Click Next.

Choose "I'm an Okta customer adding an internal app". You may optionally fill in any other fields on this form that are appropriate for your organization, they are not required for the integration to work.

Click Finish.

You should see the screen below, if not, click View Setup Instructions. The three values on the setup screen need to be added to Spreo under Management / Single Sign-On.

Data for Spreo from Okta
Data added to Spreo

Once added, click Save Configuration. We recommend leaving the "Restrict login" setting off until you are sure all your team members are able to login via SSO otherwise it may block their access.

If you have not already had your authorized domains configured by a Spreo team member, please contact us on Intercom or at contact@spreo.io to set these up. The domains must include all domains that your team will login from.

Last updated