Guide for Joomla Single Sign On (SSO) using Okta as Identity Provider (IdP)

Okta 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 Okta within minutes.

Step 1: Configuring Okta as Identity Provider (IdP)

  • Go to https://login.okta.com and login into Okta.
  • Log into Okta Admin Console.
  • Select Classic UI from top right of the dropdown.
  • classic_ui
  • Click on Add Applications.
  • add_application
  • Click on Create New App.
  • Click on the SAML 2.0.
  • configuresaml
  • In General Settings, enter App Name and click on Next.
  • In SAML Settings, enter the following:
  • samlsettings
    Single Sign On URL Enter ACS (AssertionConsumerService) URL from the Service Provider Metadata tab of the module.
    Audience URI (SP Entity ID) Enter SP Entity ID / Issuer from the Service Provider Metadata tab of the module.
    Default Relay State Enter Relay State from the Service Provider Metadata tab of the module.
    Name ID Format Select E-Mail Address as a Name Id from dropdown list.
    Application Username Okta username.
  • Configure Attribute Statements and Group Attribute Statement (Optional).
  • attributestatment1

Step 2: Assigning Groups/People

  • After creating and configuring the app go to the Assignment Tab in Okta.
  • Here we select the peoples and groups you want to give access to login through this app. Assign this to the people/group you would to give access to.
  • assign_groups
  • After assigning the people/groups to your app go to Sign On tab.
  • Click on view setup instructions to get the SAML Login URL (Single Sign on URL), Single Logout URL, IDP Entity ID and X.509 Certificate.
  • samlcertificate

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:
  • I. By Uploading Okta Metadata.xml file(Recommended):

      1. Click on Upload IDP Metadata.

      classic_ui 2. Choose metadata file and click on Upload.

      Upload_Metadata_file

    II. Manual Configuration :

    • In miniOrange SAML plugin, go to Service Provider Setup Tab. Enter the following values:
      IDP Entity ID Identity Provider Issuer from Okta Setup Instructions
      Single Sign-On Service URL Identity Provider Single Sign-On URL from Okta Setup Instructions
      X.509 Certificate X.509 Certifiacate from Okta Setup Instructions

    III. Add a button on your site login page with the following URL:


      Signin_Settings-1

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.