How to configure SSO integration using SAML

How to configure SSO integration using SAML

How to configure SSO integration using SAML

 

We are pleased to announce that you can integrate Market Dojo with SAML. SAML (Security Access Markup Language) is widely used to provide Single Sign On across different applications. 

What does SAML do?

Security Assertion Markup Language (SAML) is an open standard that allows identity providers (for example Okta, or Ping Identity) to pass authorisation credentials to service providers like Market Dojo.

By integrating with SAML, users can sign on to Market Dojo using their existing credentials. It helps IT teams to manage which users have access and is helpful when people join or leave their organisation.

The rest of this guide explains how to use SAML with Market Dojo.

Configure the Identity Provider

In this example we will use Ping Identity, but instructions will be similar for other solutions (e.g. Okta)

First of all, ensure that you have an administrator account with Ping

  1. Go to your company Ping Identity Portal

  2. Find the 'Connections'

  3. Click 'Add Application’, choose ‘Web App’ and then select the ‘SAML’ option

  4. Give the application a name, description and choose an icon.

  5. On the next page, choose the option to import metadata, import from URL. Enter the url as follows:-
    https://<your-whitelabelled-marketdojo-url>/omniauth/saml/metadata
    For example:-
    https://xyz.marketdojo.com/omniauth/saml/metadata

  6. Fill out the field ASSERTION VALIDITY DURATION (IN SECONDS)

  7. Fill out the field TARGET APPLICATION URL as follows:
    https://<your-whitelabelled-marketdojo-url>
    For example:-
    https://xyz.marketdojo.com

  8. Click Save and Continue

  9. On the next page, it is not necessary to map additional fields

  10. Save

  11. Toggle the option to enable the new application

  12. Go to the Configuration tab of the Application and make a note of
    - IDP Metadata url

Configure Market Dojo

  • Login to your Market Dojo account 

  • Go to the Admin>Integrations page

  • Click +SAML, and enter the settings you noted in the previous step

    • IDP Metadata url is entered into URL
      (note that either URL or XML Configuration File are entered. If you are using the XML file this should be the full text contents of the file, not a link to it.)

  • Ensure that you enable SAML as a permitted option for sign-in

 

Test this integration

  • Logout of Market Dojo

  • Go to the login page (be sure to use your white label domain)

  • You should see an option ‘Sign in with SAML, click it

  • If everything is configured correctly, you will be logged in


    • Related Articles

    • How to configure Integration with Google SSO

      Google SSO Integration with Google allows your team to sign in to Market Dojo using their Google accounts, and reduces the friction associated with logging in. Pre-requisites To enable the integration, you will need to have permission to administer ...
    • How to configure SSO integration with Okta

      What does Okta do? Okta allow organisations to adminster security centrally.  Here is an explainer video of what it means for end users: https://screencast.com/t/GKzEGtJF3VA9 The rest of this guide explains how to use Okta with Market Dojo. Configure ...
    • How to configure SSO integration with Azure Active Directory

      What does Azure Active Directory do? Azure is Microsofts Cloud. Active Directory allows organisations to administer security centrally.  By integrating with Azure, users can sign on to Market Dojo using their Microsoft credentials. It helps IT teams ...
    • How to configure integration with Per Angusta

      If you use both Market Dojo and Per Angusta, you can enable integration between the two systems. What this allows you to - move from one to the other without signing in again - create Market Dojo events from inside Per Angusta - report savings from ...
    • I have tried to sign up but it says my email has been taken so how should I proceeded.

      This usually happens when the person running the event has already registered you on your behalf. You may see a message like this: "Email has already been taken. Note: you may have already registered or a company you work with might have registered ...