RollCalculator/With Authentification/README (1).md

Naue Roll Calculator – Flask Beta Deployment

Überblick

Diese Flask-Anwendung schützt den Roll Diameter Calculator mit HTTP Basic Authentication. Benutzer müssen sich mit Benutzername und Passwort anmelden, bevor sie auf die App zugreifen können.

---

Installation & Setup

1. Abhängigkeiten installieren

pip install -r requirements.txt

2. HTML-Template einbinden

Kopiere deine ursprüngliche roll_calculator.html vollständig in:

templates/roll_calculator.html

Falls du noch die statischen Dateien brauchst (JSON-Dateien, Service Worker):

mkdir -p static
# Kopiere article-data.json, config.json, service-worker.js (optional) in static/

3. App starten

python app.py

Server läuft dann unter: http://localhost:5000

---

Test-Zugänge (Standard-Beta-Benutzer)

Benutzer	Passwort	Rolle
beta	rollcalc_beta_2026	User
naue	naue_access_2026	User
admin	admin_secure_pwd_2026	Admin

⚠️ WICHTIG: Vor Produktivbereitstellung ALLE PASSWÖRTER ÄNDERN!

---

Authentifizierung

HTTP Basic Auth

• Browser zeigt automatisch ein Login-Popup
• Credentials werden Base64-codiert mit jedem Request mitgesendet
• Nur über HTTPS verwenden! (in Production)

Neue Benutzer hinzufügen

In app.py die BETA_USERS oder ADMIN_USERS Dictionaries anpassen:

BETA_USERS = {
    "beta": "rollcalc_beta_2026",
    "neuer_user": "neues_passwort_hier"  # ← Neu
}

---

Features

✅ HTTP Basic Auth (Browser-Standard)
✅ Audit-Logging (access_log.json)
✅ Admin-Endpoints (/admin/logs)
✅ Static Files Protection
✅ CORS-ready (für zukünftige APIs)
✅ Health Check Endpoint

---

API-Endpunkte

GET  /                    → HTML-Seite (geschützt)
GET  /static/<file>       → Statische Dateien (geschützt)
GET  /api/health          → Health Check (geschützt)
GET  /api/user            → Authentifizierter Benutzer Info (geschützt)
GET  /admin/logs          → Access Logs (Admin-only)

---

Sicherheit für Production

1. Passwörter aktualisieren

   BETA_USERS = {"realuser": "komplexes_passwort_mindestens_16_zeichen"}
   

2. HTTPS erzwingen

   • Reverse Proxy (nginx, Apache)
   • SSL/TLS Certificate

3. Umgebungsvariablen nutzen (statt hardcoded)

   import os
   BETA_USERS = {
       "beta": os.getenv("BETA_PASSWORD", "default")
   }
   

4. Debug deaktivieren

   app.run(debug=False)  # In Production
   

5. Rate Limiting hinzufügen

   pip install Flask-Limiter
   

6. Access Logs regelmäßig archivieren

   gzip access_log.json
   rm access_log.json
   

---

Dateistruktur

project/
├── app.py                          # Flask-Applikation (mit HTTP Basic Auth)
├── requirements.txt                # Python Dependencies
├── access_log.json                 # Auto-generiert (Audit Trail)
├── templates/
│   └── roll_calculator.html        # ← HTML-Template hier einfügen
├── static/
│   ├── article-data.json           # (optional)
│   ├── config.json                 # (optional)
│   └── service-worker.js           # (optional)
└── README.md                       # Diese Datei

---

Troubleshooting

"401 Unauthorized" beim Öffnen von http://localhost:5000

✓ Das ist normal! Browser zeigt automatisch ein Auth-Dialog. ✓ Gib Benutzername/Passwort ein (z.B. beta / rollcalc_beta_2026)

"template not found"

✓ Stelle sicher, dass templates/roll_calculator.html existiert ✓ HTML-Datei muss vollständig sein (mit allen Scripts)

"404 Not Found" bei article-data.json

✓ Ist optional. Falls benötigt:

• Kopiere article-data.json in static/
• Oder erweitere den /static-Route in app.py

---

Logging

Alle erfolgreichen und fehlgeschlagenen Login-Versuche werden in access_log.json geloggt:

[
  {
    "timestamp": "2026-05-28T12:16:41.123456",
    "username": "beta",
    "endpoint": "/",
    "method": "GET",
    "status": 200
  }
]

Admin-Benutzer können Logs ansehen unter /admin/logs (JSON-Format).

---

Deployment-Optionen

Option 1: Docker

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "app.py"]

Option 2: Systemd Service (Linux)

[Service]
ExecStart=/usr/bin/python3 /path/to/app.py
Restart=always
WorkingDirectory=/path/to/

Option 3: Gunicorn (Production)

pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 app:app

---

Fragen?

Kontakt: Produktionsplanung / Logistik / Produktmanagement

---

Naue GmbH & Co. KG
Roll Diameter Calculator – Beta Phase 2026