Diferencia entre revisiones de «Autenticación - 17 18 - G2»
(→Gestión de las ramas) |
(→APIs y datos que se usarán y devolverán) |
||
(No se muestran 30 ediciones intermedias de 4 usuarios) | |||
Línea 9: | Línea 9: | ||
* Tania Salguero Álvarez | * Tania Salguero Álvarez | ||
* Damián Serrano Fernández | * Damián Serrano Fernández | ||
− | + | ''' | |
− | |||
== Objetivo del subsistema == | == Objetivo del subsistema == | ||
''' | ''' | ||
Línea 18: | Línea 17: | ||
== Tecnologías elegidas == | == Tecnologías elegidas == | ||
*Subsistema: Autenticación | *Subsistema: Autenticación | ||
− | *Lenguaje/Herramienta: Plugin para Eclipse Neon.3 (4.6.3) de Python 2.7 | + | *Lenguaje/Herramienta: Plugin para Eclipse Neon.3 (4.6.3) de Python 2.7, Django 1.11, Django REST API |
*Sistema de gestión de bibliotecas: pip | *Sistema de gestión de bibliotecas: pip | ||
− | *Bibliotecas: | + | *Bibliotecas: MySQL, Django REST API |
− | *Necesita Base de datos: Sí ( | + | *Necesita Base de datos: Sí (MySQL) |
== Consideraciones == | == Consideraciones == | ||
Línea 32: | Línea 31: | ||
== Gestión del trabajo == | == Gestión del trabajo == | ||
− | Para gestionar las tareas y el tiempo usaremos | + | Para gestionar las tareas y el tiempo usaremos Toggl. Ambas herramientas conjuntas nos permiten repartir las tareas entre los miembros del equipo y contabilizar el tiempo real que cada uno invierte en ellas. |
== Gestión del código == | == Gestión del código == | ||
− | Realizaremos la gestión del código a través de GitHub. Los commits tendrán el siguiente formato: | + | Realizaremos la gestión del código a través de GitHub con el formato dado por el grupo de integración. Los commits tendrán el siguiente formato dado por el grupo de integración: |
Título del commit: tipo: aquí ponemos el título | Título del commit: tipo: aquí ponemos el título | ||
Cuerpo del commit: aquí describimos el commit. | Cuerpo del commit: aquí describimos el commit. | ||
Pie del commit: Closes #<número de la incidencia en GitHub> | Pie del commit: Closes #<número de la incidencia en GitHub> | ||
+ | |||
+ | A continuación se detalla un ejemplo: | ||
+ | |||
+ | '''Título del commit''': fix: redirección errónea tras intentar | ||
+ | un usuario autenticarse | ||
+ | '''Cuerpo del commit''': Después de que el usuario intente autenticarse era redireccionado a una URL no existente. Ahora el usuario es redireccionado a su inicio de sesión. | ||
+ | '''Pie del commit''': Closes #<número de la incidencia en GitHub> | ||
+ | |||
+ | Ejemplo en texto: | ||
+ | fix: redirección errónea tras intentar autenticarse | ||
+ | |||
+ | Después de que el usuario intentara autenticarse, este era redireccionado a una URL no existente. Ahora el usuario es redireccionado a su inicio de sesión. | ||
+ | |||
Los tipos de commit son los siguientes: | Los tipos de commit son los siguientes: | ||
Línea 51: | Línea 63: | ||
== Gestión de las incidencias== | == Gestión de las incidencias== | ||
− | La gestión de las incidencias se realizará siguiendo el siguiente formato: | + | La gestión de las incidencias se realizará siguiendo el siguiente formato dado por el grupo de integración: |
'''Título''': <breve título sobre la incidencia> | '''Título''': <breve título sobre la incidencia> | ||
'''Prioridad''': a seleccionar entre distintos valores: ''urgente'', ''alto'', ''medio'', ''bajo''. | '''Prioridad''': a seleccionar entre distintos valores: ''urgente'', ''alto'', ''medio'', ''bajo''. | ||
Línea 62: | Línea 74: | ||
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro | ''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro | ||
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión | ''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión | ||
+ | |||
+ | |||
+ | === Procedimiento general para la gestión de incidencias === | ||
+ | # Establecer a un miembro del equipo el rol de gestor de incidencias. | ||
+ | # Cuando se registre una incidencia, el gestor deberá evaluar la prioridad, asignar las etiquetas correspondientes (si faltasen) y un responsable de la incidencia. | ||
+ | # El responsable trabajará en la incidencia. Si un commit cierra una incidencia deberá incluir en el cuerpo del commit "Closes #<id de la incidencia>" | ||
+ | |||
+ | Las incidencias pueden incluirse en ''Proyectos'' de GitHub. | ||
== Gestión de las ramas== | == Gestión de las ramas== | ||
Línea 67: | Línea 87: | ||
''' | ''' | ||
+ | Gestionaremos el proyecto añadiéndo tantas ramas como personas trabajen en él, de esta manera las tareas se dividirán por persona. Esta gestión la hemos recogido de la proporcionada por el grupo de integración. | ||
+ | |||
+ | El coordinador de nuestro grupo, José Ángel, será el encargado de realizar los commit a la rama master. | ||
== APIs y datos que se usarán y devolverán == | == APIs y datos que se usarán y devolverán == | ||
''' | ''' | ||
− | Se va a utilizar la API del curso anterior, vamos a realizar un cambio de lenguaje a python y además haremos las modificaciones oportunas. | + | Se va a utilizar la API del curso anterior, vamos a realizar un cambio de lenguaje a python y además haremos las modificaciones oportunas junto con las pautas dada por el equipo de integración. Como el ser obligatorio que aparezcan en las respuestas los parámetros result (Es un Boolean que devuelve el resultado de la operación) y msg (Es un String que devuelve el memnsaje de resultado o error) |
{| border="2" style="border-collapse:collapse" | {| border="2" style="border-collapse:collapse" | ||
Línea 81: | Línea 104: | ||
! Respuesta | ! Respuesta | ||
! Ejemplo de respuesta | ! Ejemplo de respuesta | ||
+ | ! Petición HTTP | ||
|- | |- | ||
| getUser | | getUser | ||
Línea 86: | Línea 110: | ||
| | | | ||
* user: Nombre del usuario | * user: Nombre del usuario | ||
− | | url/api/ | + | | url/api/getUser/nombreusuario |
| JSON con el usuario pedido. Los datos del usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". | | JSON con el usuario pedido. Los datos del usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". | ||
| | | | ||
{ | { | ||
+ | "result" : true, | ||
+ | "msg" : "Successfull", | ||
"username" : "tansalalv", | "username" : "tansalalv", | ||
"name" : "Tania", | "name" : "Tania", | ||
Línea 97: | Línea 123: | ||
"autonomous_community" : "Andalucía", | "autonomous_community" : "Andalucía", | ||
"age" : "21", | "age" : "21", | ||
− | "role" : " | + | "role" : "ASISTENTE" |
} | } | ||
+ | | GET | ||
|- | |- | ||
| getRoleUser | | getRoleUser | ||
Línea 104: | Línea 131: | ||
| | | | ||
* user: nombre del usuario cuyo rol queremos obtener. | * user: nombre del usuario cuyo rol queremos obtener. | ||
− | | url/api/ | + | | url/api/getRoleUser/nombreusuario |
− | | JSON con el campo "role" indicando el rol del usuario siendo las opciones: " | + | | JSON con el campo "role" indicando el rol del usuario siendo las opciones: "ASISTENTE", "PONENTE", "AMBOS". |
| | | | ||
{ | { | ||
− | "role" = " | + | "result" : true, |
+ | "msg" : "Successfull", | ||
+ | "role" = "AMBOS" | ||
} | } | ||
+ | | GET | ||
|- | |- | ||
| getUsers | | getUsers | ||
| Obtiene todos los usuarios del sistema, incluyendo sus datos. | | Obtiene todos los usuarios del sistema, incluyendo sus datos. | ||
| | | | ||
− | | url/api/ | + | | url/api/getUsers |
| JSON con un array con los datos de cada usuario. Los datos de cada usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". | | JSON con un array con los datos de cada usuario. Los datos de cada usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". | ||
| | | | ||
[{ | [{ | ||
+ | "result" : true, | ||
+ | "msg" : "Successfull", | ||
+ | "username" : "josgarrod17", | ||
+ | "name" : "Jose Carlos", | ||
+ | "surname" : "García Rodríguez", | ||
+ | "email" : "mail1@example.com", | ||
+ | "genre" : "Masculino", | ||
+ | "autonomous_community" : "Andalucía", | ||
+ | "age" : "21", | ||
+ | "role" : "ASISTENTE" | ||
+ | }, | ||
+ | { | ||
+ | "result" : true, | ||
+ | "msg" : "Successfull", | ||
+ | "username" : "josdomesp", | ||
+ | "name" : "Jose Ángel", | ||
+ | "surname" : "Domínguez Espinaco", | ||
+ | "email" : "mail2@example.com", | ||
+ | "genre" : "Masculino", | ||
+ | "autonomous_community" : "Madrid", | ||
+ | "age" : "21", | ||
+ | "role" : "PONENTE" | ||
+ | }] | ||
+ | | GET | ||
+ | |- | ||
+ | | getUsersByRole | ||
+ | | Obtiene todos los usuarios del sistema que tenga el role pasado por parámetros, incluyendo sus datos. | ||
+ | | | ||
+ | | url/api/getUsersByRole/role | ||
+ | | JSON con un array con los datos de cada usuario que tenga el role pasado. Los datos de cada usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". | ||
+ | | | ||
+ | [{ | ||
+ | "result" : true, | ||
+ | "msg" : "Successfull", | ||
"username" : "josgarrod17", | "username" : "josgarrod17", | ||
"name" : "Jose Carlos", | "name" : "Jose Carlos", | ||
Línea 125: | Línea 189: | ||
"autonomous_community" : "Andalucía", | "autonomous_community" : "Andalucía", | ||
"age" : "21", | "age" : "21", | ||
− | "role" : " | + | "role" : "PONENTE" |
}, | }, | ||
{ | { | ||
+ | "result" : true, | ||
+ | "msg" : "Successfull", | ||
"username" : "josdomesp", | "username" : "josdomesp", | ||
"name" : "Jose Ángel", | "name" : "Jose Ángel", | ||
Línea 135: | Línea 201: | ||
"autonomous_community" : "Madrid", | "autonomous_community" : "Madrid", | ||
"age" : "21", | "age" : "21", | ||
− | "role" : " | + | "role" : "PONENTE" |
}] | }] | ||
+ | | GET | ||
|- | |- | ||
| checkToken | | checkToken | ||
Línea 142: | Línea 209: | ||
| | | | ||
* token: token a validar. | * token: token a validar. | ||
− | | url/api/ | + | | url/api/checkToken/token |
− | | JSON con | + | | JSON con los campos msg = 'Successful' y result = 'True' si es válido, msg = 'Error' y result = 'False' si no es válido |
| | | | ||
{ | { | ||
− | " | + | "result" : true, |
+ | "msg" : "Successfull" | ||
} | } | ||
+ | | GET | ||
|- | |- | ||
| checkTokenUser | | checkTokenUser | ||
| Comprueba si un token es válido para un usuario. Para ello, se obtiene el usuario pasado como parámetro, se genera el token del usuario y se comprueba si es igual que el pasado como parámetro. | | Comprueba si un token es válido para un usuario. Para ello, se obtiene el usuario pasado como parámetro, se genera el token del usuario y se comprueba si es igual que el pasado como parámetro. | ||
| | | | ||
− | * | + | * username: nombre del usuario cuyo token se va a comprobar. |
* token: token a validar. | * token: token a validar. | ||
− | | url/api/ | + | | url/api/checkTokenUser/username/token |
− | | JSON con | + | | JSON con los campos msg = 'Successful' y result = 'True' si es válido, msg = 'Error' y result = 'False' si no es válido |
+ | | | ||
+ | { | ||
+ | "result" : true, | ||
+ | "msg" : "Successfull", | ||
+ | } | ||
+ | | GET | ||
+ | |- | ||
+ | | postUser | ||
+ | | Se le pasa por parámetros los datos que el usuario ingresa para registrarse en el sistema, se comprueba si los datos son válidos y se guarda el usuario. | ||
+ | | | ||
+ | * formulario de ingreso en el sistema | ||
+ | | url/api/postUser | ||
+ | | JSON con el result y msg donde se muestra que todo ha ido correctamente. | ||
| | | | ||
{ | { | ||
− | " | + | "result" : true, |
+ | "msg" : "Successfull", | ||
} | } | ||
+ | |POST | ||
+ | |- | ||
|} | |} | ||
− | |||
== Enlaces == | == Enlaces == | ||
Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/95 | Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/95 | ||
GitHub: https://github.com/EGC-G2-Trabajo-1718/autenticacion | GitHub: https://github.com/EGC-G2-Trabajo-1718/autenticacion | ||
+ | |||
+ | == Vistas del subsistema == | ||
+ | Enlace a GitHub del proyecto con las vistas: https://github.com/EGC-G2-Trabajo-1718/autenticacion/tree/damserfer/ProyectoEGC |
Revisión actual del 16:31 9 ene 2018
Contenido
- 1 Resumen del trabajo
- 2 Miembros
- 3 Objetivo del subsistema
- 4 Tecnologías elegidas
- 5 Consideraciones
- 6 Gestión de la comunicación
- 7 Gestión del trabajo
- 8 Gestión del código
- 9 Gestión de las incidencias
- 10 Gestión de las ramas
- 11 APIs y datos que se usarán y devolverán
- 12 Enlaces
- 13 Vistas del subsistema
Resumen del trabajo
Nuestro trabajo consistirá en realizar el apartado de autenticación que consiste en dar acceso a los distintos usuarios validando su email y contraseña, permitiéndoles un espacio definido según su rol registrado.
Miembros
- Jose Carlos García Rodríguez
- Jose Ángel Domínguez Espinaco
- Tania Salguero Álvarez
- Damián Serrano Fernández
Objetivo del subsistema
Nuestro trabajo consistirá en realizar el apartado de autenticación definido arriba, el objetivo es conseguir que cada rol tenga su espacio independiente sin interferir con el de los demás, tiene que dar la posibilidad de que un mismo usuario se pueda registrar como poniente y como asistente con una sola cuenta y que no haya conflictos entre estas. Además, a la hora de la autenticación el usuario deberá completar un captcha para poder obtener dicho acceso.
Tecnologías elegidas
- Subsistema: Autenticación
- Lenguaje/Herramienta: Plugin para Eclipse Neon.3 (4.6.3) de Python 2.7, Django 1.11, Django REST API
- Sistema de gestión de bibliotecas: pip
- Bibliotecas: MySQL, Django REST API
- Necesita Base de datos: Sí (MySQL)
Consideraciones
- Se deben gestionar roles o permisos para permitir el acceso a los distintos subsistemas. Por ejemplo, permisos solo para votar, para organizar votaciones, gestionar censos, ...
- Debe permitir que los otros subsistemas puedan conocer si un usuario está autenticado
- Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Autenticaci%C3%B3n_B_1617
Gestión de la comunicación
La comunicación se realizará a través de un grupo de WhatsApp formado por los miembros del equipo de trabajo. Además, se realizarán reuniones tanto presenciales como telemáticas a través de Skype.
Gestión del trabajo
Para gestionar las tareas y el tiempo usaremos Toggl. Ambas herramientas conjuntas nos permiten repartir las tareas entre los miembros del equipo y contabilizar el tiempo real que cada uno invierte en ellas.
Gestión del código
Realizaremos la gestión del código a través de GitHub con el formato dado por el grupo de integración. Los commits tendrán el siguiente formato dado por el grupo de integración:
Título del commit: tipo: aquí ponemos el título Cuerpo del commit: aquí describimos el commit. Pie del commit: Closes #<número de la incidencia en GitHub>
A continuación se detalla un ejemplo:
Título del commit: fix: redirección errónea tras intentar un usuario autenticarse Cuerpo del commit: Después de que el usuario intente autenticarse era redireccionado a una URL no existente. Ahora el usuario es redireccionado a su inicio de sesión. Pie del commit: Closes #<número de la incidencia en GitHub>
Ejemplo en texto:
fix: redirección errónea tras intentar autenticarse
Después de que el usuario intentara autenticarse, este era redireccionado a una URL no existente. Ahora el usuario es redireccionado a su inicio de sesión.
Los tipos de commit son los siguientes:
- feat: Una nueva característica.
- fix: Se soluciono un bug.
- docs: Se realizaron cambios en la documentación.
- style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el código.
- refactor: Refactorización del código en producción.
- test: Se añadieron pruebas, refactorización de pruebas; Sin cambios en el código.
- chore: Actualización de tareas de build, configuración del admin. de paquetes; Sin cambios en el código.
Gestión de las incidencias
La gestión de las incidencias se realizará siguiendo el siguiente formato dado por el grupo de integración:
Título: <breve título sobre la incidencia> Prioridad: a seleccionar entre distintos valores: urgente, alto, medio, bajo. Estado: pendiente, en curso, finalizado. Los dos primeros estados deberían meterse como etiquetas en GitHub, el último estado se prouduce cuando se cierra la incidencia en GitHub. Descripción: <descripción detallada del error> La descripción puede incluir imagenes o la salida emitida por el fallo. Etiquetas: <etiquetas de GitHub para clasificar las incidencias> enhancement: propuesta de mejora bug: fallos encontrados en el sistema help wanted: incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro question: (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión
Procedimiento general para la gestión de incidencias
- Establecer a un miembro del equipo el rol de gestor de incidencias.
- Cuando se registre una incidencia, el gestor deberá evaluar la prioridad, asignar las etiquetas correspondientes (si faltasen) y un responsable de la incidencia.
- El responsable trabajará en la incidencia. Si un commit cierra una incidencia deberá incluir en el cuerpo del commit "Closes #<id de la incidencia>"
Las incidencias pueden incluirse en Proyectos de GitHub.
Gestión de las ramas
Gestionaremos el proyecto añadiéndo tantas ramas como personas trabajen en él, de esta manera las tareas se dividirán por persona. Esta gestión la hemos recogido de la proporcionada por el grupo de integración.
El coordinador de nuestro grupo, José Ángel, será el encargado de realizar los commit a la rama master.
APIs y datos que se usarán y devolverán
Se va a utilizar la API del curso anterior, vamos a realizar un cambio de lenguaje a python y además haremos las modificaciones oportunas junto con las pautas dada por el equipo de integración. Como el ser obligatorio que aparezcan en las respuestas los parámetros result (Es un Boolean que devuelve el resultado de la operación) y msg (Es un String que devuelve el memnsaje de resultado o error)
Recurso | Descripción | Parámetros | Ejemplo de llamada | Respuesta | Ejemplo de respuesta | Petición HTTP |
---|---|---|---|---|---|---|
getUser | Obtiene un usuario del sistema, incluyendo sus datos. |
|
url/api/getUser/nombreusuario | JSON con el usuario pedido. Los datos del usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". |
{ "result" : true, "msg" : "Successfull", "username" : "tansalalv", "name" : "Tania", "surname" : "Salguero Álvarez", "email" : "mail@example.com", "genre" : "Femenino", "autonomous_community" : "Andalucía", "age" : "21", "role" : "ASISTENTE" } |
GET |
getRoleUser | Obtiene el rol del usuario que se le ofrece por parámetros. |
|
url/api/getRoleUser/nombreusuario | JSON con el campo "role" indicando el rol del usuario siendo las opciones: "ASISTENTE", "PONENTE", "AMBOS". |
{ "result" : true, "msg" : "Successfull", "role" = "AMBOS" } |
GET |
getUsers | Obtiene todos los usuarios del sistema, incluyendo sus datos. | url/api/getUsers | JSON con un array con los datos de cada usuario. Los datos de cada usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". |
[{ "result" : true, "msg" : "Successfull", "username" : "josgarrod17", "name" : "Jose Carlos", "surname" : "García Rodríguez", "email" : "mail1@example.com", "genre" : "Masculino", "autonomous_community" : "Andalucía", "age" : "21", "role" : "ASISTENTE" }, { "result" : true, "msg" : "Successfull", "username" : "josdomesp", "name" : "Jose Ángel", "surname" : "Domínguez Espinaco", "email" : "mail2@example.com", "genre" : "Masculino", "autonomous_community" : "Madrid", "age" : "21", "role" : "PONENTE" }] |
GET | |
getUsersByRole | Obtiene todos los usuarios del sistema que tenga el role pasado por parámetros, incluyendo sus datos. | url/api/getUsersByRole/role | JSON con un array con los datos de cada usuario que tenga el role pasado. Los datos de cada usuario son los siguientes: "username", "name", "surname", "email", "genre", "autonomous_community", "age" y "role". |
[{ "result" : true, "msg" : "Successfull", "username" : "josgarrod17", "name" : "Jose Carlos", "surname" : "García Rodríguez", "email" : "mail1@example.com", "genre" : "Masculino", "autonomous_community" : "Andalucía", "age" : "21", "role" : "PONENTE" }, { "result" : true, "msg" : "Successfull", "username" : "josdomesp", "name" : "Jose Ángel", "surname" : "Domínguez Espinaco", "email" : "mail2@example.com", "genre" : "Masculino", "autonomous_community" : "Madrid", "age" : "21", "role" : "PONENTE" }] |
GET | |
checkToken | Comprueba si un token es válido. Para ello, se obtiene el usuario correspondiente al token (indicado al comienzo del token), se genera el token del usuario y se comprueba si es igual que el pasado como parámetro. |
|
url/api/checkToken/token | JSON con los campos msg = 'Successful' y result = 'True' si es válido, msg = 'Error' y result = 'False' si no es válido |
{ "result" : true, "msg" : "Successfull" } |
GET |
checkTokenUser | Comprueba si un token es válido para un usuario. Para ello, se obtiene el usuario pasado como parámetro, se genera el token del usuario y se comprueba si es igual que el pasado como parámetro. |
|
url/api/checkTokenUser/username/token | JSON con los campos msg = 'Successful' y result = 'True' si es válido, msg = 'Error' y result = 'False' si no es válido |
{ "result" : true, "msg" : "Successfull", } |
GET |
postUser | Se le pasa por parámetros los datos que el usuario ingresa para registrarse en el sistema, se comprueba si los datos son válidos y se guarda el usuario. |
|
url/api/postUser | JSON con el result y msg donde se muestra que todo ha ido correctamente. |
{ "result" : true, "msg" : "Successfull", } |
POST |
Enlaces
Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/95 GitHub: https://github.com/EGC-G2-Trabajo-1718/autenticacion
Vistas del subsistema
Enlace a GitHub del proyecto con las vistas: https://github.com/EGC-G2-Trabajo-1718/autenticacion/tree/damserfer/ProyectoEGC