Liferay Authentication with OAuth2 — Complete Guide

 Modern applications rarely authenticate users directly.

They delegate authentication to trusted identity providers like Google, Azure AD, or Keycloak using OAuth2.

In Liferay, OAuth2 allows secure Single Sign-On (SSO) across microservices and external apps.

This guide explains how OAuth2 works in Liferay and how to configure it.

📌 What is OAuth2 in Liferay?

OAuth2 enables:

  • External login (Google / Azure / IdP)

  • Secure API access

  • Token-based authentication

  • Decoupled frontend & backend

Instead of sending passwords → apps exchange access tokens.

🖼️ OAuth2 Authentication Flow

🧠 OAuth2 Roles

RoleDescription
Resource OwnerUser
ClientLiferay
Authorization ServerIdentity Provider
Resource ServerAPIs

🛠 Step 1 — Enable OAuth2 in Liferay

Go to:

Control Panel → Security → OAuth2 Administration

Create a new OAuth2 Application.

🛠 Step 2 — Configure Client

Fill:

  • Name

  • Client ID

  • Client Secret

  • Redirect URI

Example:

http://localhost:8080/c/portal/oauth2/redirect

🖼️ OAuth2 Configuration

🛠 Step 3 — Configure Identity Provider

Example Keycloak:

Valid Redirect URI:
http://localhost:8080/*

Scopes:

openid profile email

🛠 Step 4 — Map User Attributes

Map IdP fields → Liferay user:

IdP FieldLiferay
emailemailAddress
given_namefirstName
family_namelastName

🧠 Step 5 — Access Token Usage

After login Liferay receives:

access_token
refresh_token
id_token

Use token in APIs:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9

🖼️ Token Example

⚠️ Common Issues

Invalid redirect URI

Must match exactly

User not created

Attribute mapping missing

Login loop

Clock difference between servers

Token rejected

Wrong audience / scope

🔐 Security Best Practices

✔ Use HTTPS only
✔ Short token expiry
✔ Use refresh tokens
✔ Restrict scopes
✔ Sync server time (NTP)

📚 Related Articles

These help build secure enterprise architectures.

🎯 Conclusion

OAuth2 integration makes Liferay enterprise-ready:

  • Centralized authentication

  • Secure APIs

  • Scalable microservices access

Once configured correctly, users can log in seamlessly across all connected applications.

💼 Professional Support Available

If you are facing issues in real projects related to enterprise backend development or workflow automation, I provide paid consulting, production debugging, project support, and focused trainings.

Technologies covered include Java, Spring Boot, PL/SQL, CMS, Azure, and workflow automation (jBPM, Camunda BPM, RHPAM).


🎥 Learn IT with Shikha on YouTube

Prefer learning through videos? Watch practical tutorials on Kafka, Camunda, Alfresco, Java, Spring Boot, Microservices and Enterprise Architecture.

▶ Subscribe to Learn IT with Shikha on YouTube

Comments

Post a Comment

Popular posts from this blog

Top 50 Camunda BPM Interview Questions and Answers for Developers (2026 Guide)

Image
  Top 50 Camunda BPM Interview Questions and Answers for Developers (2026 Guide) Introduction Camunda BPM is one of the most widely used workflow automation platforms for building process-driven applications using BPMN, DMN, and microservices architecture . Many companies use Camunda for: Business process automation Microservices orchestration Workflow management Enterprise integration Because of its growing popularity, Camunda BPM interview questions are frequently asked in Java developer interviews . In this guide, we cover 50 important Camunda BPM interview questions and answers ranging from beginner to advanced levels .
Read more

10 BPMN Best Practices Every Camunda Developer Should Know

Image
  10 BPMN Best Practices Every Camunda Developer Should Know Designing BPMN processes in Camunda is easy—but designing them correctly, scalable, and maintainable is what separates beginners from experts. In this guide, you’ll learn 10 essential BPMN best practices that every Camunda developer should follow. 🔹 1. Keep Your Process Simple Avoid overcomplicating diagrams. 👉 A simple process is: Easier to debug Easier to maintain Easier for business users to understand 🔹 2. Use Meaningful Names Bad: Task1 ProcessA Good: Validate Customer Data Approve Loan Request 👉 Always use verb + business context 🔹 3. Use Async Continuations Wisely Use: asyncBefore asyncAfter 👉 Helps in: Retry handling Transaction boundaries Avoiding long DB locks 🔹 4. Avoid Long-Running Service Tasks Problem: Blocks Job Executor Solution: 👉 Use External Tasks for: API calls Heavy processing 🔹 5. Use Exclusive Gateways Properly 👉 Always define conditions clearly Avoid: Multiple true conditions Missing d...
Read more

OOPs Concepts in Java | English | Object Oriented Programming Explained

Image
🔹OOPS (Object Oriented Programming System) in Java Object-Oriented Programming (OOPS) is a programming paradigm that uses classes and objects to design software. It simplifies development and maintenance by applying key concepts: 📌 Class: Class   is a user-defined data type which defines its properties and its functions. Class is the only logical representation of the data. For example, Human beings in an organisation is a class like Employee. The age, name, department, salary etc. of a human being/employee are its properties, and the jobs performed by the employees in an organisation are known as functions.  The class does not occupy any memory space till the time an object is instantiated. A class is a user-defined data type that defines properties and functions. For example: Class: Employee Properties: name, age, salary Functions: work(), attendMeeting() A class does not occupy memory until an object is created. ...
Read more