Submit Feedback
Legacy Knowledge Base
Published Sep. 10, 2025

Re-enabling Basic Authentication when Unable to Access the DXP Control Panel

Written By

Michael Tran

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Issue

  • My Basic Authentication was disabled at the Instance Level, and now I am unable to access the DXP Portal because of it. How do I re-enable Basic Authentication without logging in?

 

Environment

  • Quarterly Release 2025.Q1.6

 

Resolution

  • There is a way to re-enable Basic Authentication at the Instance Level by leveraging an OSGI configuration file. Here are the steps to accomplish this:
    1. Open a Browser Window and Navigate to your Home Page
    2. Open the Browser's Developer Tools and enter the following command into the console: 
      • Liferay.ThemeDisplay.getCompanyId()
    3. Save the output. This is the CompanyID of the site
    4. Create a configuration file with the following name (the UUID does not matter):  
      • com.liferay.portal.security.configuration.BasicAuthHeaderSupportConfiguration.scoped~8ecaca5f-3573-46ac-92b6-ae52a6cdb67c.config
    5. In the newly created configuration file, add the following lines, where CompanyID is replaced with the one saved in the earlier step: 
      • companyId=L"1234567890"
        enabled=B"true"
    6.  Configuration file is complete. Proceed to deploy the file under 
      •  [Liferay_home]/osgi/configs
    7. Basic Authentication should be enabled for this instance
  1.  
  1.  

Additional Information

 

 

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?