2IZI Guard — Dokumentáció

Alkalmazásműveletekhez

A biztonság szerveroldali döntés, nem widgetállapot.

A 2IZI Guard helyi kockázatértékeléssel, adaptív súrlódással és egyszer használatos szerver tokenekkel védi az űrlapokat és nyilvános műveleteket. Nincs kötelező külső CAPTCHA runtime.

PHP 8.1+Core runtime

MariaDB / MySQLBaseline storage

0required outbound runtime calls

256-bitopaque token entropy

PRE-1.0A jelenlegi branch security-first architecture és automatikus regression/red-team coverage mellett fut. Először Shadow Mode, majd enforcement kalibrálás valós traffic alapján.

Quick start

Kis integrációs felület. A végső engedély a szerveren marad.

A jelenlegi core PHP 8.1+ célú és framework-independent a security boundary-n. Minden actiont explicit védjen, és a tokent business operation előtt fogyassza el.

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

Védett actionPHP

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

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

Tipikus actions

loginregisterpassword_resetcontactcheckoutfile_upload

Server authorityA JavaScript siker nem engedély. A szerver ellenőrzi és elfogyasztja a Guard tokent.

Működés

Egy védett action. Öt független ellenőrzési pont.

A browser részt vehet a challenge-ben, de a business permission mindig a szerveren jön létre és ott fogy el.

Kontextus ellenőrzése

Origin, action, session és alap limitek ellenőrzése a drága munka előtt.

Helyi értékelés

Server és application signals magyarázható kockázati döntést adnak.

Súrlódás hozzáadása

A policy PASS, PoW, interaction, throttle vagy deny közül választ.

Egyszeri kibocsátás

Véletlen 256-bit opaque token session/action/origin kötése rövid TTL-lel.

Atomi felhasználás

A business endpoint egyszer használja; replay, mismatch és expiry elutasítva.

Policy modes

ShadowObserve and predict; no enforcement.

InvisibleNo visible challenge.

AdaptiveRisk-based PASS / PoW / interaction / deny.

Always challengeRequire step-up for every protected request.

A megbízható forgalom csendben áthaladhat; nagyobb kockázat PoW, hold, throttle vagy deny lépést válthat ki.

Integráció

Integration contract

A jelenlegi core PHP 8.1+ célú és framework-independent a security boundary-n. Minden actiont explicit védjen, és a tokent business operation előtt fogyassza el.

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 · csak hash storage · rövid 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.

Fenyegetési modell

Feltételezzük, hogy a támadó ismeri a teljes kódot.

A kód, JavaScript, API, DB schema, PoW és küszöbök ismertek lehetnek; a titkok és az engedélyezés szerveroldalon maradnak.

Feltételezzük, hogy a támadónál van

teljes source code
modern AI modellek
Playwright / Selenium / headless Chromium
residential proxies
saját traffic capture

A security nem támaszkodik ezek elrejtésére

JavaScript
challenge algoritmus
field nevek
endpoints
risk thresholds

Core invariants256-bit opaque tokens · csak hash storage · rövid TTL · binding action/session/origin · HMAC integrity · one-time atomic consume · server-only business signals · fail-closed critical actions.

Őszinte korlátEgy browser challenge sem tudja matematikailag bizonyítani a „biológiai embert”. Critical actions továbbra is passkey/WebAuthn, MFA, verified accounts, transaction authorization és business limits megoldást igényelnek.

Nyílt forrás

A nyilvános kód növelje az auditálhatóságot, ne gyengítse a modellt.

Az implementation olvasása nem hozhat authorization bypass-t. A public review fegyelmezett releases, keys, repository permissions és vulnerability handling folyamatot igényel.

Publikálni

source és változástörténet
SECURITY.md és responsible disclosure
threat model és architektúra
automatikus security / red-team tests
release checksums és notes

Privátan tartani

production config/guard.php
APP_KEY és HMAC/privacy/rate-limit keys
DB dumps és valós security events
valós cookies/tokens/sessions
deployment secrets és 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.

Aktuális állapot

0.4.10 · pre-1.0 · aktív fejlesztés

A jelenlegi branch security-first architecture és automatikus regression/red-team coverage mellett fut. Először Shadow Mode, majd enforcement kalibrálás valós traffic alapján.

PHP coreElérhető

Webasyst / Shop-Script adapterCore stabilizálás után

Verified agents / Privacy PassJövő / standardfüggő

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.