2IZI Guard — Τεκμηρίωση

Για ενέργειες εφαρμογής

Η ασφάλεια είναι απόφαση server, όχι κατάσταση widget.

Το 2IZI Guard προστατεύει φόρμες και δημόσιες ενέργειες με τοπική αξιολόγηση κινδύνου, προσαρμοστική τριβή και server tokens μίας χρήσης. Χωρίς υποχρεωτικό εξωτερικό CAPTCHA.

PHP 8.1+Core runtime

MariaDB / MySQLBaseline storage

0required outbound runtime calls

256-bitopaque token entropy

PRE-1.0Το τρέχον branch έχει security-first architecture και automated regression/red-team coverage. Πρώτα Shadow Mode, μετά calibration του enforcement σε πραγματικό traffic.

Quick start

Μικρή επιφάνεια ενσωμάτωσης. Η τελική άδεια μένει στον server.

Το τρέχον core στοχεύει PHP 8.1+ και είναι framework-independent στο security boundary. Προστατέψτε κάθε action ρητά και καταναλώστε token πριν το business operation.

1. Frontend

FrontendHTML

<script src="/guard/public/assets/guard.js?v=0.4.10" defer></script>
<form data-guard-action="contact">
  …
</form>

2. Protected action

Protected actionPHP

$result = Guard::verifyAndConsume(
    $_POST['guard_token'] ?? '',
    'contact'
);

if (!$result->allowed()) {
    http_response_code(403);
    exit;
}

Typical actions

loginregisterpassword_resetcontactcheckoutfile_upload

Server authorityΕπιτυχία JavaScript δεν σημαίνει authorization. Ο server επαληθεύει και καταναλώνει το Guard token.

Πώς λειτουργεί

Μία protected action. Πέντε ανεξάρτητα checkpoints.

Ο browser μπορεί να συμμετέχει στο challenge, αλλά η business permission πάντα εκδίδεται και καταναλώνεται από τον server.

Έλεγχος context

Origin, action, session και βασικά limits πριν από ακριβή εργασία.

Τοπική αξιολόγηση

Server και application signals παράγουν εξηγήσιμη risk decision.

Προσθήκη friction

Η policy επιλέγει PASS, PoW, interaction, throttle ή deny.

Έκδοση μία φορά

Τυχαίο 256-bit opaque token δεμένο με session/action/origin και μικρό TTL.

Atomic consume

Το business endpoint καταναλώνει μία φορά· replay, mismatch και expiry απορρίπτονται.

Policy modes

ShadowObserve and predict; no enforcement.

InvisibleNo visible challenge.

AdaptiveRisk-based PASS / PoW / interaction / deny.

Always challengeRequire step-up for every protected request.

Αξιόπιστο traffic μπορεί να περνά σιωπηλά· μεγαλύτερο risk μπορεί να ενεργοποιεί PoW, hold, throttle ή deny.

Ενσωμάτωση

Integration contract

Action registry

The server defines allowed action names. Never use a client-provided action as authorization context.

'contact' => [
  'mode' => 'adaptive',
  'fail_mode' => 'open_with_limit'
]

Origin / session binding

256-bit opaque tokens · hash-only storage · μικρό TTL · binding action/session/origin · HMAC integrity · one-time atomic consume · server-only business signals · fail-closed critical actions.

UI isolation

Shadow DOM isolates Guard visuals from host CSS. It is a UI reliability layer, not a security boundary.

Localization

UI locale is BCP-47-style, UTF-8, RTL-ready, touch/keyboard compatible, and extendable with locale packs.

Μοντέλο απειλών

Υποθέτουμε ότι ο επιτιθέμενος γνωρίζει όλο τον κώδικα.

Κώδικας, JavaScript, API, DB schema, PoW και thresholds μπορεί να είναι γνωστά· μυστικά και authorization μένουν στον server.

Υποθέτουμε ότι ο επιτιθέμενος έχει

πλήρες source code
σύγχρονα AI models
Playwright / Selenium / headless Chromium
residential proxies
captures δικού του traffic

Η security δεν βασίζεται στην απόκρυψη

JavaScript
challenge algorithms
field names
endpoints
risk thresholds

Core invariants256-bit opaque tokens · hash-only storage · μικρό TTL · binding action/session/origin · HMAC integrity · one-time atomic consume · server-only business signals · fail-closed critical actions.

Ειλικρινές όριοΚανένα browser challenge δεν αποδεικνύει μαθηματικά «βιολογικό άνθρωπο». Critical actions χρειάζονται ακόμη passkey/WebAuthn, MFA, verified accounts, transaction authorization και business limits.

Ανοιχτός κώδικας

Ο δημόσιος κώδικας πρέπει να αυξάνει την ελεγκτικότητα, όχι να αποδυναμώνει το μοντέλο.

Η ανάγνωση implementation δεν πρέπει να δημιουργεί authorization bypass. Public review απαιτεί πειθαρχημένα releases, keys, repository permissions και vulnerability handling.

Δημοσίευση

source και change history
SECURITY.md και responsible disclosure
threat model και architecture
automated security / red-team tests
release checksums και notes

Ιδιωτικά

production config/guard.php
APP_KEY και HMAC/privacy/rate-limit keys
DB dumps και πραγματικά security events
πραγματικά cookies/tokens/sessions
deployment secrets και private infrastructure

Operations

Diagnostics, tests and updates

Diagnostics

php bin/diagnose.php

Check database state, key material, Origin configuration and registered actions before enabling enforcement.

Regression / red-team

bash tests/run-all.sh

Release acceptance includes replay, proxy, risk, tampering, UI and integration checks. Run disposable MariaDB/MySQL concurrency tests where available.

Updates

Read release notes and migrations first. Do not overwrite production config/guard.php with a distribution template. Rotate keys only when a release explicitly requires it.

Rollout

Start with Shadow Mode, review predicted decisions and false positives, tune action policies, then enable calibrated enforcement.

Τρέχουσα κατάσταση

0.4.10 · pre-1.0 · ενεργή ανάπτυξη

Το τρέχον branch έχει security-first architecture και automated regression/red-team coverage. Πρώτα Shadow Mode, μετά calibration του enforcement σε πραγματικό traffic.

PHP coreΔιαθέσιμο

Webasyst / Shop-Script adapterΜετά τη σταθεροποίηση core

Verified agents / Privacy PassΜέλλον / εξαρτάται από standards

0.4.10The responsive-layout hotfix changes UI sizing and preview embedding only; database schema, token/challenge protocol, keys, risk engine and server authorization logic are unchanged.