Sign in, MFA, reset your password
You sign in to Facet with your email address and your password. Your organization can require a second check at sign-in: multi-factor authentication (MFA). The sign-in screens call it two-factor authentication. This page covers sign-in, first passwords, MFA, and password reset.
Before you start
Section titled “Before you start”- First password. It comes from your administrator: a temporary password or an invite link in an email.
- Authenticator app. For MFA you need an app. Facet works with apps such as 1Password, Authy, and Aegis.
1. Open the sign-in page
Section titled “1. Open the sign-in page”Open https://facet.localhost:3443 in your browser, or the address your
organization gives you. The page shows Email, Password, and a
Sign in button.
2. Enter your email and password
Section titled “2. Enter your email and password”- Type your email address in Email.
- Type your password in Password.
- Select Sign in.
When the password is wrong, Facet shows the attempts that remain. After too many failed tries, sign-in locks for about 5 minutes.
3. Set your first password
Section titled “3. Set your first password”Your first sign-in depends on the credential your administrator sent.
- A temporary password. Sign in with it. Facet shows “Set a new password”. Enter the current password, a new password with at least 8 characters, and repeat the new password. Select Save password and continue. Facet signs you in with the new password.
- An invite link. Open the link from the email. The page shows “Choose a new password”. Enter a new password with at least 8 characters and select Set password. Facet signs you in.
4. Enter the code from your authenticator app
Section titled “4. Enter the code from your authenticator app”If your account has MFA, sign-in stops at the “Two-factor authentication” screen.
- Open your authenticator app.
- Type the 6-digit code for Facet.
- Select Verify.
The code changes every 30 seconds. If you cannot reach the app, select Use a backup code and enter one of your saved codes.
5. Set up MFA when Facet asks
Section titled “5. Set up MFA when Facet asks”Facet can ask you to set up MFA during sign-in:
-
Your organization requires MFA. Sign-in stops at “Set up two-factor authentication” until you finish. The screen offers no way back.
-
Your organization recommends MFA. After sign-in, Facet shows the same setup. You can select Skip for now. Facet asks again at your next sign-in.
To set up MFA:
- Scan the QR code with your authenticator app. If you cannot scan, select Copy secret to clipboard and paste the key from Manual entry key into your app.
- Type the 6-digit code from the app and select Verify and enable.
- Facet shows 10 backup codes in the form
xxxx-xxxx. - Save the codes in a safe place. Each code works once, when your authenticator is not available.
- Select I’ve saved my backup codes.
6. Sign in with single sign-on
Section titled “6. Sign in with single sign-on”If your organization configured single sign-on (SSO), the sign-in page shows one Continue with button per provider. Select your provider and follow its steps. When the server requires SSO, the password fields and the Forgot password? link do not show.
If the sign-in with the provider does not finish, Facet returns to the sign-in page. Try again. If it fails again, contact your administrator.
7. Reset your password by email
Section titled “7. Reset your password by email”You do not need to sign in to reset a password.
- Open the sign-in page and select Forgot password?.
- Type your email address in Identifier.
- Select Send reset link.
- Facet shows “Check your inbox” and the validity period of the link.
- Open the email and select the link. Check the spam folder if the email does not arrive.
- The page shows “Choose a new password”. Type a new password with at least 8 characters and select Set password.
- Facet returns to the sign-in page and shows “Password updated. Sign in with your new password.”
8. Sign out
Section titled “8. Sign out”- Select your name at the bottom of the sidebar.
- Select Logout.
Your session also ends when it expires (14 days by default), when you revoke it in your settings, or when Facet detects a reused session token. See Your settings, sessions and API keys to review your sessions.
Troubleshooting
Section titled “Troubleshooting”The password does not work
Section titled “The password does not work”- Check the email address and the password for typing errors.
- Check that Caps Lock is off. The error message shows the attempts that remain.
- Wait and try again. After too many failed tries, sign-in locks for about 5 minutes.
The code does not work
Section titled “The code does not work”Wait for a fresh code and enter it at once. A code that you already used does not work again. After 5 wrong codes, sign-in locks for about 5 minutes.
You lost your authenticator
Section titled “You lost your authenticator”- Select Use a backup code on the “Two-factor authentication” screen.
- Enter one of the codes you saved. Each code works once.
- Ask an administrator to reset MFA. Then sign in and set up MFA again.
The code step expired
Section titled “The code step expired”The code step stays open for 5 minutes. When it closes, Facet shows “Verification session expired. Please sign in again.” Start again and enter a fresh code.
The reset link does not work
Section titled “The reset link does not work”A link works once and expires after 24 hours by default. When Facet shows “This reset link is invalid or has expired.”, request a new link. Select Forgot password? on the sign-in page. A new link replaces an older link.
No reset email arrived
Section titled “No reset email arrived”Check the spam folder. Facet shows the same confirmation for every address. It cannot tell you whether the account exists. If no email arrives, ask your administrator.
Related
Section titled “Related”- Your settings, sessions and API keys — review your active sessions and create API keys.
- Security & governance overview — how Facet protects accounts, sessions, and secrets.
- Auth contexts — how Facet applies your active role to each request.
- The dashboard — the first page after sign-in.