documentation/guides/sso/getting-started.md
Getting started with SSO/SAML for your company is fast and straightforward. Scalar is designed to support seamless onboarding, offering step-by-step guidance so you can get your team connected with secure, single sign-on in just a few minutes.
Scalar supports SSO/SAML integration with the following providers:
With SSO (Single Sign-On), users only need to create and use one main account to access multiple applications, instead of making separate accounts and logging in to each app individually.
SAML (Security Assertion Markup Language) is a technical standard used to implement SSO. It defines the protocol and data format that enables your identity provider and applications to securely communicate authentication and authorization information.
The setup process does not require complex configuration. You will be able to enable enterprise-grade authentication and access control for your organization – no matter your technical background.
In your identity provider (IdP), create a new SAML application for Scalar. The exact steps vary by provider, but generally you will:
Refer to your provider-specific guide for detailed instructions.
After creating the application, assign the users and groups that should have access to Scalar. This is typically done in your IdP's user management or application assignment section.
Before configuring SAML settings in your IdP, create a new SSO connection in Scalar:
Configure your IdP's SAML settings with the following service provider details from Scalar:
| Field | Value |
|---|---|
| Identifier (Entity ID) | https://identity.scalar.com |
| Reply URL (Assertion Consumer Service URL) | https://identity.scalar.com/acs |
| Sign on URL (Optional) | "Login URL" from Scalar |
| Relay State (Optional) | "Generate Relay State" in Scalar |
[!NOTE] Different identity providers may use different terminology for these fields. The Entity ID may be called "Audience URI" or "Identifier". The Reply URL may be called "ACS URL", "Callback URL", or "Single Sign-On URL".
After configuring your IdP, copy the following details from your identity provider into Scalar:
| Scalar | Identity Provider |
|---|---|
| Login URL | SSO URL / Single Sign-On URL / SAML Endpoint |
| Identity Provider Issuer | Entity ID / Issuer URL / IdP Identifier |
| Certificate (Base64) | X.509 Certificate / Signing Certificate |
These values are typically found in your IdP's SAML configuration, metadata, or certificate section.
Scalar requires token encryption for SAML assertions. To enable this:
[!NOTE] Not all identity providers support token encryption in the same way. Refer to your provider-specific guide for detailed instructions.
Once you have completed these steps, your organization is ready to use Scalar SSO! If you run into any issues, double-check your settings or follow our provider-specific guides for more detailed instructions. You can also reach out to our support team – we're here to help!