> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Set up Auth0 Single Sign-On (SSO) for SimplyPrint

| This guide is for SimplyPrint customers with the Print Farm, School, or Enterprise plan who use Auth0 as their Identity Provider for Single Sign-On.
| If you don’t use Auth0, but rather another SSO provider, check out our other SSO guide(s) here: [Set up Single Sign-On (SSO) for SimplyPrint](https://help.simplyprint.io/en/article/set-up-single-sign-on-sso-for-simplyprint-4coj1g/)

This guide explains how to connect **Auth0** with **SimplyPrint** using SAML 2.0. After setup, staff and students can log in to SimplyPrint using their Auth0 accounts.
You can follow the interactive guide below, or the written instructions further down.

${frame}[](https://demo.arcade.software/gXl3DHOpFwnFY1HpxIeu?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=false)

| Tip: if you or anyone from your team already has a SimplyPrint account (created without SSO), you can link it after setting up SSO! More here: Linking your existing SimplyPrint account to your SSO account

## Part 1: Prepare SimplyPrint
1. Go to your SimplyPrint dashboard → [Organization Settings → Registration & SSO](https://simplyprint.io/panel/settings/organization#registration).
2. Enable **SAML Single Sign-On (SSO)**.
3. Click **Edit SAML Configuration**.

Keep this page open.

## Part 2: Create an application in Auth0
| Visit Auth0’s own documentation on SAML Add-on for the most up-to-date information: https://auth0.com/docs/authenticate/single-sign-on/outbound-single-sign-on/configure-auth0-saml-identity-provider
1. Open the Auth0 Dashboard (https://manage.auth0.com/dashboard)
2. Go to **Applications → Applications**.
3. Click **+ Create Application**.
4. Select **Regular Web Application**.
5. Enter a name (e.g. **SimplyPrint**) and click **Create**.

## Part 3: Enable the SAML2 Web App Add-on
1. In your new application, go to the **Add-ons** tab.
2. Enable **SAML2 Web App**.
3. In the **Application Callback URL** field, paste SimplyPrint’s **ACS URL** (from the metadata).
4. In **Settings**, configure at least:
```
{
  "mappings": {
    "email": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress",
    "name": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name",
    "given_name": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname",
    "family_name": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname",
    "groups": "http://schemas.xmlsoap.org/claims/Group"
  }
}
```
    * Remove the `//` in front of any lines you want to use (comments are disabled in real JSON).
    * You can adjust or simplify if you only want full name + email.
5. Click **Save**.

## Part 4: Get IdP details from Auth0
After saving, Auth0 will generate the values you need to enter in SimplyPrint:
* **Identity Provider Login URL (SSO URL)**
* **Identity Provider Entity ID**
* **X.509 Signing Certificate**
Copy these values.

## Part 5: Enter IdP details into SimplyPrint
Back in **SimplyPrint → Edit SAML Configuration**, fill in:
* **Entity ID (Issuer)** → Auth0’s Entity ID
* **SSO URL (Login URL)** → Auth0’s Login URL
* **X.509 Certificate** → Copy-paste Auth0’s certificate
* **SSO Binding** → Leave as **HTTP-Redirect**
Click **Save**.

## Part 6: Map user attributes
Now tell SimplyPrint how to read the data from Auth0.
### Required
| SimplyPrint field | Auth0 mapping example | Notes |
| ---- |
| `first_name` | `given_name` | Required (unless `full_name` is provided) |
| `last_name` | `family_name` | Required (unless `full_name` is provided) |
| `email` | `email` | Optional |
| `full_name` | `name` | Required if first/last are not used |
### Optional
| SimplyPrint field | Auth0 mapping example | Notes |
| ---- |
| `user_group` | `groups` | Group membership |
| `school_is_teacher` | `user.app_metadata.isTeacher` | Custom claim, true/false or yes/no |
| `school_classes` | `user.app_metadata.classes` | Custom claim, comma/semicolon separated |
👉 Make sure the field names you enter in SimplyPrint exactly match the keys you used in your Auth0 JSON.

## Part 7: Enable the app
1. In Auth0, go back to your new application.
2. Scroll down and click **Enable** to turn on the SAML2 Add-on.
3. Assign users or connections that should be able to log in with SimplyPrint.

## Part 8: Test the connection
1. In Auth0, click **Debug** on the SAML2 Add-on.
2. Sign in with a test user.
3. Check that all attributes are returned correctly.
4. In SimplyPrint, log out and try logging in with SSO.
If login fails:
* Make sure ACS URL and Entity ID match.
* Confirm the certificate is correct.
* Ensure attributes are spelled exactly the same.

## Part 9: (Optional) Show your organization on the SimplyPrint login page
To make login easier for users:
1. In [Organization Settings → Registration & SSO](https://simplyprint.io/panel/settings/organization#registration), enable:
**“Show school/organization in the public list shown on login page.”**
2. Your organization will now appear at:
    * [https://simplyprint.io/panel/login](https://simplyprint.io/panel/login)
    * [https://simplyprint.io/panel/login/school](https://simplyprint.io/panel/login/school)

## Done! 🎉
Your Auth0 users can now log in to SimplyPrint via SAML SSO. Groups, teacher status, and classes can be passed automatically if configured in Auth0.
**See how to log in using SSO here**: [Signing in with SSO / Organization Login](https://help.simplyprint.io/en/article/signing-in-with-sso-organization-login-1v0eb2h/)
**Link existing accounts to SSO**: [How to link an existing SimplyPrint account to your SSO account](https://help.simplyprint.io/en/article/linking-your-existing-simplyprint-account-to-your-sso-account-5pw0aj/)
**Troubleshooting**: [SSO troubleshooting: how to fix errors like “first_name not set”](https://help.simplyprint.io/en/article/sso-troubleshooting-how-to-fix-errors-like-firstname-not-set-pgdbiz/)