Guide for Joomla Single Sign On (SSO) using miniOrange as IdP

>miniOrange Single Sign On (SSO) for Joomla miniOrange provides a ready to use solution for Joomla. This solution ensures that you are ready to roll out secure access to your Joomla site using miniOrange within minutes.

Step 1: Configuring miniOrange as Identity Provider(IdP)

  • Go to miniOrange Admin console https://auth.miniorange.com/moas and login with your miniOrange credentials.
  • From the left menu, go to Apps Manage Apps.
    • apps-1
  • In the right upper corner, select Configure Apps.
    • config_apps
  • In the search apps textbox, type Joomla. Select Joomla(SAML) and click on Add App.
    • Joomla
  • Enter the following the textboxes.
    • Custom Application Name App name you like to provide. Eg. Joomla.
    SP Entity ID or Issuer Enter SP Entity ID / Issuer from the Service Provider Metadata tab of the plugin.
    ACS URL Enter ACS (AssertionConsumerService) URL from the Service Provider Metadata tab of the plugin.
    Name Id Select E-Mail Address as a Name Id from dropdown list.
    Joomla2

Step 2: Creating policy for the App

  • Select DEFAULT from the Group Name dropdown.
  • Enter Policy Name you would like to provide. Eg Joomla Policy.
  • Select Password from the First Factor Type dropdown.
  • Click on Save button to add the App.
    • add_policy
  • From the Configured App list, search your application name you just added and click on the Metadata link.
    • Joomla4
  • Click on the Download Metadata button.
    • metadata

Step 3: Configuring Joomla as Service Provider (SP)

  • In miniOrange SAML plugin, go to Service Provider Setup Tab. There are two ways to configure the plugin:

      • apps-1By Uploading miniOrange Metadata File :

      • Click on Upload IDP Metadata.
        • Upload_Metadata_btn
      • Choose metadata file you just downloaded and click on Upload.
        • Upload_Metadata_file

      apps-1Manual Configuration :

      • Provide the required settings (i.e. IdP Entity ID or Issuer, Single Sign-On Service URL, X.509 Certificate) and save it.
      IdP Entity ID or Issuer IdP Entity ID or Issuer URL from the APPS / VIEW IDP METADATA in miniOrange.
      Sigle Sing-On Service URL SAML Login URL from the APPS / VIEW IDP METADATA in miniOrange.
      X.509 Certificate Paste the X.509 Certificate APPS / VIEW IDP METADATA in miniOrange.

      apps-1 Add a button on your site login page with the following URL:

      Signin_Settings-1
  • Click on Save Configuration button.

Step 4: Attribute Mapping (It is Optional to fill this). This is Premium feature.

  • Attributes are user details that are stored in your Identity Provider.
  • Attribute Mapping helps you to get user attributes from your Identity Provider(IdP) and map them to Joomla user attributes like firstname, lastname etc.
  • While auto registering the users in your Joomla site these attributes will automatically get mapped to your Joomla user details.
  • In miniOrange SAML plugin, go to Attribute Mapping tab and fill in all the fields.
    • Username: Name of the username attribute from (IdP) (Keep NameID by default)
    Email: Name of the email attribute from IdP (Keep NameID by default)
    Group/Role: Name of the Role attribute from Identity Provider(IdP)
    Attribute_Mapping_Tab
  • You can check the Test Configuration Results under Service Provider Setup tab to get a better idea of which values to map here.

Step 5: Group Mapping (It is Optional to fill this). This is Premium feature.

  • Joomla uses a concept of Roles, designed to give the site owner the ability to control what users can and cannot do within the site.
  • Role mapping helps you to assign specific roles to users of a certain group in your Identity Provider(IdP).
  • While auto registering, the users are assigned roles based on the group they are mapped to.
    • Group_Role_Mapping

Step 6: Redirection & SSO Links.

  • Go to Redirection & SSO Links tab. There are multiple features availabe in this tab like Auto redirect the user to Identity Provider and Enable Backed Login for Super Users. To use these features, click on the respective checkboxes.
    • Signin_Settings

Business Trial For Free

If you don't find what you are looking for, please contact us at info@miniorange.com or call us at +1 978 658 9387.