Search Results :


Joomla OAuth Client Integration with GitHub Single Sign-On (SSO)

Set up Single Sign-On (SSO) on your Joomla site via GitHub OAuth provider with the help of Joomla OAuth & OpenID Connect plugin. Integrating GitHub Single Sign-On (SSO) into Joomla using OAuth 2.0 authentication protocol allows your users to securely login into your Joomla websites and applications by authenticating with GitHub OAuth provider. The GitHub OAuth Joomla plugin also provides advanced features such as, Auto create users, Attribute Mapping, Group Mapping etc. Visit our Joomla OAuth Client Plugin page to learn more about the features and Pricing plans we offer for the Joomla OAuth Single Sign-on (OAuth & OpenID connect) plugin.

Pre-requisites : Download And Installation

Setup GitHub as OAuth Provider with Joomla OAuth Client

Follow the steps given below to setup the Joomla OAuth Client plugin. You can also refer to this Setup video for configuring the plugin.

1. Download and Setup Joomla OAuth Client

  • Download the zip file for the miniOrange OAuth Client plugin for Joomla.
  • Login into your Joomla site’s administrator console.
  • From left toggle menu, click on System, then under Install section click on Extension.
  • Upload the downloaded zip file to install the Joomla OAuth Client plugin.
  • Installation of the plugin is successful. Now click on Start Using miniOrange OAuth Client plugin.
  • Under Configure OAuth tab. Select GitHub as an OAuth Provider.
  • GitHub Single Sign-On (SSO) OAuth/OpenID-addapp-shortcut
  • Now copy the Callback / Redirect URL which is needed while configuring GitHub as OAuth Server.
  • GitHub Single Sign-On (SSO) OAuth/OpenID-addapp-shortcut

2. Configure GitHub as OAuth Provider

  • First of all, go to GitHub and log into your GitHub account.
  • You will be presented with the following screen. Click on Register a new application
  • Joomla GitHub OAuth SSO Integration, register app
  • You will be shown a form where you have to enter Application Name and Callback URI which is copied from here. Fill the form with appropriate information and click on the Register Application.
  • Joomla GitHub OAuth SSO Integration, Enter appnameURL

    NOTE: Callback URI is the URI where the user will be sent after authorization.

  • After registering the application, you will be given Client ID and Client Secret.
  • Joomla GitHub OAuth SSO Integration, get clientidsecret
  • Copy these credentials in Joomla OAuth Client Plugin configuration on corresponding fields.

3. Integrating Joomla with GitHub

  • Go back to your Joomla Dashboard. Then go to Components.
  • Now go to the Joomla OAuth Client plugin, under Configure OAuth tab, enter the all the details. Then click on Save Settings and then click on Test Configuration.
  • GitHub Single Sign-On (SSO) OAuth/OpenID

    GitHub Endpoints and Scope:

    Client ID : from the above step
    Client Secret : from the above step
    Scope: user repo
    Authorize Endpoint:
    Access Token Endpoint:
    Get User Info Endpoint:
    Set Client Credentials: In Both (In Header and In Body)

4. User Attribute Mapping

  • Once you click on Test Configuration button, You will be able to see the attributes in the Test Configuration output as follows.
  •  GitHub Single Sign-On (SSO) OAuth/OpenID
  • Now go back to Joomla OAuth Client plugin.
  • Go to the Attribute Mapping section in the plugin and map the Attribute Names from the Test Configuration table. Now enter Group Attribute name on the given field. (Refer to the screenshot)
  •  GitHub Single Sign-On (SSO) OAuth/OpenID

    5. Role/Group mapping [Premium]

    • Now go to the Role Mapping tab. Here make sure that Enable Role Mapping is checked. Now assign the Group/Role names to the desired groups in Joomla, then click on Save Role Mapping Settings button.
    •  GitHub Single Sign-On (SSO) OAuth/OpenID

    6. Login Settings

  • Now you can use Login / SSO URL to perform SSO.
  •  GitHub Single Sign-On (SSO) OAuth/OpenID
  • Now logout and go to your Joomla site's pages where you have added this link. You will see a login link where you placed that button. Click on this button to perform SSO.
  • Congratulations, you have successfully configured the miniOrange OAuth Client plugin with your GitHub OAuth Provider.
  • Click on the Upgrade Plans tab to check out our complete list of features and various licensing plans. OR you can click here to check features and licensing plans.
  • If you want to purchase any of the paid version of the plugin, you have to register/login with us in Account Setup tab. OR you can register/login Here .
  • In case, you are facing some issue or have any question in mind, you can reach out to us by sending us your query through the Support button in the plugin or by sending us a mail at

7. Supported Grant Types

  • Authorization Grant
  • Implicit Grant
  • Client Credentials

You have successfully configured Joomla as OAuth Client for achieving Joomla GitHub Single Sign-On (SSO) with Joomla for user authentication.

In this guide, you have successfully configured Joomla GitHub Single Sign-On (SSO) by configuring GitHub as OAuth Provider and Joomla as OAuth Client using our Joomla OAuth Client plugin.This solution ensures that you are ready to roll out secure access to your Joomla site using GitHub login credentials within minutes.

Additional Resources

Mail us on for quick guidance(via email/meeting) on your requirement and our team will help you to select the best suitable solution/plan as per your requirement.

Hello there!

Need Help? We are right here!

Contact miniOrange Support

Thanks for your inquiry.

If you dont hear from us within 24 hours, please feel free to send a follow up email to