Articles on: Schools & enterprise plans

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


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.



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.
  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.
  1. 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, enable:

“Show school/organization in the public list shown on login page.”

  1. Your organization will now appear at:


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

Link existing accounts to SSO: How to link an existing SimplyPrint account to your SSO account

Troubleshooting: SSO troubleshooting: how to fix errors like “first_name not set”


Updated on: 12/09/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!