Authorization & Authentication

This guide covers all authentication workflows on the EduSoft platform, including standard login, social login, password reset, email verification, and student passwordless login.

• Why this matters: Securely access your account with multiple authentication methods designed for different user roles and security needs.
• Who uses it: All users (Admins, Teachers, Students, Parents, Secretaries, Coordinators).
• When to use it: First-time setup, daily login, password recovery, or when your organization requires additional verification.

---

How to Use

Standard Login with Email and Password

Standard login is available for all user roles.

1. From the Landing Page (homepage), click the Login button in the top right corner.
2. Enter your Email Address in the email field.
3. Enter your Password in the password field.
4. Click the Login button.
5. If MFA is enabled, enter the 6-digit code from your authenticator app when prompted.
6. You will be redirected to your role-specific dashboard (Admin, Teacher, Student, etc.).

Login with Google (Social Login)

Social login allows you to sign in using your Google account without entering a password.

1. From the Landing Page (homepage), click the Login button in the top right corner.
2. Click the Sign in with Google button.
3. Select your Google account from the popup window.
4. Grant permissions if prompted.
5. You will be automatically logged in and redirected to your dashboard.

Demo Mode Login

Demo mode allows you to explore the platform without creating an account.

1. From the Landing Page (homepage), click the Login button in the top right corner.
2. Click the Try Demo button.
3. You will be logged in as a demo user with limited access.
4. Explore the platform features without affecting real data.

Student Passwordless Login (Code-Based)

Students can sign in using a passwordless code sent to their email.

1. From the Landing Page (homepage), click the Login button in the top right corner.
2. Click the Sign in with a code link at the bottom of the page.
3. Enter your Email Address.
4. Click Send Code.
5. Check your email for a 6-digit verification code.
6. Enter the code in the verification field.
7. Click Verify to access your dashboard.

---

Password Reset Flow

Step 1: Request Password Reset

1. From the Landing Page (homepage), click the Login button in the top right corner.
2. Click the Forgot Password link below the password field.
3. Enter your Email Address.
4. Click Send Reset Email.
5. Check your email for a password reset link.

Step 2: Set New Password

After clicking the reset link in your email:

1. You will be redirected to the Set Password Page with reset parameters.
2. Enter your New Password (minimum 8 characters).
3. Enter Confirm Password to verify it matches.
4. Click Set Password.
5. You will be redirected to the login page.
6. Log in with your new password.

---

Email Verification Flow

During Account Setup by Admin

When an admin creates your account:

1. You will receive an email with login instructions.
2. Your email address will be prefilled when you access the login page.
3. If email verification is required, a verification code will be automatically sent to your email.
4. Enter the 6-digit code from your email.
5. Click Verify.
6. You will be redirected to the login page with your email prefilled.
7. Log in with your admin-provided credentials.

Manual Email Verification

If you need to verify your email later:

1. From the Landing Page (homepage), click the Login button in the top right corner.
2. If you haven't verified your email and try to log in, an alert will appear below the login form.
3. Click Resend Verification Email in the alert.
4. You will be redirected to the email verification page.
5. Enter your Email Address.
6. Click Send Code.
7. Check your email for a 6-digit verification code.
8. Enter the code in the verification field.
9. Click Verify.

Resend Verification Email from Login

If you haven't verified your email and try to log in:

1. An alert message will appear below the login form.
2. Click Resend Verification Email.
3. Check your email for the verification code.
4. You will be automatically redirected to the email verification page where you can enter the code.

---

Organization Sign Up Flow

Create a New Organization

The Sign Up feature is used by organizations to create their EduSoft account, not by individual users to create personal accounts.

1. From the Landing Page (homepage).
2. Click the Sign Up button in the top right corner.
3. Fill in the organization details:
   • Email Address (organization admin email)
   • Organization Name
   • Admin First Name
   • Admin Last Name
   • Password (minimum 8 characters)
   • Confirm Password (must match password)
4. Click Sign Up.
5. You will be automatically redirected to the email verification page.
6. Verify your email using the code sent to your inbox.
7. After verification, return to the login page and sign in as the organization admin.

---

Multi-Factor Authentication (MFA)

If MFA is enabled for your account:

1. After entering your email and password, click Login.
2. An MFA prompt will appear instead of the standard login form.
3. Open your authenticator app (Google Authenticator, Authy, etc.).
4. Enter the 6-digit code from your authenticator app.
5. Click Verify.
6. You will be logged in and redirected to your dashboard.

---

Password Requirements

When creating or resetting your password:

• Minimum Length: 8 characters
• Recommended: Mix of uppercase and lowercase letters, numbers, and special characters
• Security: Avoid using common words or personal information

---

For Organization Types

---

Tips

• Save Your Password: Use a secure password manager to store your credentials.
• Enable MFA: For added security, enable multi-factor authentication in your profile settings.
• Check Email: Always check your spam folder if you don't receive verification or reset emails.
• Session Timeout: Your session will automatically timeout after 30 minutes of inactivity for security.
• Student Code Login: Use the passwordless code login for quicker access without remembering passwords.
• Google Login: Use social login if you have trouble remembering passwords.
• Link Expiration: Password reset and verification links expire for security. Request new ones if needed.
• Email Verification: You must verify your email before accessing full platform features.
• Demo Mode: Try demo mode to explore the platform before creating an account.

---

Troubleshooting

Forgot Password Link Not Working

• Check if the link has expired (request a new one).
• Ensure you clicked the link within the email (copy-paste may not include all parameters).
• Verify you're using the correct email address.

Email Verification Code Not Received

• Check your spam/junk folder.
• Wait a few minutes and click "Resend Code".
• Verify your email address is correct.
• Contact support if the issue persists.

Can't Log In After Password Reset

• Ensure you're using the new password you just set.
• Wait a few seconds for the system to update.
• Try logging in again or request another reset link.

MFA Code Not Working

• Ensure your device's time is synchronized correctly.
• Check that you're entering the correct code from your authenticator app.
• Request a new MFA code if needed.

Social Login Not Working

• Ensure your Google account email matches your EduSoft account.
• Clear your browser cache and cookies.
• Try logging in with email and password instead.

---

Related Articles

• Dashboard Overview
• Navigation Guide
• Tables Guide
• Profile Page