Guide for Joomla SAML 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 and login with your miniOrange credentials.
  • From the left menu, go to Apps Manage Apps.
  • joomla saml
  • In the right upper corner, select Add Application.
  • joomla saml plugin
  • In the search apps textbox, type Joomla. Select Joomla(SAML) and click on Add App.
  • Joomla saml sso
  • 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.
    Joomla sso saml

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.
  • joomla saml extenstions
  • From the Configured App list, search your application name you just added and click on the Metadata link.
  • joomla saml sp
  • Click on the Download Metadata button.
  • joomla saml idp

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:
    • joomla saml single sign onBy Uploading miniOrange Metadata File :

      • Click on Upload IDP Metadata.
      • joomla saml metadata
      • Choose metadata file you just downloaded and click on Upload.
      • joomla saml urls

      joomla saml acsManual 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.

      joomla saml miniorange Add a button on your site login page with the following URL:

      • Click on Save Configuration button.
      • joomla saml Signin Settings

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)
    Joomla saml 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.
  • Joomla saml Group_Role_Mapping

Step 6: Redirection & SSO Links.

  • Go to Login Settings 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.
  • joomla saml Signin Settings

You have successfully Installed and Configured plugin

Miniorange Joomla SAML Single sign-on(web SSO) supports multiple known IDPs like ADFS, Azure AD, Salesforce, Shibboleth, Onelogin, Okta, SimpleSamlPhp, Google apps, Bitium, OpenAM, miniorange IDP, Centrify and many more.

Business Trial For Free

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