SSO Login

SSO (Single Sign On) lets you log in to ShipEdge using your SSO credentials. Instead of a ShipEdge username and password, you sign in through a popup window. If your account is linked to SSO, you must use this method to log in.

When you use SSO for the first time, the system may ask you to link your existing ShipEdge account or register a new one. This page explains the full flow.

What is SSO Login?

SSO login acts as the authentication server. When you click CONTINUE WITH SINGLE SIGN ON (SSO) on the login page, a popup opens where you enter your SSO credentials. After you sign in, ShipEdge links your session to your account.

If your ShipEdge account is already linked to SSO (your user has an SSO identity), you cannot use the standard username/password login. You must use SSO.

Why Use SSO?

One Login for Multiple Apps

Use the same credentials across your organization’s apps. No need to remember a separate ShipEdge password if your company uses SSO.

Secure Authentication

Your organization manages passwords and security policies. The identity provider handles authentication securely.

Account Linking

Link your existing ShipEdge account to your SSO identity once. After that, SSO login signs you in automatically.

New User Registration

New users can register through SSO. The system creates a ShipEdge account linked to your SSO identity.

Accessing SSO Login

On the ShipEdge login page, click the CONTINUE WITH SINGLE SIGN ON (SSO) button. A popup window opens. Complete the sign-in in that window.

Popup Blocked?

If your browser blocks the popup, allow popups for the ShipEdge site and try again. The SSO login must open in a popup window.

How to Log In with SSO

1. Go to the Login Page

   Open the ShipEdge login page. You see two buttons: LOGIN (for username/password) and CONTINUE WITH SINGLE SIGN ON (SSO). You also see a Forgot Password? link.

2. Click CONTINUE WITH SINGLE SIGN ON (SSO)

   A popup window opens with your organization’s SSO login form (Email, Password, and Sign In button).

3. If you do not have an SSO account yet: Click Register

   On the SSO login screen, you see “New user? Register” below the Sign In button. If you are a new user and do not have SSO credentials, you must click Register to create your SSO account first. Complete the registration form, then click in the Register button.

4. Choose whether you have a ShipEdge account

   The next screen asks: Do you already have a Shipedge account?

   • Yes, I have an account – Enter your ShipEdge username and password, then click Sign In to link your account. You are then logged in.
   • No, create new account – You are redirected to the registration page. Complete the form to create a new ShipEdge account linked to your SSO identity.

After SSO Sign-In: User Information Screen

When you sign in with SSO for the first time (or when the system needs to confirm your identity), you see a User Information screen showing:

• Email – Your email from your organization
• Full Name – Your first and last name from your organization

You also see two buttons:

• Proceed – Continues to the next step (link account or register)
• Switch Account – Signs you out of SSO and returns you to the login page

Seamless Registration Recovery

One of the main advantages of this SSO integration is that if you happen to interrupt your registration for any reason after authenticating through SSO, you will not lose your progress. The next time you log in with your SSO credentials, ShipEdge will automatically recognize your identity and allow you to resume the linking or registration process exactly from where you left off.

If You Are a New User

The next screen asks: Do you already have a Shipedge account?

You see two options:

• Yes, I have an account – Sign in to your existing account and link it to SSO
• No, create new account – Start your journey with Shipedge (registration flow)

Linking an Existing Account

If you choose Yes, I have an account, you see a form with:

• Username – Enter your ShipEdge username
• Password – Enter your ShipEdge password (placeholder: “Enter your password”)

Click Sign In to link your account. If the username and password are correct, your ShipEdge account is linked to your SSO identity. You are then logged in.

Click Back to return to the previous screen. If you do not have an account, click Create new account to go to the registration flow.

Registering a New Account

If you choose No, create new account, you are redirected to the SSO registration page. Complete the registration form to create a new ShipEdge account linked to your SSO identity.

Email, password, and User Name

Email and password are your ShipEdge login credentials when you use SSO. User Name is stored for display in the Activity Log and is not used as your sign-in credential together with your password.

SSO-Linked User: Must Use SSO

If your ShipEdge account is linked to SSO and you try to log in with username and password, you see the message: SSO Account Detected. Please use the Single Sign-On button.

The system may automatically open the SSO login popup after a short delay. Use CONTINUE WITH SINGLE SIGN ON (SSO) to log in.

Manage and Linking Multiple SSO Users

If your SSO email is linked to more than one ShipEdge account, the Account Selection screen acts as your central hub. It allows you to easily view and access all your connected accounts (OMS and WMS) from one place, eliminating the need to remember multiple passwords or sign in multiple times.

When you log in via SSO:

• If no default is set: You will see the Account Selection screen, where you can choose which account to open for this session.
• If a default is set: You will bypass this screen and log directly into your preferred account. You can still switch accounts anytime from your profile.

Conditional Flow

The Account Selection screen only appears if your SSO email is linked to multiple ShipEdge environments (e.g., both a WMS and an OMS). If you only have one account, you will bypass this screen and be logged in directly.

Selecting or Changing Your Account

The Account Selection screen displays a “card” for each of your linked accounts, showing the Username, System Type (OMS or WMS), and the environment URL.

1. Access the Account Selection Screen

   • Automatically during login: If you haven’t set a default account, this screen appears right after you sign in via SSO.
   • Manually while logged in: Click your profile menu in the header and select My Accounts to switch accounts or change your default preference.

