Skip to main content
Microsoft Azure is a popular cloud computing platform that can be used to set up SAML single sign-on using its directory service called Active Directory. Let’s see how you can do that for your Softr app to let your users sign in with their Azure credentials.

​
Creating an application

First of all, you need to create an application. To do that, navigate to Enterprise Applications on your Azure dashboard.
Enterprise applications

Enterprise applications

 Then, hit New Application.
New application

New application

 Next, in the app gallery, search for Azure AD SAML Toolkit and select the app.
Locating “Azure AD SAML Toolkit”

Locating “Azure AD SAML Toolkit”

 In the sidebar that opens next, specify a name for your app and hit Create.
Creating the application

Creating the application

 Now that you have your application, you need to set up single sign-on for it, which we’ll discuss next.

​
Getting started with single sign-on setup

On the Overview screen of the application that you just created, click Get started under Set up single sign on.
Getting started with single sign-on setup

Getting started with single sign-on setup

 In the next screen, select the SAML method.
Selecting the single sign-on method

Selecting the single sign-on method

 You’ll be taken to the configuration page, where you need to set up the required parameters in order to integrate the single sign-on with your Softr app.

​
Basic SAML configuration

The first step of the setup is Basic SAML Configuration. Click Edit in the upper right corner to enter the configuration screen.
Basic SAML configuration

Basic SAML configuration

 First comes the Identifier (Entity ID) property, which can be found under Audience URL in your Softr app’s Settings ⇒ SAML Settings. Just copy the value and paste it in Azure.
Adding Entity ID

Adding Entity ID

 Next, you need to add the Reply URL (ACS URL), which can be located under ACS URL in your Softr app’s SAML settings. The Index field can be left empty.
Adding ACS URL

Adding ACS URL

 Lastly, you have the Sign on URL, which should have the URL of the page where your SSO login form is located.
Softr application page with an SSO sign-in block

Softr application page with an SSO sign-in block

 You need to copy the URL and paste it under Sign on URL in Azure.
Adding the Sign on URL

Adding the Sign on URL

 To finalize the setup, hit Save and close the sidebar.

​
Attributes & Claims

In this step, you need to copy the First Name, Last Name, and Email keys from Azure and add them into your Softr app’s single sign-on settings.
Getting the keys from Azure

Getting the keys from Azure

 The keys should be applied as shown in the following screenshot.
Applying keys in Softr

Applying keys in Softr

​
SAML Certificates

In this step, you need to download the Metadata XML file in Azure.
Metadata XML Download

Metadata XML Download

 Next, open the file with any suitable editor, copy the entire content of the file, and add it to your Softr app under SAML Settings.
Adding metadata XML to Softr

Adding metadata XML to Softr

 And you’re almost done. There’s one last step remaining, which we’ll discuss next.

​
Assigning users to an application and testing

Now, your users should be able to log into your Softr app with their Active Directory credentials. Note, that the user needs to be assigned to your Azure application to be able to access it. To assign a user, you need to navigate to the Users and groups sections of your application and add that user. The following gif shows the process of assigning a user to an application.
Assigning a user to your application

Assigning a user to your application

 The assigned user should now be able to log into your Softr app through single sign-on.
Signing in with Active Directory credentials

Signing in with Active Directory credentials