Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/blokkfreak/altcha-metform/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
DSGVO-konforme, cookielose Spam-Schutz-Integration für MetForm-Formulare in WordPress auf Basis von ALTCHA (Proof-of-Work).
Problemstellung & Lösung
Klassische CAPTCHA-Lösungen wie Google reCAPTCHA übertragen personenbezogene Daten in Drittstaaten und erfordern oft störende Interaktionen (z. B. Bilderrätsel).
Dieses Plugin integriert das quelloffene ALTCHA-System direkt in den Validierungszyklus von MetForm:
- DSGVO-konform: Keine Cookies zur Nachverfolgung, kein Datentransfer an Werbenetzwerke.
- Proof-of-Work: Der Client löst im Hintergrund eine kryptografische Challenge, ohne dass die Benutzererfahrung beeinträchtigt wird.
- Nahtlose Integration: Klinkt sich in MetForms nativen Validierungsfilter (
mf_after_validation_check) ein.
Architektur & Ablauf
sequenceDiagram
autonumber
actor Client as Browser
participant WP as WordPress REST-API
participant Srv as ALTCHA-Server
participant Val as MetForm-Validierung
Client->>WP: GET /wp-json/altcha/v1/challenge
WP->>Srv: Challenge anfordern (CORS-Proxy)
Srv-->>WP: Challenge Payload
WP-->>Client: Challenge Payload
Note over Client: Proof of Work im Hintergrund berechnen
Client->>Val: Formular absenden mit Cookie (mf_altcha)
Val->>Val: Ablaufzeit pruefen
Val->>Val: Replay-Schutz pruefen (Transients)
Val->>Val: HMAC-Signatur verifizieren
Val->>Val: Proof of Work pruefen
alt Erfolgreich
Val-->>Client: Formular gespeichert
else Ungueltig oder Replay
Val-->>Client: Fehlermeldung
end
Kernfunktionen
- REST-API Challenge Proxy (
altcha/v1/challenge): Verhindert CORS-Konflikte, indem WordPress die Challenge direkt an den Browser ausliefert. - Replay Protection: Bereits eingereichte Challenges werden temporär via WordPress Transients (
altcha_<hash>) gespeichert und für Folgeanfragen blockiert. - HMAC- & PoW-Validierung: Serverseitige Verifizierung der Signatur mittels
hash_equals()zum Schutz vor Timing-Attacken. - MetForm-Kompatibilität: Nutzt den internen Filter
mf_after_validation_check, sodass Fehlermeldungen direkt im Frontend-Formular gerendert werden.
Installation & Einrichtung
- Ordner
altcha-metformin das Verzeichniswp-content/plugins/kopieren. - In der Datei
wp-config.phpden geheimen HMAC-Schlüssel definieren:define('ALTCHA_HMAC_KEY', 'dein-geheimer-hmac-key'); - Plugin im WordPress-Adminbereich unter Plugins aktivieren.
- Die Proxy-URL bei Bedarf in
altcha-metform.phpanpassen ($altcha_server).
Tech Stack
- PHP 7.4+ / 8.0+ (Hash HMAC, Transients API, REST API)
- WordPress Plugin API (Hooks & Filters)
- MetForm Plugin API
- Vanilla JavaScript (Web Component & State Listener)
Lizenz
Lizenziert unter der MIT-Lizenz.