Skip to main content
SAML SSO
Updated over 2 months ago

Introduction

You can allow users in your organization to use SAML single sign-on (SSO) to log in.

When configured, users in your workspace will be able to log in to Dart by logging into your Identity Provider (IdP).

Dart works with Microsoft Entra, Okta, and any other IdP that supports SAML 2.0.

Prerequisites

  1. You must be on the business tier

  2. Your IdP must support SAML 2.0

  3. You must be a workspace admin

General setup

  1. Visit the Identity settings page in Dart to get started

  2. Copy the 'Entity ID' to put into your IdP

  3. Copy your 'ACS URL' to put into your IdP

  4. Paste in the IdP Details from your IdP (as either a URL or as XML) and then click 'Save'

IdP-specific setup

Microsoft Entra

  1. Open Microsoft Entra and navigate to the 'Enterprise applications' list

  2. If you don't already have an application for Dart,

    1. Click 'New application' and then click 'Create your own application'

    2. Name it 'Dart', click 'Create', and wait for the application to be created

  3. Within the Dart application, click 'Single sign-on' and choose 'SAML'

  4. Click 'Edit' in the 'Basic SAML Configuration' section

  5. Paste the 'Entity ID' from Dart into the 'Identifier (Entity ID)' field after clicking 'Add reply URL' in that section

  6. Paste the 'ACS URL' from Dart into the 'Reply URL (Assertion Consumer Service URL)' field after clicking 'Add identifier' in that section

  7. Paste 'https://app.itsdart.com/login' into the 'Sign on URL (Optional)' field

  8. Click 'Save' at the top and then close the overlay

  9. Copy the 'App Federation Metadata Url' from the 'SAML Certificates' section

  10. Switch to Dart and paste this into the 'IdP Details' URL field and click 'Save'

Okta

  1. Open Okta and navigate to the 'Applications' list

  2. Click 'Create App Integration'

  3. Choose 'SAML 2.0' and click 'Next'

  4. Name the app 'Dart' and use this logo

  5. Paste the 'ACS URL' from Dart into the 'Single sign-on URL' field and ensure 'Use this for Recipient URL and Destination URL' is selected

  6. Paste the 'Entity ID' from Dart into the 'Audience URI (SP Entity ID)' field

  7. Choose 'EmailAddress' in the 'Name ID format' field

  8. Choose 'Email' in the 'Application username' field

  9. In the 'Attribute Statements' section,

    1. Choose 'URI Reference' in the 'Name format' column

    2. Choose 'user.email' in the 'Value' column

  10. Click 'Next', then click 'Finish'

  11. Ensure the 'Sign On' tab is open

  12. Copy the 'Metadata URL' from the 'Settings' section

  13. Switch to Dart and paste this into the 'IdP Details' URL field and click 'Save'

Did this answer your question?