How to set up Google SSO?

If your organization uses Google Workspace, we highly recommend enabling Google SSO in order to offer your users the simplest login experience in Motimate.

Setting up Google SSO with Motimate

  1. Log in to your Google Cloud Console with a Google Workspace Admin account.
  2. Go to OAuth Consent Screen in the menu on the left.
  3. If no Google Cloud Project has been selected, you will need to either need to click Select a project and pick which existing Google Cloud project you would like to use. Or you can click Create Project if you wish to create a new one.
    If you create a new project, we recommend the following Project settings:
    1. Project Name:
      Motimate SSO
    2. Project ID:
      motimate-sso (usually auto-generated)
    3. Organization:
      (the primary domain SSO will be used for, usually the default)
    4. Location:
      (your parent organization, usually default)
  4. After selecting your Google Cloud project, or creating a new one, make sure that you are back at the OAuth Consent Screen settings.
  5. You must now select Internal as User Type, and then click Create.
  6. Under App Information, fill out the following:
    1. App Name:
      Motimate
    2. User support email:
      (select your preferred from the drop-down menu)
    3. App Logo:
      Download and upload motimate_sso_logo.png
  7. Under App Domain, fill out the following:
    1. Application Home Page:
      https://{identifier}.web.motimateapp.com/
      (replace {identifier} with your organization's identifier. You'll easily see it in your URL when you log in to your Motimate account)
    2. Application Privacy Policy Link:
      https://www.motimateapp.com/privacy-policy/
    3. Application Terms of Service Link:
      (leave empty)
    4. Authorised domains: Click Add Domain, and and the following:
      motimateapp.com
      motimate.app
  8. Under Developer Contact Information, you should most likely add your own email address here and potentially any other internal email address. Google may contact these addresses if there are any changes required to your settings.
  9. Click Save and Continue when all the information is filled out.
  10. On the next page for Scopes settings, you do not need to add any scopes. Simply scroll down, and click Save and Continue again.
  11. Your OAuth Consent Screen has now been successfully set up, and you will see a Summary of all your settings. Please review that these are correct before moving on.
  12. Now go to Credentials in the menu to the left.
  13. Click Create Credentials at the very top of the screen, and select OAuth Client ID.
  14. On the next screen your Application Type should be set to Web Application.
  15. Set Name to Motimate (web).
  16. Under Authorised Redirect URIs, click Add URI and add the following:
    https://{identifier}.web.motimateapp.com/external-auth-completed
    https://{identifier}.motimateapp.com/admin/external-auth-completed
    Remember to replace {identifier} with your organization's identifier.
  17. Click Create when all the information has been filled out.
  18. You will now get a confirmation that your OAuth client was created. Simply click OK in this dialog box.
  19. Next you must click Create Credentials at the very top of the screen, and select Oauth Client ID again.
  20. This time you must set Application Type to iOS.
  21. Set Name to Motimate (mobile).
  22. Under Bundle ID, you should provide the following:
    com.motimate.Motimate.Training
  23. The App Store ID should be set to:
    id1195922910
  24. You can leave the field Team ID empty.
  25. Click Create when all the information has been filled out.
  26. You will now get a confirmation that your OAuth client was created. Simply click OK in this dialog box.
  27. You should now see an overview of your Credentials.
  28. You must now download the credentials for Motimate (mobile) and Motimate (web):
  29. The credentials for Motimate (mobile) will be downloaded in a *.plist file, and the credentials for Motimate (web) will be downloaded in a *.json file.
  30. Once the two files are downloaded, please email them to support@motimateapp.com and request Google SSO to be activated for your Motimate account. You can also send them directly to the Customer Success Manager who may be supporting you in your organization's onboarding process.
  31. We will activate Google SSO for your Motimate account shortly after we receive the credentials. Once activated all your users will be required to log in with SSO in order to get access to your Motimate account. Users already logged in, may be required to log out, and then log back in again.

Congratulations! You have now successfully enabled Google SSO for your organization.

Screenshots

Below are a few screenshots of the instructions above, if you prefer.

1) OAuth Consent Screen

2) OAuth Consent Screen - Scopes

3) Credentials - Client ID for Web

4) Credentials - Client ID for iOS