Single Sign On

Single Sign On (SSO)

SSO stands for Single Sign On. It means that a single set of credentials can be used to log into different applications. This empowers the employees to access a MoEngage dashboard using the company credentials. 

Some benefits of using SSO:

  • Increased security and less risk of accounts being compromised
  • Reduced password fatigue from managing different credentials
  • Simplified authentication by using the known access directory 

 

MoEngage supports SSO

MoEngage supports SSO via SAML 2.0 and acts as a service provider (SP) for SSO. SAML is an industry-standard protocol that allows delegation of authentication of users, similar to OAuth2.  

When a user tries to login, the user is then redirected to the customer's internal or external SSO system where the authentication is performed and then returned back to MoEngage where the response is verified. 

A high-level diagram of the SSO sign-in process is shown below:

 Screenshot_2019-10-16_at_2.35.35_PM.png 

 

Important - Only admins can enable or configure single sign-on on MoEngage. 

 

Enable SSO for your account 

1. Navigate to Settings > Security Settings 

      Screenshot_2019-10-16_at_2.35.42_PM.png

2. Click on enable SSO 

Screenshot_2019-11-04_at_2.14.47_PM.png

3. Raise a request with the support team to enable SSO for your account. 

Once your request is approved, 

4. Select the identity provider -Screenshot_2019-11-04_at_2.14.55_PM.png

 

MoEngage currently supports the following IdPs:

Even if your identity provider is not listed here, it should work with any 
SAML 2.0 compliant provider.

Select other from the identity provider list and configure your IdP. 

 

Single Sign On: Okta 

In order to set up SSO using Okta:

  • You must be an org admin for your organization in MoEngage.
  • You must be able to configure your organization in Okta.

Now follow these setup steps:

  1. Go to the Okta admin dashboard and click "Add Applications".

    an_okta_1_admin.png

  2. On the Add Application page click "Create New App".

    an_okta_2_create_app.png

  3. In the popup select "SAML 2.0".

    an_okta_3_saml2.png

  4. Enter a name for the app and optionally upload a logo for easier recognition.

    an_okta_4_name.png

  5. On the next step you will need to enter the "Single sign on URL" (ACS URL) and "Audience URI" (Entity Id).  You also need to change the "Application username" to "Email".

    Screenshot_2019-11-04_at_1.05.03_PM.png

  6. For the Entity ID and ACS URL, choose Okta as your identity provider in the SSO settings on MoEngage and copy-paste the details in the Okta.   Screenshot_2019-11-04_at_1.13.15_PM.png

  7. After creating the app you can download the Identity Provider metadata.

Screenshot_2019-11-05_at_12.42.11_PM.png

 

8. On MoEngage, paste the metadata and click Continue. 

10. Click enable to enable SSO via Okta. 

Screenshot_2019-11-04_at_1.14.38_PM.png

11. Confirm and choose to inform the teammates about the new login process

Screenshot_2019-11-14_at_1.13.02_PM.png

Congratulations!! Single Sign On configured successfully for the app. 

 

Single Sign On: Google

In order to set up SSO:

  • You must be an admin for your app in MoEngage.
  • You must be an administrator for your G Suite organization.

Now, follow these setup steps:

  1. Go to the Apps section in the G Suite admin console and select "SAML apps".

    an_gsuite_1_apps.png

  2. Click the + button in the bottom left to add a SAML app.

    Screenshot_2019-11-05_at_2.27.30_PM.png

  3. In the popup click the option to create a custom app.

    Screenshot_2019-11-05_at_2.31.09_PM.png

  4. Continue through the app creation. Enter a name and description and optionally upload the logo for easy recognition.

    Screenshot_2019-11-05_at_2.32.02_PM.png

  5. On the next step, you will be prompted for the "ACS URL" and "Entity ID".

    Screenshot_2019-11-05_at_2.32.57_PM.png

  6. For the Entity ID and ACS URL, choose Google as your identity provider in the SSO settings on MoEngage and paste the details in the Google console.  Screenshot_2019-11-04_at_1.21.35_PM.png

  7. For the name id format in google portal - select 'email' from the drop-down. 
  8. On the final step just click "Finish" to save the app.

    Screenshot_2019-11-05_at_2.33.41_PM.png

  9. Download the IDP metadata.

    Screenshot_2019-11-05_at_2.34.22_PM.png

  10. Upload the metadata file in MoEngage and click 'Save' 

    Screenshot_2019-11-04_at_1.23.54_PM.png

  11. Click enable to enable SSO via Google. Screenshot_2019-11-04_at_1.28.29_PM.png

  12. Confirm and choose to inform the teammates about the new login process

    Screenshot_2019-11-14_at_1.13.02_PM.png

    Congratulations!! Single Sign On configured successfully for your app.

     

Single Sign On: One Login

In order to set up SSO for one login:

  • You must be an org admin for your account in MoEngage.
  • You must be able to configure the organization in OneLogin.

Then follow these setup steps:

  1. On the OneLogin portal,  go to Applications and click add App option.Screenshot_2019-11-14_at_2.14.30_PM.png

  2. Search for SAML and select "SAML Test Connector (IdP w/ attr w/ sign response) "

  3. Enter the name "MoEngage" and save the app.

  4. In the configuration sections of this app, fill out the form. 

  5. For the form, choose OneLogin as your identity provider in the SSO settings on MoEngage and paste the details (Audiences, ACS (Consumer) URL Validator, ACS Consumer URL and Single Sign Out URL) in the OneLogin portal. Click Save. Screenshot_2019-11-14_at_1.24.35_PM.png

  6. From the menu 'More Actions' and select SAML metadata. A file would be downloaded. Screenshot_2019-11-14_at_1.34.19_PM.png

  7. Upload the metadata file in MoEngage and click 'Save' 

    Screenshot_2019-11-04_at_1.23.54_PM.png

  8. Click enable to enable SSO via OneLogin. 

  9. Confirm and choose to inform the teammates about the new login processScreenshot_2019-11-14_at_1.13.02_PM.pngCongratulations!! Single Sign On configured successfully for your app. 

     

     

New Login Process

  1. Select 'Login using SSO' on the login screen 

     Screenshot_2019-10-16_at_12.27.24_PM.png

 

  1. Enter your email address 

    Screenshot_2019-10-16_at_12.27.37_PM.png



Frequently Faced Issues

1. Are you facing an issue while logging in?

Screenshot_2019-10-16_at_2.55.10_PM.png

 Authentication Failed?

This generally happens when the SAML authentication with the Identity Provider fails. Please reach out to your identity provider for details. 

Still facing the error?

Don’t worry! MoEngage supports a backdoor entry for the admin. The admin can log in using an email id - password combination. Admin can go back to the Single Sign On screen (Go to settings > Security Settings) and disable SSO. 

   

2. Are you facing an issue while uploading the config file? Screenshot_2019-11-14_at_2.17.20_PM.png

 

This generally happens when the uploaded XML file is invalid. Please try again with the correct XML file. If the issue persists, please check with your identity provider. 

 

Enable SSO for my account

Are you interested in configuring Single Sign-On for your account? Please click here to raise a request. 

 

 

 

Was this article helpful?
2 out of 2 found this helpful