Documentation

Securing Liferay

Liferay DXP is built with security in mind. This includes mitigation of common security vulnerabilities and exploits like those described by the OWASP Top 10 and the CWE/SANS Top 25.

There are several aspects of securing a Liferay installation—including, but not limited to, following the best security practices for your hosting environment, database, search provider, application server, and Liferay DXP itself.

Note

For example, Liferay DXP relies on the application server for sanitizing CRLF in HTTP headers. You must ensure this is configured properly on the application server. Skipping this configuration may result in security verification products, like Veracode, flagging false positives in security reports.

Here you’ll learn the basic elements to secure Liferay DXP. This includes configuring how users authenticate to your Liferay DXP installation, authorizing users with permissions, configuring secure access to Liferay DXP Web Services, and fine-tuning security features on an as-needed basis.

Important

Customers are advised to deploy security patches as they are released. For community and CE installations, we recommend always using the latest community release, which contains all previous security patches.

Authentication

Liferay DXP authentication is flexible. By default, users log into Liferay DXP by using the Sign In widget, which uses the database to authenticate the user. By default, guests can use the Sign In widget to create accounts with default permissions. Nearly every element of the default authentication experience can be changed by an administrator. For example,

To learn more, see Authentication Basics.

Permissions

Liferay DXP has a robust role-based access control (RBAC) system. Users can be assigned to Sites, Teams, User Groups, or Organizations. Custom Roles can be created, permissions can be assigned to these Roles, and those Roles can be assigned to Users. Roles are scoped to apply only in a specific context, such as a Site, Organization, or globally. See Roles and Permissions for more information.

Securing Web Services

Liferay Web Services have a multi-layered and configurable approach to security and authorization:

See Introduction to Securing Web Services to learn more.

Fine-Tuning Security

There are many ways to fine-tune or disable additional security features:

  • Configure Liferay Portal’s HTTPS web server address.

  • Configure the list of allowed servers to which users can be redirected.

  • Configure the list of portlets that can be accessed from any page.

  • Configure the file types allowed to be uploaded and downloaded.

These features can be configured using portal properties.

Warning

Liferay Portal’s philosophy is “secure by default.” Please exercise significant caution when modifying security-specific defaults or white-lists. Such actions may lead to security misconfiguration and an insecure deployment.

Additional Information

For more information about securing a Liferay Portal installation, please see our security statement, the community security team, and the resources listed on those pages.

There are additional security plugins available from Liferay Marketplace.