![Ringle](assets/ringle-logo.png)

# Logging in, logging out, and MFA

## Purpose
Sign in to the Ringle portal with an email or phone number, use a single sign-on provider, complete an MFA challenge when one is enabled, and sign out again.

## Prerequisites
- A Ringle portal account with a password, or an account with one of the supported sign-on providers (Google, Apple, Facebook, Microsoft, TikTok).
- If MFA is enabled on your account, access to your verification method.

## Steps

### Step 1

![login-logout-and-mfa, step-01](screenshots/login-logout-and-mfa/step-01.png)

**Action:** Go to https://portal.getringle.com/login. The Email tab is selected by default.

**What you should see:** The login card shows Email and Phone tabs, an Email field, and a Password field with a show password toggle. It also has a "Sign up here" link, a "Forgot your password?" link, a Sign In button, and a row of single sign-on buttons under "Or continue with".

### Step 2

![login-logout-and-mfa, step-02](screenshots/login-logout-and-mfa/step-02.png)

**Action:** Click the Phone tab to sign in with a phone number instead of an email address.

**What you should see:** A Phone Number field replaces the Email field. It expects the full number with country code, for example +12345678901. The password field and the rest of the form stay the same.

### Step 3

![login-logout-and-mfa, step-01](screenshots/login-logout-and-mfa/step-01.png)

**Action:** Click a provider's button under "Or continue with" to sign in with an existing Google, Apple, Facebook, Microsoft, or TikTok account. Follow the provider's own sign-in prompts.

**What you should see:** The provider opens its consent screen. After you approve, you return to the portal signed in. Accounts are matched by the email address the provider shares.

### Step 4

![login-logout-and-mfa, step-04](screenshots/login-logout-and-mfa/step-04.png)

**Action:** On the Email tab, type your email address and password. Use the eye icon to check the password as you type.

**What you should see:** Both fields show your input, with the password masked. The Sign In button is ready to click.

### Step 5

![login-logout-and-mfa, step-05](screenshots/login-logout-and-mfa/step-05.png)

**Action:** Click Sign In.

**What you should see:** You land on the dashboard for your active workspace. The sidebar shows your navigation sections, your name at the bottom, and a Log Out button.

### Step 6

*Screenshot not available (an MFA challenge could not be produced on a documentation account in this session)*

**Action:** If your account has MFA enabled, enter the verification code when prompted after the password step. Then click Verify Code.

**What you should see:** The login card switches to a verification step with a Verification Code field, a Verify Code button, and a Back to Login link. A correct code completes the sign-in and the dashboard loads. A wrong or expired code shows an error, and you can try again.

### Step 7

![login-logout-and-mfa, step-05](screenshots/login-logout-and-mfa/step-05.png)

**Action:** Click the Log Out button at the bottom of the sidebar to sign out. It sits below your name and the dark mode toggle.

**What you should see:** You are taken to the public landing page. Your session ends immediately.

### Step 8

![login-logout-and-mfa, step-08](screenshots/login-logout-and-mfa/step-08.png)

**Action:** Confirm you are signed out.

**What you should see:** The landing page header shows Log In and Try the demo again. Opening a portal page such as the dashboard now asks you to sign in first.

## Troubleshooting
- Wrong email or password: the form shows an error and keeps your email filled in. Repeated failed attempts can temporarily lock the account. Wait a few minutes or use the password reset flow. Only failed attempts count toward the lockout. Signing in successfully many times never triggers it.
- You are sent back to the login page while working: your session expired or the session cookie was cleared. Sign in again. Unsaved work on the previous page is lost.
- A single sign-on button does nothing: your browser may be blocking the provider pop-up. Allow pop-ups for portal.getringle.com and try again.
- Phone sign-in rejects your number: enter it in international format with the leading plus and country code, with no spaces or dashes.

## Notes
- Route: `/login`.
- Source component: `components/auth/Login.jsx` in the portal app.
- Sign-in works with either email or phone plus the account password. The five single sign-on providers appear on both tabs.
- MFA is turned on and off from Account Settings on the Security tab; see the "Account security and sessions" guide.
- Logging out on the portal also ends the shared session that the marketing site reads, so both sites see you as signed out.