diff --git a/FAQ.md b/FAQ.md index 3406f0b..f1e0d2c 100644 --- a/FAQ.md +++ b/FAQ.md @@ -1,5 +1,7 @@ **This page will hold the answers for Frequently Asked Questions.** +Please note that this FAQ also contains specific information that apply only to our pilot instance of ReCodEx at [MFF-UK](https://www.mff.cuni.cz/). If you have a specific problem with this instance, contact the administrator (`recodex@mff.cuni.cz`). + ## Browser Issues First, make sure you are using a modern web browser, preferably Mozilla Firefox or Google Chrome. Although our objective is to support all modern browsers, rapid development prevents us from doing extensive testing across many platforms; hence, we are sticking with the aforementioned two browsers for now. @@ -10,16 +12,24 @@ Sometimes a component on a page does not refresh itself correctly. The applicati ## How to register into ReCodEx and what method should I use? -ReCodEx provides multiple ways for a user to register and log in. Currently there are two options: a **local** ReCodEx account or an account bound to the **CAS** service. The preferred way of registration and authentication is using the CAS service and using a local account only in special circumstances. CAS authentication provides more features, such as automatic binding of users to **SIS** groups. +First of all please note that you need to register before signing in (those are different steps). -### I registered using a local account but I want to use also CAS and its advantages +ReCodEx provides multiple ways for a user to register and log in. Currently there are two options: a **local** ReCodEx account or an account bound to the **CAS** service. The preferred way of registration and authentication is using the CAS service and using a local account only in special circumstances. CAS authentication provides more features, such as automatic binding of users to **SIS** groups. At present, the CAS registration is the only option enabled. -The system's login mechanism is prepared for this option. The only prerequisite is that your email address in the local account must be the same as the one in CAS. If this is the case, binding the accounts is quite easy, just log in using CAS and the system will automatically bind those two accounts. Also please note that when binding your local account your password will be cleared and if you want to use it further, you have to change it. +### I have successfully passed CAS authentication for the registration, but then I ran into an error + +There are two most often errors. First one is that your LDAP data (in CAS service) do not contain email address (i.e., you will get `The user attributes received from the CAS do not contain an email address` error). In this case, the remedy should be simple enough. Just fill in you email address [in CAS administration](https://ldap1.cuni.cz/). + +The second most frequent reason is that your account does not have appropriate affiliation attributes (`The user attributes received from the CAS has no affiliation attributes that would allow registration in ReCodEx. Authenticated account does not belong to a student not to an employee of MFF.`). In such case you should either attempt to set your LDAP records straight or (if you are not a regular student), ask the administrator to create you an account manually. We are planning a feature that will allow the teachers to send invitations to external users, but it will not be ready any time soon. ### I registered using a CAS account but I also want to use a local one User can create local account in the profile **Settings** page. In here if you are registered using external account and not local one, you should see **Create local account** button. After clicking on it local login _without_ password will be created. Next thing you have to set your password to newly created local login. +### I registered (had created) a local account but I want to use also CAS and its advantages + +The system's login mechanism is prepared for this option. The only prerequisite is that your email address in the local account must be the same as the one in CAS. If this is the case, binding the accounts is quite easy, just log in using CAS and the system will automatically bind those two accounts. Also please note that when binding your local account your password will be cleared and if you want to use it further, you have to change it. + ## C# Reader In **C#** language there are none of the handy functions to operate with textual inputs like _scanf_ in **C**. Therefore for every C# build in ReCodEx there is [Reader.cs](https://github.com/ReCodEx/utils/blob/master/runners/cs/Reader.cs) library included to make life of C# programmers easier. Please note that library is suppose to work only with ASCII files and some difficulties can be observed with modern Unicode (UTF-8) encodings.