2. Select an account

   Click on the card of the account you want to access for your current session.

3. Set a Default Account (Optional)

   You can mark an account as your default. Future logins will automatically bypass this selection screen and log you directly into that account.

Linking an Additional Account (Add Account)

If you already use SSO but need to link another existing ShipEdge account (or create a new one) to your current SSO email:

Use Case

This is especially useful when you want to use the same SSO email to access multiple OMSs. You can easily switch between them from your profile without having to log out.

Important Limitations

• Unique Fields: Company Name and User Name must be unique. You cannot use a Company Name and User that already exists in the system.
• Pending Activation: Newly created accounts remain inactive and won’t appear until an administrator activates them.

1. Access the Account Selection Screen

   This screen appears automatically after you log in. If you are already logged in, you can access it by clicking your profile menu at the top right and selecting My Accounts.

2. Click on the Add Account card

   This will open a new modal.

3. Link or create the account

   Choose to create a new OMS account or enter the username and password of an existing ShipEdge account (OMS or WMS). Once verified, the new account must be activated by the administrator.

   Note: The creation tool within “Add Account” is exclusively for new OMS accounts. If you need a new WMS account, please contact ShipEdge support.

Linking Your Account to a Different SSO Email

If you need to disconnect an account from your current SSO email and link it to a different one:

Use Case

This flow is ideal when you have created multiple accounts with different SSO emails (e.g., personal vs. corporate) but now you want to centralize everything under a single SSO email. You can disconnect an account and instantly relink it to your main SSO identity.

1. Click Link to another SSO

   On the Account Selection Screen, click the Link to another SSO button. A warning modal will appear confirming that you want to disconnect the current user.

2. Confirm disconnection

   Click Disconnect and Link New Account. You will be redirected to the SSO login page.

3. Sign in with new credentials

   Sign in with the new SSO email credentials. If successful, the ShipEdge account will be permanently linked to the new SSO email.

Restrictions and Important Notes

Keep the following limitations in mind when managing multiple accounts via SSO:

• Single WMS Limitation: You can only link one WMS environment to a single SSO email. However, you can link multiple OMS accounts to that same email.
• Active Status Required: Only accounts with an Active status in the ShipEdge will appear on your Account Selection screen. If an administrator deactivates one of your accounts, it will automatically disappear from your cards.
• No Duplicate Links: You cannot link the exact same ShipEdge account twice to the same SSO identity.
• Sub-user Integrity: For security reasons, the system prevents an SSO email from acting as a sub-user across multiple conflicting accounts to avoid duplicated or unauthorized access.

Best Practices

Allow Popups

Enable popups for the ShipEdge site so the SSO window can open. Blocked popups prevent SSO login.

Link Once

Link your ShipEdge account to SSO the first time you use it. After that, SSO login signs you in without extra steps.

Use Correct Credentials

When linking an existing account, use your ShipEdge username and password. These are different from your SSO credentials.

Contact Support if Stuck

If you see “Could not verify SSO user” or other errors, try again. If the issue persists, contact support.

Troubleshooting

Message indicating you must use SSO

Problem: You entered your username and password but see the message SSO Account Detected. Please use the Single Sign-On button.

Solution: Your account is linked to SSO. You must use CONTINUE WITH SINGLE SIGN ON (SSO) to log in. The system may open the SSO popup automatically; if not, click the SSO button.

Could not verify SSO user. Please try again if the issue persists, contact support.

Problem: This exact message appears after you sign in with SSO.

Solution: There may be a temporary issue with the SSO connection. Try again. If it keeps happening, contact support.

Popup blocked or did not open

Problem: Nothing happens when you click the SSO button.

Solution: Your browser may be blocking the popup. Allow popups for the ShipEdge domain in your browser settings, then try again.

Username is required / Password is required

Problem: You see these errors when trying to link your account.

Solution: Fill in both Username and Password before clicking Sign In. Both fields are required.

Invalid account. Please try again.

Problem: You see this message when trying to link your existing ShipEdge account to SSO.

Solution: Check that your username and password are correct. The account must not already be linked to another SSO identity. If the problem continues, contact support.

This SSO is already associated with an existing user.

Problem: You see an “Account Linking Error” popup with this exact message when trying to link an account.

Solution: This error occurs when the ShipEdge account you are trying to link is already connected to a different SSO email. A ShipEdge account can only be owned by one SSO email at a time. To resolve this, you must either log in using the SSO email that originally linked the account, or contact an administrator to unlink the account so it can be associated with your new email.

This username is already in use… or This email is already in use…

Problem: During registration, you see a message about username or email already in use.

Solution: The message suggests using Link My Register Account to connect your existing account. If you already have a ShipEdge account, go back and choose Yes, I have an account when asked “Do you already have a Shipedge account?” Then enter your username and password to link it.

SSO account creation failed

Problem: Registration through SSO did not complete.

Solution: There may be a conflict with your email or username in your organization’s identity provider. Try a different email or use Link My Register Account or Link My Existing Account (depending on the message) to connect your existing account. If the problem continues, contact support.

Related Links

Next Steps:

• Account Access & Login – Standard username/password login and password reset
• Profile Setup – Update your profile after logging in