How to configure SSO integration with Okta

How to configure SSO integration with Okta

What is the issue you're facing?

I would like to configure integration between Market Dojo and Okta. How do I do this?

Solution

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 Okta

First of all, ensure that you have an Okta account, and have configured it for SSO.


From the Okta Dashboard, add an application (or find an existing one)


  • Configure the General settings as required, see below for an example

  • Ensure that the login redirect URI and Initiate login URI have the correct hostname and subdomain, and use the correct path. For example:-

https://<my-whitelabel-subdomain>.marketdojo.com/omniauth/okta/callback

https://<my-whitelabel-subdomain>.marketdojo.com/omniauth/okta/

...and if users may login from the category dojo login page....

https://<my-whitelabel-subdomain>.marketdojo.com/categorydojo/omniauth/okta/callback

https://<my-whitelabel-subdomain>.marketdojo.com/categorydojo/omniauth/okta/



  • Make a note of the client ID and client Secret.

  • Go to API > Authorization Servers > (click on the settings) > then click on edit button

  • This page will give you a link where you can get some additional configuration you will need later.






Below thing we need to Add From Admin > Integration > Okta 


  • Issuer is Header URL of  Okta followed by oauth2/default

  • Authorize URL is Header URL of  Okta followed by oauth2/v1/authorize

  • Site is Header URL of Okta 

  • Token URL is Url of okta followed by oauth2/v1/token



Add users to Okta

  • Add the users who you want to login with to Okta (on the users tab)

  • Make sure these users are activated (there is a button)

  • Make sure the users are assigned to the Market Dojo application (the one you configured above)


Configure Market Dojo
  • Login to your Market Dojo account 

  • Go to the Admin>Integrations page

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


Test this integration
  • Logout of Market Dojo

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

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

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


    • Related Articles

    • How to configure SSO integration using SAML

      What is the issue you're facing? I would like to configure SSO integration with Market Dojo using SAML Solution Understanding SAML This article explains how to integrate Market Dojo with SAML. It also explains the features that are, and are not ...
    • How to configure Integration with Google SSO

      What is the issue you're facing? I would like to know how to configure integration with Market Dojo using Google SSO. How do I do this? Solution Google SSO Integration with Google allows your team to sign in to Market Dojo using their Google ...
    • How to configure SSO integration with Azure Active Directory

      What is the issue you're facing? I would like to use SSO with Market Dojo and Azure Active Directory. How do I do this? Solution What does Azure Active Directory do? Azure is Microsofts Cloud. Active Directory allows organisations to administer ...
    • How to configure integration with Spend HQ (Per Angusta)

      If you use both Market Dojo and Spend HQ, 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 Spend HQ - report savings from Market ...
    • How can I enable integration with Per Angusta

      What is the issue you're facing? I would like to enable integration between Spend Key (Per Angusta) and Market Dojo. How can I do this? Solution If you use both Market Dojo and Per Angusta, you can enable integration between the two systems. This ...