Connecting Mosaic with Microsoft Azure

Initial Setup with Microsoft Azure SAML

  1. On the Welcome to Azure! page, find the Enterprise applications option.
182182
  1. Click on the Enterprise applications option and click on New application.
290290
  1. Click on the Create your own application button.
754754
  1. Input a name that is easily identifiable and select Integrate any other application you don't find in the gallery (Non-gallery).
10361036
  1. Once the app has been created by Azure, navigate to the Single sign-on menu.
19821982
  1. Go to Mosaic settingsSecuritySAML 2.0 Single Sign On

🚧

Please Note:

Only admins are able to access the “Security“ tab on Mosaic settings

27162716
  1. On Mosaic’s SAML 2.0 Single Sign On menu, fill in:
  • Domain:
    • Domain associated with Microsoft Azure.

🚧

Please Note:

The email associated with the admin (who is setting up the SAML) must have the same domain as the one being inputted.

  • For example, if the admin uses an email [email protected], the only domain the admin could input is thisisdomain.com.
  • SSO URL:
    • Copy from App Federation Metadata Url under SAML Signing Certificate in Step #3.
  • Certificate:
    • Download Certificate (Base64) under SAML Signing Certificate in Step #3.
    • Open downloaded certificate with a text editor of choice.
    • Copy the full content of the certificate.
13141314
  1. Copy and paste ACS URL and Entity ID from Mosaic’s SAML 2.0 Single Sign On menu to Microsoft Azure’s Basic SAML Configuration section; all other fields can remain untouched.
15121512
  1. Next, click on Attributes & Claims and then Add new claim.
432432
  • Add the following additional attributes:
    a. email
884884

b. first_name

884884

c. last_name

884884
  1. Add users to the SAML app through the Users and groups menu.
13441344
  1. Next, go back to Mosaic and click Done.
13141314
  • Upon successful activation, SAML 2.0 Single Sign On will have the following options.
17281728
  1. Next time a user with an email address belonging to the specified domain logs into Mosaic, they will be redirected to authenticate with Microsoft Azure the moment they click Next after inputting their email.
27282728