# Sign in to Mindflow

import { Steps } from "@astrojs/starlight/components"

Sign in to Mindflow with your workspace URL, create an account when self-registration is enabled, and finish first-time
setup in Studio. You can update your profile from the sidebar anytime. Multi-factor authentication (MFA) adds an extra
sign-in step—see the MFA section on this page.

## When to use

- You are new to Mindflow and need to create an account or sign in for the first time.
- You need to finish first-time onboarding or update your profile picture and name.
- Prefer [Single sign-on (SSO)](/guides/govern/administrating-the-platform/single-sign-on-sso/) when your organization
  uses an identity provider instead of email and password.

Before you begin, get your workspace URL from your Mindflow administrator (for example `https://your-tenant.mindflow.io`).

## Guide

### Sign in with email and password

Use the authenticate page when you already have an account. Enter the email and password your administrator or
registration flow gave you.

1. **Open your workspace URL.** Replace `your-tenant` with your hostname (for example `https://acme.mindflow.io`).
2. **Enter your credentials.** Type your **Email** and **Password**.
3. **Sign in.** Click **Sign In**. If your organization enabled SSO, use **Sign in with** your provider instead.

   <div class="docs-screenshot-compact">

   ![Sign in form with email and password filled](./assets/sign-in-form.png)

   </div>

Forgot your password? See [Update your password](/guides/govern/manage-access/update-your-password/).

### Create an account

When self-registration is enabled on your tenant, open your workspace URL and register with **Sign Up**. You enter your
name, email, and password, then confirm the verification code Mindflow emails you. If your organization uses SSO
instead, follow [Single sign-on (SSO)](/guides/govern/administrating-the-platform/single-sign-on-sso/) and skip email
registration.

Some tenants close email **Sign Up** on purpose (often when SSO is the main way to join). On those tenants the sign-in
page shows **Sign In** and **Sign in with** your provider only—no **Sign Up** link. Ask your administrator to create
your account, or use SSO the first time. Existing email and password sign-in still works when your organization kept
it enabled.

1. **Open your workspace URL.** Replace `your-tenant` with your hostname (for example `https://acme.mindflow.io`).
   Studio opens the authenticate page.
2. **Open Sign Up.** On the sign-in form, choose **Sign Up** at the bottom of the card. If your tenant hides **Sign
   Up**, use **Sign in with** your provider or ask an administrator for an account. If your tenant exposes SSO on this
   page, you can use **Sign in with** your provider instead of email registration.

   <div class="docs-screenshot-compact">

   ![Sign in form with Sign Up link on the authenticate page](./assets/sign-in-form.png)

   </div>

3. **Fill in the form.** Enter **Full name**, **Email**, **Password**, and **Confirm your password**, then click
   **Sign Up**.

   <div class="docs-screenshot-compact">

   ![Sign up form with required fields filled](./assets/create-account-form.png)

   </div>

4. **Confirm your email.** Mindflow emails a verification code. Enter it in **Verification code**, then click
   **Confirm**. If the code does not arrive, choose **Resend code**. After confirmation, Studio signs you in.

   <div class="docs-screenshot-compact">

   ![Email verification code field on the authenticate page](./assets/confirmation-code-field.png)

   </div>

### Complete first-time onboarding

On your first login after registration, Mindflow may show an onboarding screen while it prepares your first environment
and sample flows. When setup finishes, choose **Open my flows!** to open the **Flows** home.

1. **Review the welcome screen.** Mindflow greets you by name and shows capability cards while your first environment
   and sample flows are prepared.
2. **Open Flows.** When the status shows **All done !**, click **Open my flows!**.

   <div class="docs-screenshot-compact">

   ![First-time onboarding welcome screen with All done and Open my flows button](./assets/open-my-flows.png)

   </div>

:::note
Onboarding appears only when your organization enables it and you are allowed to create environments. If you land on
**Flows** immediately, your administrator may have skipped onboarding for your tenant.
:::

### Update your profile

Open **My profile** from your avatar in the Studio sidebar to change your profile picture or full name. Email is shown
for reference; password users can change their password from the same page.

1. **Open My profile.** Click your avatar in the sidebar, then choose **My profile**.
2. **Edit your details.** Upload a profile picture (`.jpg` or `.png`, under 400 KB) or edit **Full name**.

   <div class="docs-screenshot-compact">

   ![My profile with name, email, and profile picture controls](./assets/my-account-profile-settings.png)

   </div>

To change your password later, see [Update your password](/guides/govern/manage-access/update-your-password/).

## Enable multi-factor authentication

Set up MFA to protect your account.

1. **Open My profile.** Click your account in the bottom-left corner of Studio, then choose **My profile**.

   <div class="docs-screenshot-compact">

   ![Open My profile from the sidebar](./assets/open-profile-sidebar.png)

   </div>

2. **Register a device.** On the **Two-Factor Authentication** card, click **Register a device**.

   <div class="docs-screenshot-compact">

   ![Register a device on My profile](./assets/enable-two-factor-authentication.png)

   </div>

3. **Scan the QR code and verify.** In the **Authenticator setup** dialog, scan the QR code with your authenticator app
   (for example Google Authenticator or Authy), enter the verification code, then click **Next**.

   <div class="docs-screenshot-compact">

   ![Scan the MFA QR code and enter the verification code](./assets/scan-mfa-qr-code.png)

   </div>

4. **Finish setup.** Confirm the success message, then click **Finish**.

   <div class="docs-screenshot-compact">

   ![Authenticator setup success](./assets/authenticator-setup-success.png)

   </div>

When setup finishes, the **Two-Factor Authentication** card shows **Enabled**. To replace your authenticator, click
**Update 2FA device**.

   <div class="docs-screenshot-compact">

![Two-factor authentication enabled on My profile](./assets/mfa-enabled-status.png)

   </div>

## Related

- [Single sign-on (SSO)](/guides/govern/administrating-the-platform/single-sign-on-sso/) — configure and use SSO for your
  organization.
- [Update your password](/guides/govern/manage-access/update-your-password/) — change your password from **My profile**.
