Joomla OAuth-klientintegrering med Keycloak Single Sign-On (SSO)

Översikt

Joomla OAuth Client-plugin använder OAuth-protokollet för att ge säker åtkomst till Joomla-webbplatser genom att aktivera Keycloak som OAuth-leverantör, vilket förenklar inloggningsprocessen. Denna integration tillåter användare att logga in med sina Keycloak-uppgifter, vilket eliminerar behovet av flera lösenord. Insticksprogrammet innehåller också kartläggning av användarprofilattribut och rollmappning för åtkomst baserat på organisatoriska roller. För mer information om funktionerna i Joomla OAuth & OpenID Connect Client-plugin, besök vår sida här.. Följ stegen nedan för att konfigurera Keycloak OAuth SSO med Joomla.

För att ställa in OAuth Single Sign-On mellan Joomla och Keycloak kan du också följa detta steg för steg Inställningsvideo.

Konfigurationssteg

I den här konfigurationen, nyckelmantel fungerar som OAuth-server, medan Joomla tillåter användare att logga in med sina Keycloak-uppgifter genom att använda Joomla OAuth Client Plugin.

Steg 1: Installera Joomla OAuth Client Plugin

Logga in på din Joomla-sajt Administratör konsol.
Från vänster växlingsmeny, klicka på Systemkrav, klicka sedan på under Installera förlängningar.
Klicka nu på Eller bläddra efter fil för att hitta och installera plugin-filen som laddades ner tidigare.
Installationen av plugin har lyckats. Klicka nu på Kom igång!
Enligt Konfigurera OAuth -> Förkonfigurerade appar fliken, välj din OAuth-leverantörDu kan också konfigurera din egen anpassade leverantör genom att navigera till Custom Application fliken.

När du har valt din OAuth-leverantör kopierar du Callback/Redirect URL som vi ska använda för att konfigurera OAuth-servern, klicka sedan på Spara & Nästa knapp.

Steg 2: Konfigurera Keycloak som OAuth-leverantör

Version 18 och senare
Version 19 och senare

Starta server: Starta keycloak-servern genom att köra filen _standalone.sh_
Rotkatalogen för keycloak/bin/standalone.sh
Lägg till rike: Logga nu in på keycloak-administrationskonsolen och navigera till önskat område. Du kan lägga till ny sfär genom att välja alternativet Lägg till rike.

Skapa rike: Ange Realm Name och klicka på CREATE för att lägga till realm.

Ange nu visningsnamnet och klicka på knappen Spara.

Navigera till fliken Klienter och klicka på knappen Skapa.

Ange klient-ID och klicka på knappen Spara.

Klistra in den tidigare kopierade återuppringnings-/omdirigeringsadressen i textfältet Giltiga omdirigeringsadresser och klicka på knappen Spara.

Ange URL för återuppringning/omdirigering

Gå till fliken Inloggningsuppgifter och kopiera hemligheten. Detta kommer att vara din klienthemlighet i Joomla OAuth-plugin.

Lägg till rike: Logga nu in på keycloak-administrationskonsolen och navigera till önskat område. Du kan lägga till ny sfär genom att välja alternativet Skapa rike.

Skapa rike: Ange Realm Name och ha sfärens namn till hands eftersom det kommer att krävas senare för att konfigurera Realm under OAuth Client-plugin. Klicka på SKAPA för att lägga till rike.

Skapa OpenID-klient: Klicka på klienterna och välj Skapa klient för att skapa en ny klient.

Ange klient-ID och välj klientprotokoll OpenID-connect och klicka på Nästa.

Aktivera växeln för klientautentisering och auktorisering och klicka på Nästa.

Aktivera klientautentisering och auktorisering

Rulla ner till Access-inställningarna och ange din Callback/Redirect URL som du får från din miniOrange plugin som finns på din klientsida under CallBack URLs textfältet.

Ange din URL för återuppringning/omdirigering

Gå till fliken Inloggningsuppgifter, kopiera klienthemligheten och ha den till hands eftersom vi kommer att kräva den senare medan vi konfigurerar Joomla OAuth Single Sign-On-plugin.

Steg 3: Konfigurera klient-ID och hemlighet

Gå tillbaka till din Joomla instrumentpanel. Gå sedan till steg 2 i Konfigurera OAuth fliken.
Klistra in Klient-ID, klienthemlighet och sfär. Ställ även in klientuppgifter I rubrik och brödtext klicka sedan på Spara inställningar. När inställningarna har sparats klickar du på Spara konfiguration.

Omfattning	openid e-postprofil
Auktorisera slutpunkt	/realms/{realm-name}/protocol/openid-connect/auth
Åtkomst Token Endpoint	/realms/{realm-name}/protocol/openid-connect/token
Få användarinformation slutpunkt	/realms/{realm-name}/protocol/openid-connect/userInfo
Ställ in klientuppgifter	I båda (i sidhuvud och brödtext)
Identifierings-URL (för att se konfigurationsvärden)	{domännamn}/realms/{realm-name}/.well-known/openid-configuration

Steg 4: Konfigurera attributmappning

Mappning av användarattribut är obligatorisk för att användarna ska kunna logga in på Joomla. Vi kommer att ställa in användarprofilattribut för Joomla med inställningarna nedan.
Gå till steg 3 i Konfigurera OAuth fliken och klicka på Testa konfiguration knapp.

Du kommer att kunna se attributen i testkonfigurationsutgången enligt följande.

Välj nu attributnamnet för E-post och användarnamn från rullgardinsmenyn. Klicka sedan på Slutför konfigurationen knapp.

Steg 5: Ställ in inloggnings-/SSO-URL

Gå nu till steg 4, kopiera här Inloggnings-/SSO-URL och lägg till den på din webbplats.

Logga nu ut och gå till din Joomla-sajts sidor där du har lagt till denna länk. Du kommer att se en inloggningslänk där du placerade den knappen. Klicka på den här knappen för att utföra SSO.

Innehåll