Skip to content
English
  • There are no suggestions because the search field is empty.

Single Sign-on with Microsoft Entra ID (Azure AD)

How to set up users to sign in with SSO through Microsoft Azure

Sections in this article

Before you start

  • Different eSPACE Subscription Tiers include Different Features Including Single Sign On
    • In order to know if this feature is included in your eSPACE subscription tier, please contact support@smartchurchsolutions.com.

  • Viewing Your Subscription Details
    • Each eSPACE admin with access to Billing can view what subscription tier your organization currently has and everything that is included in their account under Settings > Other > Billing > Manage.

 

If your tier includes Single Sign-On, you can set up eSPACE so your users sign in and are verified through your organization's Microsoft account. For more information on how SAML SSO works with eSPACE, read How SAML Single Sign-On Works.

Only eSPACE Admins can open the SSO Integration Setup page in eSPACE. Keep that page open in another tab. You'll copy values from it and upload a file to it as you go.

 

Create the eSPACE app in Microsoft Entra ID

  1. Sign in to portal.azure.com.
  2. Click Microsoft Entra ID (this used to be called Azure Active Directory). If you don't see it, search for "Entra ID" at the top of the page.

    Microsoft Entra ID in the Azure portal menu
  3. On the left, under Manage, click Enterprise applications

Enterprise applications under Manage


       4. Click + New application.

 

        5. Search for "SAML Toolkit," click Microsoft Entra SAML Toolkit, then click Create.

    • You can also choose Create your own application and select the Non-gallery option.

 

Set up SAML single sign-on

      6. Under Getting Started, click Set up single sign on.
      7. Click SAML.
      8. Edit the Basic SAML Configuration panel:

  • Identifier: https://app.espace.cool
  • Reply URL (ACS URL): copy this from the eSPACE SSO Setup page
  • Sign on URL: https://app.espace.cool/Account/SSOAuth
  • Click Save.

Important: The eSPACE SSO Setup page also shows a direct login link that ends in your organization's number, like https://app.espace.cool/Account/SsoAuthOrg/1234. Don't use that link for the Sign on URL. Enter https://app.espace.cool/Account/SSOAuth exactly as shown above.

 

Map the user attributes.  

      9. Edit the Attributes & Claims panel. Under Additional claims, update these three rows, clicking Save after each one:
  • Row with Value user.mail: set Name to email and leave Namespace blank.
  • Row with Value user.givenname: set Name to firstname and leave Namespace blank.
  • Row with Value user.surname: set Name to lastname and leave Namespace blank.

These names are case-sensitive. Enter them exactly as shown, all lowercase.

 

Connect the certificate to eSPACE

      10. In the SAML Signing Certificate section, download the Federation Metadata XML file, then upload it on the eSPACE SSO Setup page. This fills in the Certificate and the Single Sign On Service URL for you.


     11. In the Required Attributes section of the eSPACE SSO Setup page, confirm the attribute names match what you entered in step 9: email, firstname, lastname. They're case-sensitive and must match exactly.

  • The Required Attributes in eSPACE should say
    • Attribute     | Description 
    • email            | Email Address
    • First Name | First Name
    • LastName.  | Last Name

Name the app and choose who can use it

     12. Back in Microsoft Entra ID, open the app's Properties page to change its name, logo, assignment setting, and visibility. You can use the eSPACE logo from an internet search.


     13. Use the app's Users and groups page to choose who can sign in to eSPACE with SSO.

 

Finish setup in eSPACE

     14. On the eSPACE SSO Setup page, choose the User Provisioning setting you want.Note: If you choose "Create a new login account and allow them immediate access," a duplicate account could be created for someone who has used an alias or changed their name and now has a new email address.


     15. If you chose one of the "Create new login…" options, select the login account eSPACE should copy for new users who come in through SSO. eSPACE copies that user's settings, including roles, module access, and location access. These are not copied:

    • Billing Contact role
    • Name, email address, and employee ID

    16. Set the appropriate Integration Admin by choosing one from the drop down menu at the bottom of the SSO page in eSPACE.