Skip to main content
This topic describes some of the commonly asked questions and answers relating to setting up Single Sign-On (SSO) for the Megaport Portal. For more information about the SSO setup process, see Setting up Single Sign-On.

​
I have a whitelist/allowlist set up. Do I need to update it?

If your organization restricts inbound network traffic to specific IP addresses, you might need to add Megaport’s IP ranges to your firewall or security group settings. These IP ranges are available on request. For more information, contact our Support team.

​
I have set up SSO between Azure AD and Megaport. Why am I now receiving a Login Failed error when trying to log in?

Although this can be caused by several reasons, the most common reason is the email mapping attribute with Megaport not being set to Azure’s fully qualified email attribute value. Azure expects this, and if using just “emailaddress” then the integration will fail. To confirm if this is the cause, you can look at the browser console when logging in, and if you see an error containing “mapped email is empty” then this will be the cause.

​
I have set up an IdP-initiated flow with my IdP to connect to Megaport and it’s not working. Why?

Megaport uses internal software to support SSO, which does not support IdP-initiated flows at this stage. Trying to use an IdP-initiated flow will result in a relayState error. Once SSO has been configured for your Megaport account, you need to log in to Megaport directly via the Megaport Portal login page at .

​
Why do I receive a relayState error when testing my SSO configuration directly through my IdP?

Some IdPs offer the ability to test the SSO connection through their SSO configuration page. This test typically triggers an IdP-initiated flow which is not supported by Megaport. To test whether SSO has been set up correctly with Megaport, we recommend trying to log in directly via once you have completed the configuration with your IdP.

​
I’ve been invited by my Company Admin to our Company account with SSO and have never logged in directly with Megaport credentials. There are issues logging in via SSO. How can I get into my Company’s account?

If you have the role of Company Admin, or SSO hasn’t been enforced for your company account, then you can log in with a Megaport username and password. As you have never created a Megaport password with your profile, you will need to create one now. Go to the Megaport login page at , then click Get help signing in. When on the Login Help page, click Forgot Password and follow the prompts. Once you have set a password, you can use it to log in. You can use the Get help signing in option again if needed.

​
My SSO sign-in failed and I see a support reference. What should I do with it?

Some login errors display a support reference on the Megaport Portal error page. If a support reference is shown, copy it and include it in your support request to help us investigate the issue more quickly. For more information, see Contacting Support.
Last modified on August 21, 2026