Troubleshooting: Unable to Log in to HiveMQ Control Center
If you're having trouble logging in to HiveMQ Control Center and are redirected to the login page with the message “authentication failed,” this article will guide you through several troubleshooting steps.
Instructions
1. Basic Troubleshooting Steps
1.1 Clear Browser Cache & Cookies
Sometimes, issues can arise from corrupted cache or cookies. Try clearing them, or use an Incognito/Private window to rule out browser-related issues.
1.2 Check Your Role Permissions
Ensure that the user trying to log in has the correct permissions:
Admin or Developer roles are required to access the Control Center.
Organization Owners are not the only users with this access.
1.3 Use Supported Browser
We recommend using Chrome or Firefox for the best experience with HiveMQ Control Center.
1.4 Retry After a Few Minutes
In some cases, temporary issues with the authentication flow might cause login failures. If you experience a failed login, wait a few minutes and try logging in again.
2. Advanced Troubleshooting Steps
2.1 Capture a HAR File
If the issue persists, record a HAR file to capture the detailed request and response during the login process. This can provide valuable information for debugging. Follow these steps to record a HAR file:
Once you have the HAR file, submit it to support for further investigation.
2.2 Check for Service Issues
Sometimes, authentication issues might be related to ongoing infrastructure or backend problems. Verify if there are any ongoing service degradation or outages:
If the service is down or degraded, waiting for a fix may be the only solution.
2.3 Try a Different Network
Network issues, such as DNS misconfigurations or firewall restrictions, can also interfere with the login process. Try accessing the Control Center from a different network to rule out network-related issues.
By following this guide, you should be able to resolve most login issues related to HiveMQ Control Center.