ShipStream Knowledge Base
System Administration

Login Throttling

ShipStream protects password logins on the Admin UI and Client UI, and the Current Password on My Account, against password guessing. Badge, Social Login and API logins work as before.

How It Works

ShipStream keeps track of failed password logins, including wrong Current Password entries on My Account, which are checked, and counted, only when a save changes the username or email or sets a new password. When too many come from the same network, or are made against the same username, in a short time, ShipStream turns further attempts away for a while without checking the password. A refused attempt shows Too many failed login attempts. Try again later.

Accounts are never locked. Someone entering wrong passwords for a username on purpose can slow that username down, but its owner can still sign in from a network where they have signed in with that username, or entered a correct Current Password on My Account while their account had that username, recently.

A successful password login that follows many failed attempts may mean someone has guessed the password. ShipStream emails the User who signed in with the time, where the sign-in and the failed attempts came from, and what to do if it was not them. They know best whether it was them; if it was not, they should change their password with Forgot your password? on the sign-in page and tell their administrator. A sign-in that is emailed a login code as the User signs in is not also sent this email, because the code email already tells the User about the sign-in and what to do if it was not them. If no code could be emailed at that moment, this email is sent instead, and the code may still follow once the code page can send it.

A correct Current Password on My Account counts as a successful password login here, so it can send the same email. If that save also changed the email address, the email goes to the address the account had before, and a reset link would go to the new one, so the User should ask their administrator to restore their email address and change their password instead.

Forgot your password? on the Admin UI and Client UI sign-in pages emails a link for setting a new password. The link expires after an hour and works only once. It also stops working once the User signs in with their password, their password is changed in any other way, or their email address is changed. Requesting another link replaces the previous one. The email is sent as soon as the form is submitted. If the mail server cannot be reached, ShipStream retries the email later; if the link has expired by the time it arrives, request a new one.

A link an admin sends with Send Reset Link, including the one in a new User's welcome email, stays valid for 24 hours instead of an hour.

If password reset requests are temporarily unavailable, ask your administrator to send a link from the User edit page. Admins can still send reset links while requests from the sign-in pages are disabled. Password Login restrictions still apply. Links already sent keep their normal expiry and single-use behavior.

The form always shows the same message, whether or not the email address has an account, and repeated requests are limited so that the form cannot be used to flood an inbox.

Sessions Bound to an IP Address

A signed-in session works only from the IP address where the User signed in. If someone copies a session cookie and uses it from another address, ShipStream refuses the request and sends them to the login page. The User who signed in stays signed in and is not affected.

  • For an IPv6 address, any address in the same /64 network counts as the same address, so the address changes that devices make on their own do not sign anyone out.
  • A session also works from any address in Warehouse Remote IPs (System > Configuration > Warehouse > Operations > Restrictions), so a User who signs in at home can keep working when they arrive at the warehouse, and a warehouse whose traffic leaves through more than one address keeps its sessions. A session started from a Warehouse Remote IP works only from those addresses, so it cannot be used outside your warehouses. List only addresses your warehouses use, because every session works from every address in the list.
  • A User whose own address changes, for example when a laptop moves to another network or a VPN connects, must sign in again. This includes sessions kept with Keep me logged in.

This applies to the Admin UI and the Scanner. For the Client UI, set System > Configuration > General > Design > Client Login Page > Bind Sessions to IP Address. Both default to Yes. If the Users of your Admin UI or Scanner are often asked to sign in again because their address changes, contact ShipStream support.

Login Error Messages

So that the login form does not help someone guess accounts, every failed password login shows Invalid Username or Password. That includes a correct password for:

  • a User whose account is inactive or has no role,
  • a Client User whose Merchant is inactive or archived,
  • a User who must sign in with Google or Microsoft because of Password Login or Force SSO for Domains.

If a User reports that a password they know is correct is refused, check these settings on their User edit page before resetting the password.

If many people in one warehouse share a single internet connection and are often turned away after typing errors, contact ShipStream support.