Search Results :

×

Configure NextCloud Single Sign-On (SSO) with Joomla OAuth Client Plugin

This guide provides a detailed walkthrough for configuring our Joomla OAuth Client extension to enable user login via your own self-hosted Nextcloud instance. This integration is ideal for organizations and individuals who prioritize data sovereignty and want to use their private Nextcloud user base for website authentication.

By connecting Joomla to Nextcloud, you can create a seamless Single Sign-On (SSO) system. Your users can log in to your Joomla site using the same trusted credentials they use for your private cloud platform, eliminating the need for separate passwords. This approach ensures that user authentication is handled entirely within your own trusted infrastructure.


This guide will walk you through configuring our Joomla OAuth Client extension to connect with miniOrange as your Identity Provider (IdP). This setup enables secure Single Sign-On (SSO), allowing your users to log into your Joomla site using their existing NextCloud credentials.

This integration is designed for organizations that use NextCloud as their central identity and access management solution.

  • Login into your Joomla site’s Administrator console.
  • From left toggle menu, click on System, then under Install section click on Extensions.
  • Now click on Or Browse for file button to locate and install the plugin file downloaded earlier.
  • Installation of plugin is successful. Now click on Get Started!
  • Under Configure OAuth -> Pre-Configured Apps tab, select your OAuth Provider. You can also search for custom OAuth or custom OpenID application in the search bar, and configure your own custom provider.
Get Started with OAuth Client Setup

  • After selecting your OAuth provider, you will be redirected to the Step 1 [Redirect URL] tab. Now copy the Callback/Redirect URL which we will use to configure the OAuth Server, then click on the Save & Next button.
Get Started with OAuth Client Setup

  • Sign in with an administrator account to your Nextcloud server.
  • Open the menu in the top-right corner and select the Administrator Settings. On the next page, select the Security in the "Administration" section on the left.
NextCloud Dashboard

  • At the bottom of the page you see the list of Registered clients, (which is empty initially). Below "Add client", enter the name of your OAuth Client in the first field (Name). Note that the name that you enter here will be displayed to your client users.
  • In the second field (Redirection URI), enter the URL of your OAuth Client which we copied earlier.
Add application details

  • Click Add to save.
Save App

  • Go back to your Joomla Dashboard. Then go to Step 2 [Client ID & Secret].
  • Paste the Client ID, Client Secret and Domain. Also Set Client Credentials In Header and Body then click on Save Settings. Once Settings are saved then click on Save Configuration.
Upload IdP
    Metadata

  • Scope & Endpoints are given below, which are required for configuring Joomla as OAuth Client plugin to configure miniOrange as a custom OAuth or OIDC provider.
Scope user:read:email
Authorize Endpoint https://< your-nextcloud-domain >/apps/oauth2/authorize
Access Token Endpoint https://< your-nextcloud-domain >/apps/oauth2/api/v1/token
Get User Info Endpoint https://< your-nextcloud-domain >/ocs/v2.php/cloud/user?format=json
Set Client Credentials In Header and In Body

  • User Attribute Mapping is mandatory for enabling users to successfully login into Joomla. We will be setting up user profile attributes for Joomla using below settings.
  • Go to Step 3 [Attribute Mapping] tab and click on Test Configuration button.
Upload IdP
    Metadata

  • You will be able to see the attributes in the Test Configuration output as follows.
Upload IdP
    Metadata

  • Now go to the Step 3 [Attribute Mapping] tab and Select the attribute name for Email and Username from dropdown. Then click on Finish Configuration button.
Upload IdP
    Metadata

  • Now go to Step 4 [SSO URL] tab, here copy the Login/SSO URL and add it to your Site by following the given steps.
Upload IdP
    Metadata

  • 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.


ADFS_sso ×
Hello there!

Need Help? We are right here!

support