Installationsanleitung

FWT Passwortgenerator einbauen

Diese Anleitung beschreibt den Einbau des Passwortgenerators in eine FWT-Webseite oder in ein eigenes PHP-Projekt.

1. Voraussetzungen

  • PHP-Webseite oder FWT-Projekt
  • moderner Browser mit window.crypto.getRandomValues
  • keine Datenbank nötig
  • kein E-Mail-Versand nötig
  • kein externer Dienst nötig
Wichtig: Der Passwortgenerator muss ohne Serverversand arbeiten. Passwörter dürfen nicht in Logs, Datenbanken oder Formular-POSTs landen.

2. Ordnerstruktur

Das Tool liegt vollständig in einem eigenen Ordner:

tools/password-generator/
├── password-generator.php
├── password-generator-template.php
├── tool.json
├── assets/
│   ├── password-generator.css
│   └── password-generator.js
├── docs/
│   ├── handbuch.html
│   └── installation.html
├── downloads/
└── README.md

3. CSS einbinden

In einem FWT-Projekt wird die CSS-Datei über die zentrale Seitenkonfiguration ergänzt:

'cssExtraUrls' => [
    'tools/password-generator/assets/password-generator.css?v=20260604-1'
]

In einem einfachen eigenen Projekt kann die Datei direkt eingebunden werden:

<link rel="stylesheet" href="tools/password-generator/assets/password-generator.css">

4. JavaScript einbinden

Das JavaScript enthält die komplette Logik für Generierung, Prüfung, Kopieren und Knackzeit-Schätzung.

<script src="tools/password-generator/assets/password-generator.js" defer></script>
Keine Serverlogik: Die Passwortlogik gehört ins JavaScript und läuft im Browser. Es darf kein Formular geben, das Passwörter an den Server sendet.

5. PHP-Datei einbinden

In einem FWT-Projekt wird das Tool in der Hauptdatei geladen:

require __DIR__ . '/tools/password-generator/password-generator.php';

Danach wird die Seite im Routing ergänzt:

'password-generator' => 'Passwortgenerator',

Und in der Seitenausgabe gerendert:

} elseif ($page === 'password-generator') {
    fwt_password_generator_render();
}

6. Tool-Katalog eintragen

Das Tool wird über die Datei tool.json im Tool-Katalog sichtbar. Beispiel:

{
  "id": "password-generator",
  "name": "FWT Passwortgenerator",
  "category": "Datenschutz & Rechtliches",
  "status": "beta",
  "version": "0.9.0",
  "rating": 4,
  "recommended": true,
  "recommended_for": [
    "Privatnutzer",
    "kleine Webseiten",
    "Selbsthoster",
    "Vereine",
    "Büro-Alltag"
  ],
  "short_description": "Erzeugt sichere Passwörter lokal im Browser, ohne Speicherung und ohne Serverversand.",
  "description": "Der FWT Passwortgenerator erstellt zufällige Passwörter direkt im Browser. Nutzer können Länge, Zeichenarten, Verwendungszweck und Anzahl einstellen. Außerdem können eigene Passwörter lokal geprüft werden.",
  "download_url": "downloads/fwt-password-generator-0.9.0.zip",
  "manual_url": "docs/handbuch.html",
  "install_url": "docs/installation.html",
  "open_url": "?page=password-generator",
  "images": [
    "assets/preview-password-generator.png",
    "assets/preview-password-options.png",
    "assets/preview-password-results.png"
  ],
  "tags": [
    "Passwort",
    "Sicherheit",
    "Datenschutz",
    "Browser",
    "Generator"
  ]
}

7. Download-Paket vorbereiten

Das ZIP-Paket kann im Tool-Ordner unter downloads/ abgelegt werden:

tools/password-generator/downloads/fwt-password-generator-0.9.0.zip

In das ZIP gehören:

  • password-generator.php
  • password-generator-template.php
  • assets/password-generator.css
  • assets/password-generator.js
  • tool.json
  • README.md
  • optional docs/
Unkritisch: Der Passwortgenerator enthält keine SMTP-Daten und keine Serverzugänge. Trotzdem sollte vor jedem ZIP geprüft werden, ob keine privaten Notizen oder Testdateien enthalten sind.

8. Test nach dem Einbau

  1. Seite im Browser öffnen.
  2. Mehrere Sicherheitsprofile auswählen.
  3. 1, 3, 5 und 10 Passwörter erzeugen.
  4. Kopierfunktion testen.
  5. Eigene Passwortprüfung testen.
  6. Browser-Konsole auf Fehler prüfen.
  7. Prüfen, dass keine Netzwerk-Anfrage mit Passwortdaten gesendet wird.

9. Datenschutz und Sicherheit

Das Tool benötigt keine Datenbank, keine Cookies, keine externen Skripte und keinen Serverversand. Es ist damit gut für datenschutzfreundliche Webseiten geeignet.

Wichtig für Weitergaben: Bei Anpassungen muss erhalten bleiben, dass Passwörter ausschließlich lokal im Browser verarbeitet werden.