Guide to Configure Instagram as an OAuth/OpenId Connect Server with Joomla Client

Step 1: Configure Instagram as an OAuth/OpenId Connect Server

  • Go to https://www.instagram.com/developer and Sign Up/Login to register a new app.
  • Click on Register Your Application button.
  • OpenId Connect_sso_Register Your Application
  • Enter your website URL and phone number under the Your Website and Phone Number text fields respectively. Click on the sign-up button to continue.

    This step completes your sign up to a developer account.

    OpenId Connect_sso_sign-up button
  • Click on Register your Application button again and then go to Manage Clients Register a New Client as shown in the image below:

    OpenId Connect_sso_Register your Application button again
  • Enter your Application Name, Description, Company name, website URL, Contact Email etc. Copy the Redirect/ Callback URl from your miniOrange OAuth Client Plugin/module and save it under the Valid Redirect URLs text field. Finally, click on the Register button to save your configurations.

    OpenId Connect_sso_Register button to save your configurations
  • Click on the Manage button to view your Client ID and Client Secret.

    OpenId Connect_sso_Click on the Manage button
  • Copy the Client ID and Client Secret and save it in your miniOrange OAuth Client plugin/module under the Client ID and the Client Secret text fields respectively.

    OpenId Connect_sso_Client ID
  • Click on the Security tab and uncheck the Disable Implicit OAuth option. Click on the Update Client button to save your changes.

    OpenId Connect_sso_button to save your changes

You have successfully completed your Instagram OAuth Server-side configurations. Still, if you are facing any difficulty please mail us on info@miniorange.com

Step 2: Setting up the miniOrange Joomla OAuth Client plugin

  • Download the zip file for the miniOrange OAuth Client plugin for Joomla from here.

  • Login into your Joomla site’s administrator console.
  • Go to Extension Manage Install in the top navigation bar to install the plugin.

    OpenId Connect_sso_image
  • Upload the downloaded zip file to install the OAuth Client plugin.

    OpenId Connect_sso_navigation bar to install the plugin
  • Navigate to Extensions Manage Manage and search for miniorange in the Search bar provided to see the list of the components.

  • Enable all the below shown components of the plugin in order to continue using the plugin.

    OpenId Connect_sso_search for miniorange in the Search bar
  • Go to Components MiniOrange OAuth Client in the top navigation bar to go to the configuration page of the plugin.

    OpenId Connect_sso_Go to Components
  • Register/ Login with miniOrange.

    OpenId Connect_sso_Register/Login
  • Go to the Configure OAuth tab in the plugin. Fill the details you received from your OAuth Provider and click on the Save Settings button.

    OpenId Connect_sso_Fill the details you received from your OAuth Provider

    Select your OAuth Provider from the Select Application dropdown. In case your OAuth Provider is not listed in the drop down, please select Custom OAuth Provider to continue.
  • Copy the Redirect/Callback URL given in the plugin and save it in your OAuth Provider.
  • Click on the Test Configuration button and copy the email and name attributes and save these attributes in Email Attribute and Name Attribute text field respectively. Now click on the Save Attribute Mapping button to save your configurations.

    OpenId Connect_sso_button to save your configurations
  • Add a button on your site login page with the following
    URL: <your_home_page/base_url>/?morequest=oauthredirect&app_name=<xxxxxxx>
    You would find appropriate URL in Instructions to configure in the below section of Attribute Mapping (After completing test configuration please choose URL and Add a button on your site login page).
  • Now logout and go to your site. You will see a login link where you placed that button.
  • Click on the Licensing Plans Tab to check out our complete list of features and various licensing plans.
  • 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 dialog box in the Account Setup and Configure OAuth tabs.

    OpenId Connect_sso_Support tab
  • Congratulations, you have successfully configured the miniOrange OAuth Client plugin with your desired OAuth Provider. In case you have any questions in mind, you can always mail us at info@miniorange.com.