diff --git a/Documents/JournalDeBord/authentification.md b/Documents/JournalDeBord/authentification.md new file mode 100644 index 0000000..bd8debe --- /dev/null +++ b/Documents/JournalDeBord/authentification.md @@ -0,0 +1,36 @@ +# Authentification + +## Contexte + +Le projet demande de pouvoir authentifier les utilisateurs présents. Le but étant de leurs associer un "contexte" +(cours, informations personnelles, ...). Pour que ceux-ci puissent accomplir différentes actions nécéssitantes une +identification (permission, info personelles, ...). + +## Méthode + +Lorsque qu'un utilisateur se connecte au serveur, nous lui envoyons un token qui sera stocké dans le +navigateur. Ce token est unique à l'utilisateur et pourra être ré-envoyé dans les futures requêtes +pour identifier l'utilisateur. + +Ce token est donc une chaine de 64 caractères suivant la norme ISO_8859_1(8bits par cararctère) aléatoires,ce qui est d'après nos recherches suffisant. + +De plus une limite de 5 token par utilisateur sera ajoutée de sorte à +1) S'assurer qu'une personne ne noie la base de donnée de tokens. +2) Ajouter une protection supplémentaire pour assurer qu'un token est bien unique à un utilisateur. + +## Autres méthodes envisagée + +### Oauth2 + +C'est un protocol d'identification vastement utilisé permettant, en plus d'identifier les requettes, +de gérer leurs permissions. Un utilisateur créen un token peut lui attribuer des permissions +spécifique qui restrainderaients les permissions d'utilisation de ce token. C'est très utile pour +déployer des api de site pouvant notament être accédé par des ordinateurs / bots. Ca n'est en +revanche pas l'objectif du projet et l'option n'a donc pas été retenue + +### Spring Sessions / Tomcat sessions + +Il aurait été possible de laisser une librairie automatiser les sessions. Malheuresement, celà +implique de devoir se plier au format de la dite librairie. L'implémentation d'un système de gestion +de token maison semblai à la fois, non-imposible et interessant à notre apprentisage. C'est pourquoi +nous n'avons pas utilisé cette option. diff --git a/frontend/src/rest/ServiceInscription.js b/frontend/src/rest/ServiceInscription.js new file mode 100644 index 0000000..ee75c3b --- /dev/null +++ b/frontend/src/rest/ServiceInscription.js @@ -0,0 +1,35 @@ +/** + * functions to handle register requests. + * + * TODO: On time of writing, the backend doesn't support these endpoints so it could be modified in the future. + */ +import { restGet } from './restConsumer.js' + +/** + * create a new register requests that can be recovered by the registering service + * TODO: add info in the Object (I don't know what will be needed) + */ +export async function createRegister(){ + return restPost("/requests/register"}); +} + +/** + * list all register request in a list of Objects + */ +export async function getRegisters(){ + return restGet("/requests/register") +} + +/** + * Get info on a particular registering request + */ +export async function getRegisters(id){ + return restGet("/requests/register/" + id); +} + +/** + * Change the state of a requests. + */ +export async function validateRegister(id, state){ + return restPost("/requests/register/" + id, {state: state}); +} diff --git a/frontend/src/rest/Users.js b/frontend/src/rest/Users.js index 9ca59a1..e34d611 100644 --- a/frontend/src/rest/Users.js +++ b/frontend/src/rest/Users.js @@ -6,7 +6,6 @@ export async function login(user, pass, exp){ export async function register(user, pass, mail){ return restPost("/user", {name: user, password: pass, mail: mail}); - restPost("/login", {login: user, password: pass, expiration: exp}) } /** diff --git a/frontend/src/rest/cursus.js b/frontend/src/rest/cursus.js new file mode 100644 index 0000000..5aad5be --- /dev/null +++ b/frontend/src/rest/cursus.js @@ -0,0 +1,41 @@ +/** + * cursus API + */ + +import { restGet, restPostn, restDelete, restPatch } from './restConsumer.js' + +/** + * Create a new cursus (bundle of courses) + * @param courses list of courses + */ +export async function createCursus(courses){ + return restPost("/cursus", {courses: courses} ); +} + +/** + * Delete the specified cursus + */ +export async function deleteCursus(id){ + return restDelete("/cursus/" + id); +} + +/** + * Get informations on a particular cursus + * + * @param id identification of the cursus + * + * @return list of courses + */ +export async function getCursus(id){ + return restGet("/cursus/" + id); +} + +/** + * Modify the courses of a cursus + * + * @param id the id of the cursus + * @param courses list of new courses + */ +export async function alterCursus(id, courses){ + return restPatch("/cursus/" + id, courses); +}