Differences

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

--- medal-data:troubleshooting-guide [2022/01/10 14:55] – created arnaud_poletto
+++ medal-data:troubleshooting-guide [2022/04/20 11:32] (current) – Sylvain
@@ Line 1: / Line 1: @@
 ====== 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 [[medal-data-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:
 === The Specified Account Does not Exist ===
-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 [[medal-data-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 ===
-=== I'm Stuck at the Two-Factor Authentication Step ===
+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:
-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 [[medal-data-administrator-guide#Generate user's new secret|reauthenticate your 2FA secret]]. You will receive an email with the new code, and follow [[[medal-data-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
+sudo dokku enter <app_name> web php artisan permission:fix
 </code>
+=== I'm Stuck at the Two-Factor Authentication Step ===
+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.
 === 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 [[medal-data-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 ===
+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 ==
-===== I Lost my Two-Factor Authentication Code =====
+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)"
-If you cannot login to medAL-//data// because you lost your two-factor authentication credentials, you should contact an administrator to [[medal-data-administrator-guide#Generate user's new secret|reauthenticate your 2FA secret]]. You will receive an email with the new code, and follow [[medal-data-user-guide#Setup Google Authenticator|this procedure]] to setup Google Authenticator.