Get troubleshooting advice for you and your IT administrators around issues related to single sign-on (SSO).
✏️ Learn more about configuring Miro SSO and Miro SCIM.
Miro SSO errors
If you see any of these SSO error messages, explore the solutions below. You may need help from your IT department or Company Admins.
This happens when the email address that you entered in Miro is not recognized as a user that should be authenticated via SSO.
- You are not a member of any account that established SSO as their login requirement. Sign in via standard options (email and password) or get in touch with your admin to get invited to your company’s account.
- You are supposed to log in via SSO but there is a mixup with your email address. Perhaps you have several emails (or aliases) and the invitation to the account with established SSO was sent to your other address. Log in with another email address.
This usually happens in two scenarios:
- Your user profile in the Identity Provider system is not given permission to sign into Miro (you don’t have a role assigned). If this is the case you probably won’t find Miro as a tile on your provider’s MyApps dashboard. Get in touch with your provider’s admin to get the necessary permissions.
- You recently changed your email (e.g. due to marriage) and the change has not been properly applied in all systems, creating conflicts. Get in touch with your admin to clarify the situation and if needed they will get in touch with us to approve any necessary changes.
If you are unable to log into Miro via SSO you can request access from Company Admins by clicking the corresponding button on the Miro SSO login page.
The option to request access from Company Admins
You will need to enter the confirmation code that will be sent to your email address. Once you enter the code, a notification will be sent to the Admins of your company's account notifying them that you need assistance.
This means that there is misconfiguration either in your Miro SSO settings or on the end of your Identity Provider. It’s likely that none of your colleagues can log in. Please get in touch with your IT department or the Identity Provider admin so they can check the following points:
- The SAML response must contain the signed assertion. This is a Miro requirement.
- Your Identity Provider may be treating Signed responses in a specific way. For instance, Google SSO unsigns the assertion when the response is signed. If that’s the case - unsign the response.
- The SAML response contains the required signed assertion but the X.509 certificate value that is supposed to validate it is not present (can also happen if your VPN/firewall cuts off parts of data transfer). Ensure that the X.509 certificate value is passed in the SAML traffic to Miro.
- The SAML response contains a different X.509 certificate value than the one added in the Miro settings so there’s a mismatch and validation fails. Check that the certificate values on the IDP side and on the Miro side match.
This means that there is misconfiguration on the end of your Identity Provider - either in the general setup or for your specific user profile. Please get in touch with your IT department or the Identity Provider admin so they can check the following points.
- The Username (NameID, Unique user ID) format in your SSO configuration is unspecified or set to a non-email attribute so the user value sent to Miro cannot be recognized. Specify Username to EmailAddress on the Identity Provider side (or to any other attribute that is in the email format).
- The SAML response does not contain the email value for the user so the user cannot be recognized (can also happen if your VPN/firewall cuts off parts of data transfer). Ensure that the email is passed in the SAML traffic to Miro.
- The SAML response is encrypted. Please do not use encryption as Miro does not support it.
This usually happens when there are issues with your profile on the Identity Provider end.
- Your user profile in the Identity Provider system is configured incorrectly. For example you are not given the permission to sign into Miro (you don’t have a role assigned). If this is the case you probably won’t find Miro as a tile on your provider’s MyApps dashboard. Get in touch with your provider’s admin to get necessary permissions.
- Your user profile in the Identity Provider system is configured correctly but has restrictions in place. For example there are IP restrictions, so you are only allowed to log in from certain places. Reach out to your Identity Provider’s admin and ask them about your permissions.
This means that you’re not supposed to access Miro from this page or that the SSO configuration in your Miro Enterprise account is not complete. In this case you might be able to log in from your MyApps dashboard.
- Your IDP is configured for IdP-initiated login only and you should not be able to sign in from the Miro sign-in page. Log in via the provided link, from your MyApps dashboard or reach out to your Company Admin for instructions.
- SSO is enabled in your Miro account but the configuration has not been finished. Get in touch with your IT department or Identity Provider Admin, so they finish the configuration according to these instructions.
Azure or ADFS errors
To change properties such as the reply URL and identifiers, contact the owner of the application.
Get in touch with your IT department and ask them to check the SSO configuration. Most likely, there is already a configured Miro app in your Azure AD where our identifier (https://miro.com/) is used and therefore taken. Azure is more or less unique in that this identity provider requires the identifier (Entity ID) to be unique.
To possibly resolve the situation, we advise you to check the Enterprise Applications of your Azure instance and use the one that you already have configured for your Miro account settings.
If you're sure there are no other Miro apps in your Enterprise apps, try getting a new copy of the Miro app from the Azure gallery.
Share this community post with your IT department: “An error occurred. Contact your administrator for more information”
Share this community article with your IT department: "Role not assigned" error
We checked Microsoft documentation for the error AADSTS650056 (as well as some suggestions from the community) and it looks like the error might be caused by the changes you added to the app permissions. Your Azure admin may need to give consent to the Miro app to allow the end-users to authenticate in Miro. This Microsoft tutorial should be helpful in this case.
Google SAML errors
Please refer to this section of Google documentation that lists possible errors and instructions on how to resolve the situation.
Issues logging in to the Miro app via SSO on the desktop app, tablet, or mobile
If you are unable to log in to the Miro app via SSO on a desktop/tablet/mobile device, but can log into the browser version, do the following:
- Delete the app from the device and re-install it. For the desktop app please be sure to remove all app folders following these instructions.
- Try changing the default browser of your device to a different one for a test, to see if with a different browser you are able to successfully complete the SSO authentication. Ensure that your preferred browser allows third-party cookies.
- If the issue persists, it is possible that this specific device cannot access the company's SSO environment. Check with your IT department if there are any restrictions regarding specific devices which are allowed to use SSO. For example with MDM solutions, issues can arise if Miro is not properly allowlisted.
My email changed and I can’t log in to my profile via SSO
Please note, if your organization uses SSO, the email address change needs to be made on the Miro side and on the Identity Provider side before an end-user tries to use their new credentials to log into Miro. If the change has not been done prior to the next login, your email is recognized as a new user and you may have issues logging in to Miro.
Get in touch with your admin to clarify the situation. You and your admin may need to contact Miro Support so that we can delete your new empty profile and change the email address on the existing profile. Please provide the following information:
- Your new email address and your old email address
- CC your company’s account Admin and ask them to send a confirmation that we can proceed with the change (required due to security reasons)
✏️ If you couldn't find a solution above, contact Miro Support.