Skip to content

Sign In & Authentication

Basin offers multiple ways to sign in to your account, including traditional email/password and social OAuth providers.

Sign In Options

Basin supports the following authentication methods:

Method Description
Email & Password Traditional sign-in with your email address and password
Google Sign in with your Google account
GitHub Sign in with your GitHub account
Facebook Sign in with your Facebook account
Twitter Sign in with your Twitter/X account

Email & Password Sign In

Creating an Account

  1. Visit usebasin.com/users/sign_up
  2. Enter your email address
  3. Create a strong password
  4. Click Sign Up
  5. Check your email for a confirmation link
  6. Click the link to verify your account

Signing In

  1. Visit usebasin.com/users/sign_in
  2. Enter your email address and password
  3. Click Submit
  4. If MFA is enabled, enter your verification code

Password Requirements

  • Minimum 8 characters
  • Should include a mix of letters, numbers, and symbols for security

Forgot Password

If you forget your password:

  1. Go to usebasin.com/users/password/new
  2. Enter your email address
  3. Click Send me reset password instructions
  4. Check your email for the reset link
  5. Click the link and create a new password

Social OAuth Sign In

Social sign-in allows you to use existing accounts from Google, GitHub, Facebook, or Twitter to access Basin without creating a separate password.

Benefits of OAuth Sign In

  • Convenience: No additional password to remember
  • Security: Leverages the security of established providers
  • Fast Access: Sign in with just a few clicks
  • Automatic Account Creation: New accounts are created automatically on first sign-in

Supported Providers

Google

Sign in using your Google account (Gmail, Google Workspace, etc.)

  1. Click Sign in with Google on the login page
  2. Select your Google account
  3. Grant Basin permission to access your basic profile info
  4. You're signed in!

GitHub

Sign in using your GitHub account - popular with developers.

  1. Click Sign in with GitHub on the login page
  2. Authorize Basin to access your GitHub account
  3. You're signed in!

Facebook

Sign in using your Facebook account.

  1. Click Sign in with Facebook on the login page
  2. Log in to Facebook if prompted
  3. Grant Basin permission to access your basic profile info
  4. You're signed in!

Twitter/X

Sign in using your Twitter (X) account.

  1. Click Sign in with Twitter on the login page
  2. Authorize Basin to access your Twitter account
  3. You're signed in!

Managing Connected Accounts

If you signed up using an OAuth provider, you can view and manage your connection in Account Settings.

Viewing Your Connection

  1. Navigate to Account Settings → General Settings
  2. Scroll to the Social Sign In Connections section
  3. View which provider is currently connected to your account

Removing a Connection

Set a Password First

Before removing your OAuth connection, make sure you have set a password for your Basin account. Otherwise, you may lose access to your account.

  1. Navigate to Account Settings → General Settings
  2. Find the Social Sign In Connections section
  3. Click Remove next to the connected provider
  4. Confirm the removal

After removal, you'll need to sign in using your email and password.

Setting a Password for OAuth Accounts

If you originally signed up with OAuth and need to set a password:

  1. Navigate to Account Settings → Security Settings
  2. If you haven't set a password yet, you'll see a prompt to set one
  3. Alternatively, use the "Forgot Password" flow to create a password

Multi-Factor Authentication (MFA)

For enhanced security, you can enable Multi-Factor Authentication on your Basin account. MFA requires a second verification step when signing in.

See the Security & MFA guide for detailed setup instructions.

Session Management

Session Duration

  • Basin sessions remain active while you're using the application
  • Sessions may expire after extended periods of inactivity
  • For security, you're automatically logged out after prolonged inactivity

Signing Out

To sign out of Basin:

  1. Click your avatar in the top navigation
  2. Select Sign Out

For security, always sign out when using shared or public computers.

Troubleshooting

"Invalid Email or Password" Error

  • Double-check your email address for typos
  • Ensure Caps Lock is not enabled
  • Try using the "Forgot Password" flow to reset your password
  • If using OAuth, make sure you're clicking the correct provider button

OAuth Sign-In Not Working

  • Ensure pop-ups are not blocked in your browser
  • Try clearing your browser cache and cookies
  • Check if you have third-party cookie blocking enabled
  • Try signing in using an incognito/private browser window

"Email Already Taken" Error

This means an account already exists with that email address. Options:

  1. Use Forgot Password: Reset the password for the existing account
  2. Use OAuth: If the account was created with OAuth, use that provider to sign in
  3. Contact Support: If you can't access the account, reach out to support

Locked Out of Account

If you're locked out after too many failed attempts:

  • Wait 30 minutes before trying again
  • Use the "Forgot Password" flow to reset your password
  • Contact support if issues persist

Security Best Practices

  1. Use a Strong Password: Combine letters, numbers, and symbols
  2. Enable MFA: Add an extra layer of security with two-factor authentication
  3. Don't Share Credentials: Keep your login information private
  4. Use OAuth Wisely: Only connect accounts from trusted providers
  5. Sign Out on Shared Devices: Always log out when using public computers
  6. Monitor Account Activity: Review your forms and submissions for unexpected changes