> ## Documentation Index
> Fetch the complete documentation index at: https://docs.junojourney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Login Issues

> Common login problems and how to fix them.

export const InternalNote = ({children}) => {
  const [isInternal, setIsInternal] = useState(false);
  useEffect(() => {
    const user = window.__mintlify_user__;
    if (user?.groups?.includes("internal")) setIsInternal(true);
  }, []);
  if (!isInternal) return null;
  return <div className="internal-note">
      <strong className="internal-note-title">🔒 Internal Note</strong>
      <div>{children}</div>
    </div>;
};

## "Your email or password is incorrect"

This error appears when:

* The email address isn't registered in Juno
* The password is wrong
* Your account uses SSO but you're trying to log in with email/password

**What to try:**

1. Double-check you're using your work email (not personal)
2. Use **Forgot password** on the login page to reset
3. If your company uses SSO (Google, Microsoft, Okta), use the SSO login button instead

<InternalNote>
  Firebase error `auth/user-not-found` → user doesn't exist under this tenant. Check Firebase console → correct tenant ID. Common cause: user was created under the wrong tenant (tenant ID must match the org slug exactly). `auth/wrong-password` → user exists but wrong password — direct to reset flow.
</InternalNote>

***

## Forgot password / password reset email not arriving

1. Check your spam/junk folder
2. Make sure you're checking the right inbox — use your work email
3. Wait a few minutes — transactional emails can be delayed

If no email arrives after 5 minutes, contact your Juno administrator.

<InternalNote>
  If reset email doesn't arrive: check Firebase auth console → verify the user exists under the correct tenant. The tenant ID in Firebase must match the org slug. Also check SendGrid delivery logs for bounce or block. Known issue: SSO users (Google/LinkedIn/SAML) do not have a Firebase password — they cannot use the email/password reset flow.
</InternalNote>

***

## SSO login fails or redirects to an error page

If your company uses Single Sign-On (Google, Microsoft, Okta, etc.):

1. Make sure you're clicking the correct SSO button (not "Sign in with email")
2. Try clearing your browser cache and cookies, then retry
3. Try an incognito/private browser window
4. Contact your IT team — SSO issues often involve an expired certificate or misconfigured identity provider

<InternalNote>
  SSO failures: check Admin → Integrations → SSO. Confirm SAML config is active and the tenant ID in the SSO config matches the org slug exactly. Common failure modes: expired signing certificate, attribute mapping mismatch (email field not mapped), incorrect callback URL. Enable `TenantAuth.saml.logProfile = true` in the tenant config to log the full SAML assertion for debugging.
</InternalNote>

***

## "Access denied" or blank screen after login

You may be logged in but seeing no content. This can happen if:

* **Your account has been deactivated** — contact your admin to reactivate
* **Your account is pending setup** — your admin may still be configuring your access
* **Your organization's modules haven't been activated** — there may be nothing to show yet

<InternalNote>
  Blank screen after login: check the user's role in MongoDB. Role 99 = blocked/deactivated — user can log in but sees nothing. Role is set via `inactive: true` on the user record (MongoDB) AND must be revoked in Firebase. If only one is updated there will be a sync mismatch. To reactivate: Admin → Users → \[User] → Reactivate (updates both).
</InternalNote>

***

## I'm using the right password but still can't log in

* Try resetting your password via **Forgot password**
* Check if your company has migrated to SSO — you may need to use SSO going forward
* Clear your browser cache and try again
* Try a different browser

If none of these work, contact your administrator.

***

## I can't log in on mobile

Juno is a web app — use your mobile browser (Chrome, Safari) and navigate to your company's Juno URL. There is no separate mobile app download required.

If the browser shows a certificate or connection error, your company's network may be blocking the URL — try on a different network (e.g. mobile data instead of office WiFi).
