> ## Documentation Index
> Fetch the complete documentation index at: https://docs.startleftsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta SSO Integration

# IdP Configuration

### Okta Configuration

1. Go to Applications
2. Create a new app integration and select SAML 2.0. Click Next.
3. Enter a recognizable App Name such as "StartLeft Platform". Click Next.
4. Fill in the Single sign-on URL ("Assertion Consumer Service URL") and "Entity ID" fields with the information from the StartLeft Single Sign On Settings.

<img src="https://mintcdn.com/startleftsecurity/GeRxP6WB6uCmmrGz/integrations/sso/okta-create.png?fit=max&auto=format&n=GeRxP6WB6uCmmrGz&q=85&s=b6c16f831ecb1c53cfc67359c09303f0" alt="SSO" width="748" height="754" data-path="integrations/sso/okta-create.png" />

The **SP Entity ID** is the **Identifier (Entity ID)** - the ID of the service provider

The **Single Sign-on URL** is the **Reply URL (Assertion Consumer Service URL)** - the identity provider must
be configured to return the SAML response to the ACS URL:

```
https://tauruseer-auth-prod.us.auth0.com/login/callback
```

Both of these fields can be found in the SLS Platform by navigating to Configure on the left hand menu and selecting SSO settings.

<img src="https://mintcdn.com/startleftsecurity/GeRxP6WB6uCmmrGz/integrations/sso/SSO-Configure-Account.png?fit=max&auto=format&n=GeRxP6WB6uCmmrGz&q=85&s=debfe2e87fe21c132124b0061c881eae" alt="SSO" width="768" height="679" data-path="integrations/sso/SSO-Configure-Account.png" />

### Configure Attributes & Claims

In Entra ID, you must configure the **Unique User Identifier (Name ID)** value to be
set to the user’s email address, in Azure AD this value must be set to ***user.mail***

* **email** - set to user.email
* **first\_name** - set to user.firstName
* **last\_name** - set to user.lastName

**Group claims (Optional)** – Set to Groups assigned to the application, the
name of the claim should be defined as **groups**. This may be used in
the future to map users belonging to specific groups to SLS platform
roles (Admin, Dev, .etc).

<img src="https://mintcdn.com/startleftsecurity/GeRxP6WB6uCmmrGz/integrations/sso/okta-attributes.png?fit=max&auto=format&n=GeRxP6WB6uCmmrGz&q=85&s=71b8340da8ef16e84bde12d2744c81d6" alt="Claims" width="719" height="635" data-path="integrations/sso/okta-attributes.png" />

Download the signing certificate and ensure the file extension is saved as a .pem file.

In the SLS Platform:

1. Set the Single Sign On URL from Okta
2. Set the Domain name to your company's domain.
3. Upload to the X590 Certificate.
4. Click Save SSO Settings.
