User Manual
Sign In with Google
This page facilitates signing into the application using your Google account.
Sign In with Google
Summary
This page allows you to quickly sign into your account using your existing Google account. When you arrive on this page, the application automatically starts the process of redirecting you to Google to confirm your identity. Once confirmed, you will be brought back to the application, logged in and ready to use its features.
Page Access
You can access this page by navigating to: /signinwithgoogle
Page Functionalities
Upon entering this page, you will notice the following elements and behaviors:
- Automatic Redirection: The page immediately attempts to send you to Google's sign-in page. During this brief moment, you will see a loading animation and the message "Redirecting to Google...".
- Error Message Display: If for any reason the sign-in process with Google cannot be initiated or fails, an error message will appear, stating "Sign in with Google failed. Please try again."
- Back to Login Button: When an error occurs, a "Back to Login" button becomes visible. Clicking this button will take you back to the main login screen, where you can choose another sign-in method or try again.
- Automatic Return to Login on Error: If an error occurs, the application will automatically redirect you to the main login screen after a short delay (approximately 3 seconds) if you do not interact with the page.
Scenario Executions
Possible usage steps within this page
Here’s how you might successfully use the "Sign In with Google" feature:
- Successful Google Sign-In:
- You arrive on the "Sign In with Google" page.
- The page displays "Redirecting to Google..." along with a loading indicator.
- Your browser automatically opens or redirects to Google's sign-in page.
- You successfully log in with your Google account and grant necessary permissions.
- You are automatically redirected back to the application, now successfully logged in to your account.
Possible errors which may occur on this page
Sometimes, issues can prevent a smooth sign-in. Here’s what might happen and why:
- Sign-in with Google failed immediately:
This error, displayed as "Sign in with Google failed. Please try again.", occurs if the application cannot even begin the redirection process to Google. This might be due to a temporary network problem, an issue with the application's configuration, or a problem connecting to the Google service.
When this happens:
- The "Redirecting to Google..." message disappears, replaced by the error message.
- A "Back to Login" button appears.
- If you do nothing, the application will automatically take you back to the main login screen after a few seconds. You can try signing in again or choose a different method.
- Sign-in with Google failed after redirection (less common, but possible):
Although the page successfully redirects you to Google, an issue might occur during or after your interaction with Google's sign-in page, preventing you from being successfully logged into the application upon your return. This could be due to a problem with Google's response, an interruption during redirection back to the application, or an issue when the application tries to establish your session.
When this happens, you would likely be brought back to the application's login screen, potentially with an error message, and would need to try again or use another login method.
Since this view specifically handles the initiation of the sign-in and not the post-redirect processing, it would typically result in a similar outcome as the "failed immediately" scenario: an error message will be shown, and you will be directed back to the login page.
