Skip to content

Authentication ​

Authentication secures access to Gryffi by verifying user identity through passwords and two-factor authentication.

Overview ​

Authentication methods:

  • Email/password login
  • Two-factor authentication (2FA)
  • Magic links

Login Methods ​

Email/Password ​

Standard login:

  1. Enter registered email
  2. Enter password
  3. Click "Sign In"
  4. Complete 2FA if enabled

Two-Factor Authentication ​

Setup ​

Enable 2FA in account settings:

  1. Go to Settings → Security
  2. Click "Enable 2FA"
  3. Now every time you login you get email verification

See: two factor authentication

Using 2FA ​

Login with 2FA:

  1. Enter email and password
  2. Enter one time passcode from email
  3. Access granted

Security Features ​

Account Protection ​

FeatureDescription
Failed Login LockoutTemporary lock after failed attempts
Session ManagementControl active sessions

Password Requirements ​

RequirementStandard
Minimum Length8 characters
UppercaseAt least 1
NumbersAt least 1
Special CharactersAt least 1

Session Management ​

For End Users ​

End User Authentication ​

End users can authenticate via:

  • Magic links

Public Journey Access ​

Public journeys may not require authentication:

  • Anonymous access
  • Identification for form steps, reward steps and poll steps

For Administrators ​

User Management ​

ActionDescription
Reset PasswordSend reset email
Disable AccountPrevent login
Force LogoutEnd all sessions

Troubleshooting ​

Can't Log In ​

  1. Verify email is correct
  2. Check password (case-sensitive)
  3. Try password reset
  4. Contact your admin if locked out

2FA Issues ​

  1. Check your spam folder

Best Practices ​

For Users ​

  • Use strong, unique passwords
  • Enable two-factor authentication
  • Don't share credentials
  • Log out on shared devices

For Administrators ​

  • Use 2FA for admins
  • Use strong, unique passwords
  • Don't share credentials
  • Log out on shared devices

Gryffi Community Edition is open source under the AGPL-3.0.