User Tools

Site Tools


medal-data:troubleshooting-guide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
medal-data:troubleshooting-guide [2022/03/25 16:08] Alan Vonlanthenmedal-data:troubleshooting-guide [2022/04/20 11:32] (current) Sylvain
Line 1: Line 1:
 ====== medAL-data Troubleshooting Guide ====== ====== medAL-data Troubleshooting Guide ======
  
-===== I Cannot Login to medAL-data =====+=== I Cannot Login to medAL-data ===
  
 First, make sure that you entered the right email address and password. If you lost your password, you can still [[user-guide#Reset your own password |reset it]]. First, make sure that you entered the right email address and password. If you lost your password, you can still [[user-guide#Reset your own password |reset it]].
 If you are still unable to enter your credentials, this issue can happen for different reasons: If you are still unable to enter your credentials, this issue can happen for different reasons:
- 
- 
- 
  
 === The Specified Account Does not Exist === === The Specified Account Does not Exist ===
Line 13: Line 10:
 If the account you are trying to access does not exist, contact an administrator to create a new account, and give you the desired role. Alternatively, you can still [[user-guide#Register a User|create your own account]], but you will need to contact an administrator to give you the desired permissions. If the account you are trying to access does not exist, contact an administrator to create a new account, and give you the desired role. Alternatively, you can still [[user-guide#Register a User|create your own account]], but you will need to contact an administrator to give you the desired permissions.
  
 +=== The Specified Account Does not Exist (default account) ===
  
 +If you encounter this problem while trying to login to one of the default email addresses, it may be the case that the database has not yet been seeded. An administrator should seed the database, run:
 +<code>
 +sudo dokku enter <app_name> web php artisan db:seed
 +</code>
  
 +=== I can't access specific page OR I'm seeing the "You are not authorized" error message ===
 +
 +If you encounter this problem, and you think you should be able to access this page. It might be that the database lacks permissions or the assignment of permissions is incorrect. An administrator should repair the permission:
 +<code>
 +sudo dokku enter <app_name> web php artisan permission:fix
 +</code>
  
 === I'm Stuck at the Two-Factor Authentication Step === === I'm Stuck at the Two-Factor Authentication Step ===
Line 20: Line 28:
 If you lost your 2FA code, and cannot successfully login at the registration step, notice that you can logout by clicking on ''Abort authentication''. If you lost your 2FA code, and cannot successfully login at the registration step, notice that you can logout by clicking on ''Abort authentication''.
 Contact an administrator to [[administrator-guide#Generate user's new secret|reauthenticate your 2FA secret]]. You will receive an email with the new code, and follow [[[user-guide#Setup Google Authenticator|this procedure]] to setup Google Authenticator. Contact an administrator to [[administrator-guide#Generate user's new secret|reauthenticate your 2FA secret]]. You will receive an email with the new code, and follow [[[user-guide#Setup Google Authenticator|this procedure]] to setup Google Authenticator.
- 
- 
- 
- 
-=== The Database Has not Been Seeded === 
- 
-If you encounter this problem while trying to login to one of the default email addresses, it may be the case that the database has not yet been seeded. An administrator should seed the database, run: 
-<code> 
-php artisan db:seed 
-</code> 
- 
- 
- 
  
 === Two-Factor Authentication Is not Enabled on your Account === === Two-Factor Authentication Is not Enabled on your Account ===
  
-If the Two-factor authentication strategy is not enabled for your account, contact an administrator to [[administrator-guide#Generate user's new secret|generate a new secret for you]].  +If the Two-factor authentication strategy is not enabled for your account or if you have a error 500 after entering your password, contact an administrator to [[administrator-guide#Generate user's new secret|generate a new secret for you]].
- +
- +
  
 === I Lost my Two-Factor Authentication Code === === I Lost my Two-Factor Authentication Code ===
Line 45: Line 37:
 If you cannot login to medAL-//data// because you lost your two-factor authentication credentials, you should contact an administrator to [[administrator-guide#Generate user's new secret|reauthenticate your 2FA secret]]. You will receive an email with the new code, and follow [[user-guide#Setup Google Authenticator|this procedure]] to setup Google Authenticator. If you cannot login to medAL-//data// because you lost your two-factor authentication credentials, you should contact an administrator to [[administrator-guide#Generate user's new secret|reauthenticate your 2FA secret]]. You will receive an email with the new code, and follow [[user-guide#Setup Google Authenticator|this procedure]] to setup Google Authenticator.
  
 +=== My 2FA OTP code is not recognized when I try to login ==
  
-=== My 2FA OTP code is not recognized when I try to login == 
 Make sure that the clock of the device running Google Authenticator (or whatever two-step verification software you are using) is set to "Automatic (provided by the network)" Make sure that the clock of the device running Google Authenticator (or whatever two-step verification software you are using) is set to "Automatic (provided by the network)"
 +
medal-data/troubleshooting-guide.1648220911.txt.gz · Last modified: 2022/03/25 16:08 by Alan Vonlanthen