BoldDesk Login Issues: Quick Fixes & Troubleshooting Guide
If you are unable to access your BoldDesk portal, it may interrupt your workflow and restrict access to important support tools. This guide offers troubleshooting steps to assist you in identifying common login problems. If you are unable to log in to BoldDesk, here are some possible reasons and solutions:
1. Blank Page After Login
- Ensure the domain
https://cdn.bolddesk.comis allowed on your network. - Clear the browser cache and restart the browser.
- Verify the CDN is accessible by visiting
https://cdn.bolddesk.com/customer-app. - Disable ad blockers, interfering browser extensions, or VPNs, if applicable.
- Allowlist the BoldDesk portal domain and
https://cdn.bolddesk.comin your organization’s security settings.
2. SSO Configuration Issues
- Ensure the JWT public/private key pair used for token generation and validation is correct.
- Use a key size of at least 2048 bits for RSA key generation.
- Verify that the claims in the JWT are properly structured and signed.
- Review the callback URLs or settings related to SSO if validation passes but login still fails.
- Learn How to Configure JWT-Based Single Sign-On (SSO) in BoldDesk
If you see the error “not an admin or agent” after logging in, it usually means you’re signed in with an email that doesn’t have admin/agent access. Make sure you use the correct assigned email, and if using Microsoft SSO or form login, try an incognito window to avoid automatic login with the wrong account.
3. Security Measures or Restrictions
- Implement Single Sign-On (SSO) for seamless login, ensuring all related settings are applied correctly.
- Review password policies, IP restrictions, and allowlisted domains to ensure compatibility.
- Contact your network admin if organizational security policies are blocking BoldDesk access.
In BoldDesk, the “Stay signed in” option is part of the identity provider’s sign-in experience (for example, Microsoft Entra ID / Microsoft sign-in) rather than a BoldDesk-specific setting. If the user selects Yes, the identity provider issues a persistent authentication cookie, which allows the browser session to remain signed in across restarts. If the user selects No, a non‑persistent cookie is used and the session typically lasts up to 24 hours or until the browser is closed.
4. Network and Maintenance Issues
- Check the BoldDesk Status Page to ensure there is no ongoing downtime or system maintenance that might impact access.
- For additional details on security protocols, explore Responsible Disclosure of Security Vulnerabilities.
5. “Site Not Active” Login Error in BoldDesk
In BoldDesk, the “Site Not Active” message typically means either you’re using an invalid or changed portal domain (old URL no longer works), or your subscription/tenant is expired or suspended and access is restricted until it’s reactivated.
In BoldDesk, when authentication is activated, users who are logged in are automatically identified and will not be asked to provide their email address again. The email input form applies solely to unauthenticated users and must not be shown to customers who have already signed in. This approach guarantees a more efficient and seamless customer experience.
How to Troubleshoot
- Rule out service incidents. Review the public BoldDesk Status Page to ensure services are operational before deeper troubleshooting.
- If the site loads but login/UX fails (blank page/SSO issues): allow BoldDesk’s CDN, clear cache, and re‑try per the login guide.
- Still seeing “Site Not Active”? Contact BoldDesk Support or
[email protected]with your portal URL so the team can check tenant status.
Quick Reference Table
| Issue | Key Fixes |
|---|---|
| Blank Page After Login | Allow CDN, clear cache, disable extensions, allowlist domains |
| SSO Configuration Problems | Validate JWT keys, claims, callback URLs |
| Security Restrictions | Review password/IP policies, enable SSO, contact admin |
| Network/Maintenance Issues | Check status page, confirm no downtime |
Frequently Asked Questions
-
Why do I see a blank page after logging in?
Most commonly the network is blocking BoldDesk CDN assets (https://cdn.bolddesk.com) or the browser cache/extensions are interfering. Allowlist the CDN and clear cache. -
How do I fix SSO login failures?
Validate the JWT signing key pair, ensure RSA keys are at least 2048 bits, confirm claims and signatures, and verify callback/redirect URLs. See the SSO guide: How to Configure JWT-Based Single Sign-On (SSO) in BoldDesk. -
What if my organization’s firewall blocks BoldDesk?
Ask your IT/security team to allowlist the BoldDesk portal domain andhttps://cdn.bolddesk.com. -
What does “not an admin or agent” mean?
The signed-in email does not have BoldDesk admin/agent permissions in that account. Use the correct assigned email, and try an incognito window if Microsoft SSO is auto-selecting the wrong account. -
What does “Site Not Active” mean?
Usually the portal URL is invalid/changed, or the tenant subscription is expired/suspended. If status is healthy and the error persists, contact BoldDesk Support with the portal URL.
