Redes PFO2 - API REST con Flask

Tecnologías

Stack del Proyecto

🐍

Python 3

Lenguaje principal para el servidor y el cliente de consola.

🌶️

Flask

Framework web ligero para construir la API REST con endpoints JSON y HTML.

🗄️

SQLite

Base de datos embebida para persistir usuarios. Sin configuración externa.

🔒

Werkzeug

Hashing de contraseñas con scrypt + salt aleatorio. Nunca texto plano.

API

Endpoints Disponibles

Método	Ruta	Descripción	Auth
POST	/registro	Registra un nuevo usuario con contraseña hasheada	No
POST	/login	Verifica credenciales del usuario	No
GET	/tareas	Muestra página HTML de bienvenida	Basic Auth

Ejemplo — Registrar usuario

            curl -X POST http://localhost:5000/registro \
  -H "Content-Type: application/json" \
  -d '{"usuario": "manu4", "contraseña": "1234"}'
        

Ejemplo — Iniciar sesión

            curl -X POST http://localhost:5000/login \
  -H "Content-Type: application/json" \
  -d '{"usuario": "manu4", "contraseña": "1234"}'
        

Ejemplo — Ver tareas (con auth)

curl -u manu4:1234 http://localhost:5000/tareas

Guía

Instalación y Ejecución

1. Clonar el repositorio

                    git clone https://github.com/jmgasbarro/Redes-PFO2.git
cd Redes-PFO2
                

2. Instalar dependencias

pip install -r requirements.txt

3. Iniciar el servidor (Terminal 1)

python servidor.py

El servidor se ejecuta en localhost:5000

4. Ejecutar el cliente (Terminal 2)

python cliente.py

Se abrirá un menú interactivo con opciones para registrarse, loguearse y ver tareas.

Demostración

Pruebas con el Cliente de Consola

Iniciar el servidor

Al ejecutar servidor.py, se muestra el mensaje de inicio:

Menú del cliente

Al ejecutar cliente.py, se presenta un menú interactivo:

1️⃣

Registrar usuario

Registra un nuevo usuario proporcionando nombre y contraseña.

2️⃣

Iniciar sesión

Verifica credenciales enviando un POST a /login.

3️⃣

Ver tareas

Accede a /tareas usando HTTP Basic Auth y muestra el HTML.

🎉 Página de bienvenida

Al elegir la opción 3, se accede a la página HTML con el cartel de BIENVENIDO y las tareas cargadas.

4️⃣

Salir del programa

La opción 4 cierra el cliente.

Teoría

Respuestas Conceptuales

🔐 ¿Por qué hashear contraseñas?

Protección ante filtraciones: si un atacante accede a la base de datos, solo encuentra hashes irreversibles.
Irreversibilidad: a diferencia del cifrado, el hashing es una función de un solo sentido.
Salting automático: Werkzeug agrega un salt aleatorio, haciendo que contraseñas iguales generen hashes distintos.
Cumplimiento normativo: almacenar contraseñas en texto plano viola regulaciones de protección de datos.

🗄️ Ventajas de usar SQLite en este proyecto

Sin servidor externo: base de datos embebida en un solo archivo (usuarios.db).
Cero configuración: no se necesitan credenciales, puertos ni servicios adicionales.
Portabilidad: el archivo .db se copia y mueve fácilmente.
Ideal para prototipos: rendimiento suficiente sin complejidad de una DB cliente-servidor.
Nativo en Python: el módulo sqlite3 viene integrado en la biblioteca estándar.

Estructura

Arquitectura del Proyecto

            Redes-PFO2/
├── servidor.py          # API Flask (servidor)
├── cliente.py           # Cliente de consola
├── requirements.txt     # Dependencias
├── templates/
│   └── tareas.html      # Página HTML de bienvenida
├── usuarios.db          # Base de datos (se genera al ejecutar)
├── index.html           # Documentación (GitHub Pages)
└── README.md
        