Troubleshooting common issues with the Ideagen Mazlan Home integration
Who is this article for?
Administrators planning to implement Ideagen Mazlan Home.
Administrator access is required for some actions.
This article covers the most common login and access issues encountered after migrating to Ideagen Mazlan Home. Each issue includes the root cause and step-by-step resolution instructions.
The content is intended for all users, with steps that require Administrator access clearly indicated.
1. User wasn't migrated and can't sign in
1.1. Missing email address
Users with no email address in Ideagen Quality Management are skipped during migration entirely. They will not appear in Mazlan Home post-migration.
To resolve this issue:
- Check whether the user exists in Mazlan Home.
If they do not appear, proceed to the next step. - Check whether the user record has a missing email address in Ideagen Quality Management
- A Tenant Administrator must then manually create the user in Mazlan Home using the exact same Ideagen Quality Management username.
This will then sync the user to Ideagen Quality Management within a few minutes.
1.2. Invalid username format
The Ideagen Quality Management username format was invalid and could not be processed during migration. The user will not appear in Mazlan Home post-migration.
To resolve this issue:
- Check whether the user exists in Mazlan Home.
If they do not appear, check whether their Ideagen Quality Management record has an email address. If the email address is missing, follow the steps in Issue 1.1. first. - If an email address is present, check the Ideagen Quality Management username for formatting errors (spaces, special characters, or unsupported formats).
If there are errors, a Tenant Administrator must correct the username directly in Ideagen Quality Management. - Once corrected, a Tenant Administrator must then manually create the user in Mazlan Home using the exact same Ideagen Quality Management username.
This will then sync the user to Ideagen Quality Management within a few minutes.
This is a two-step fix. The username must be corrected in Ideagen Quality Management before the user can be created in Mazlan Home.
2. Username has changed
2.1. User doesn't know what to enter
If Single Sign-On (SSO) is enabled, the username is updated to match the User Principal Name (UPN). If the customer uses the Ideagen Please Review integration, the username is updated to match the email address. In both cases, the previous username no longer works.
To resolve this issue:
- Check the welcome email received after Mazlan Home migration.
A new username is included in that email. - If you can't find your welcome email, contact a Tenant Administrator to find your username.
3. User is redirected to the old sign in page
Users who bookmarked the old Ideagen Quality Management sign in URL before migration will be taken to the legacy sign in page when they click that bookmark. The legacy login page does not work after migration.
To resolve this issue:
- Delete the old bookmark or saved link immediately.
Old URLs contain stale session data and are the most common cause of login errors after migration. - Navigate to the new Ideagen Mazlan Home sign in URL provided in the welcome email.
- Save the new URL as a bookmark going forward.
4. Users cannot access the application
4.1. SSO Redirect URL not updated
The new Redirect URL required by Mazlan Home has not been added to the customer's SSO identity provider. This prevents Mazlan Home from completing the authentication flow.
To resolve this issue:
- Obtain the new Redirect URL.
This will be available in the email sent to you about Mazlan Home migration. Open a ticket with us if you cannot find the email. - Your IT team must add this URL to the Ideagen app registration in your identity provider (e.g. Microsoft Entra ID) under the Web platform.
- Once the Redirect URL has been saved, users should be able to log in via SSO.
You can find information on how to update this in our guide to updating Single Sign-On (SSO) configuration.
The Redirect URL must be added under the Web platform, not Single-Page Application (SPA). See the SSO Redirect URL help article for details.
5. Cannot add/edit users in Ideagen Quality Management
After migration to Mazlan Home, all user management happens in Ideagen Mazlan Home. This is an expected behaviour.
You'll create users in Mazlan Home, and they will sync automatically to Ideagen Quality Management. Users cannot be created or edited directly in Ideagen Quality Management, but permissions and group assignments can still be managed there as before.
6. Reset password link showing an unrecognised phone number/email address
User is either an external user (SSO enabled) or the user does not exist in Ideagen Mazlan Home.
To resolve this issue:
- Check whether the user exists in Mazlan Home.
If they are an SSO user, ensure they are set as an External user and the username matches the correct UPN from your SSO provider.
If they are an internal user, make sure they enter the username exactly as mentioned in the welcome email. - If a welcome email is not received, reach out to a Tenant Admin to look for the username in the Ideagen Mazlan Home Admin Console.
Still having trouble?
If your issue is not listed above or the steps above did not resolve it, please open a ticket with a reference of your Mazlan Home migration date.
Looking for additional information?
If you're an IT Administrator, we've included additional information for you in our guide to preparing for the Ideagen Mazlan Home integration.