Securing Your Account
Turn on two-factor authentication, keep your recovery codes, manage your password and sign-in, and know what to do if you lose your authenticator.
Two-factor authentication (2FA) adds a second step to signing in: after your password, or after signing in with Google or Microsoft, CargoLint asks for a six-digit code from an authenticator app on your phone. Even someone who learns your password cannot get in without it.
We recommend 2FA for everyone, and especially for Owners and Admins, who can manage the team, the API key, webhooks and billing.
Setting up 2FA
- Open Profile from the sidebar.
- Under Security, find Two-Factor Authentication and click Enable 2FA.
- Follow the three steps below.
Step 1: Scan the QR code
- Open your authenticator app (see Supported apps).
- Add a new account and scan the QR code on the screen.
- If you cannot scan it, click Copy next to the secret and enter it in the app by hand.
The app then shows CargoLint with a six-digit code that changes every 30 seconds.
Step 2: Verify the code
Enter the current six-digit code from the app. If it is correct, 2FA is turned on, and CargoLint sends you a confirmation email.
Step 3: Save your recovery codes
CargoLint shows 8 recovery codes. Each one works once, in place of an authenticator code, if you lose your phone.
- Click Copy All Codes and store them somewhere safe, such as a password manager, away from your phone.
- Tick I have saved my recovery codes in a safe place.
The codes are shown only this once.
Supported apps
Any TOTP authenticator app works, including:
- Google Authenticator
- Microsoft Authenticator
- Authy
- 1Password
- Bitwarden
The codes are generated on your device, not sent to it.
Signing in with 2FA
- Sign in with your email and password, or with Google or Microsoft.
- On the Two-Factor Authentication screen, stay on Authenticator Code and enter the six-digit code from your app.
If a code is rejected, wait for the next one: the app shows a new code every 30 seconds.
Using a recovery code
- Sign in as usual.
- On the Two-Factor Authentication screen, choose Backup Code.
- Enter one of your recovery codes.
Each code works once. Profile > Security shows how many unused codes you have left. When they run low, click Create new backup codes there and enter a code from your authenticator app: you get a fresh set of 8, and the old ones stop working.
Disabling 2FA
- Open Profile > Security.
- Click Disable 2FA.
- Confirm with your password. An account that signs in only with Google or Microsoft has no CargoLint password, so it confirms with a code from the authenticator app instead.
CargoLint sends an email when 2FA is turned off.
Losing access to your authenticator
- You have a recovery code: sign in with it (see above), then turn 2FA off and on again with your new phone.
- You have no recovery code left: write to support@cargolint.com from your account’s email address.
To avoid this, keep your recovery codes somewhere other than your phone.
Your password
- Requirements: at least 8 characters, with an uppercase letter, a lowercase letter, a digit and a symbol.
- Change it: Profile > Security > Change Password. Enter your current password, then the new one twice.
- Forgot it: use Forgot password? on the sign-in page to get a reset link by email.
- Signing in with Google or Microsoft: your account has no CargoLint password; manage your password with your provider.
Use a unique password, kept in a password manager.
Sessions
A sign-in lasts 60 minutes, after which CargoLint asks you to sign in again. Sign-ins, failed 2FA codes, password changes and 2FA changes are recorded in your organization’s audit log.
For the API side of 2FA, see Two-Factor Authentication.