Skip to main content
All CollectionsAdvanced
Samdesk + Azure SAML Setup
Samdesk + Azure SAML Setup

Set up your SAML SSO integration

Tamara Byers avatar
Written by Tamara Byers
Updated over 5 months ago

Create the samdesk SAML App in Azure

The first step is creating a new SAML application in Azure

  1. Navigate to “Microsoft Entra ID” within your Azure account

  2. Click “Enterprise applications” in the left navigation

  3. Click “New application” in the top-left corner

  4. Click “Create your own application” in the top-left corner

  5. Name the app “samdesk”, choose “Integrate any other application you don't find in the gallery (Non-gallery)”, and click “Create”

  6. In the new application, click “Single sign-on” in the left navigation

  7. Select “SAML” as the single sign-on method

  8. Click “Edit” next to “Basic SAML Configuration”

  9. Set “Identifier (Entity ID)” to “https://samdesk.io/sp

  10. Set “Reply URL (Assertion Consumer Service URL)” to “https://sso.samdesk.io/signin/sso/saml

  11. Click “Save”

  12. Under the “SAML Certificates” section download the “Certificate (Base64)”

  13. Under the “Set up samdesk” section copy the values for “Login URL” and “Microsoft Entra Identifier” (we will need these in the next section)

Configure samdesk

Next we can configure the SAML integration on the samdesk side

  1. In the samdesk application, navigate to Settings > Account Settings > Security

  2. Scroll down to the “SAML Authentication” section and enable it

  3. Set “Identity Provider Single Sign-On URL” to the “Login URL” value copied from above

  4. Set “Identity Provider Issuer” to the “Microsoft Entra Identifier” value copied from above

  5. Set “Certificate” to the contents of the “Certificate (Base64)” file that was downloaded

Granting User Access

By default only users that have been given explicit permission will be allowed to use SAML sign-on

  1. Navigate to the samdesk SAML app in Azure and click “Users and groups” in the left navigation

  2. From here click “Add user/group” in the top-left corner to add users and groups

Testing

Everything should now be properly configured

  1. You can test the Identity Provider Initiated flow by using the “Test single sign-on with samdesk” button at the bottom of the “Single sign-on” configuration page for the samdesk SAML app in Azure

  2. You can test the Service Provider Initiated flow by navigating to https://dash.samdesk.io, clicking “Sign in with SSO”, then providing your email address (which must match the one used in Azure)

Troubleshooting

If you have any issues setting up SAML with Azure please contact your customer success manager or email support@samdesk.io and we will be happy to help.

Did this answer your question?