Decision Trace

Decision Trace: не просто «заблокирован», а почему система пришла к решению

AntiPF строит explainability вокруг каждого важного решения: какой hard rule сработал, какие сигналы добавили risk, насколько они свежи и уверены, какое действие прогнозировалось и что было применено фактически.

Hard decisionSignal contributionsPredicted vs actualPrivacy-safe trace
Decision Trace
Hard decisionmanual ALLOW
MATCH
Browserwebdriver + consistency
+21
Adaptivesequence anomaly
+13
Finalhard ALLOW override
ALLOW
Trace объясняет override: высокий score мог существовать, но higher-authority rule сохранил ALLOW.
Explainability

Без trace сложную защиту нельзя безопасно отлаживать

Когда в системе есть crawler verification, browser/network/adaptive signals и manual rules, итоговый action без причин бесполезен. Decision Trace собирает layers решения, но не должен раскрывать auth cookies, license/OAuth secrets или raw fingerprint vector.

WHY

Причина решения

Видно, какой слой authority и какие signals участвовали.

COMPARE

Predicted vs actual

В SHADOW можно сравнивать прогноз с фактическим ответом без enforcement.

PRIVACY

Без секретов

Trace хранит безопасные refs/aggregates вместо чувствительных данных.

Архитектура

Trace строится по этапам decision pipeline

Каждый signal имеет value, confidence, source, freshness и reason; hard decision хранится отдельно от secondary score.

01
Hard context

SYSTEM/crawler/manual/security decision.

02
Base score

Начальное значение policy model.

03
Contributions

Request, network, visitor, adaptive и browser signals.

04
Confidence

Доступность source, sample size и freshness.

05
Prediction

Рассчитанный action при текущей policy.

06
Actual/override

Фактически применённое действие и причина расхождения.

Privacy invariant. Не хранить raw auth cookie, license/OAuth secrets, TOTP secret или полный raw fingerprint vector.
Что умеет модуль

Что можно понять из Decision Trace

Trace нужен разработчику, SEO-специалисту и владельцу сайта — особенно до включения ACTIVE.

02

Browser contributions

Какие automation/consistency signals реально добавили risk.

Подробнее →
03

Network source state

Был ли Network READY/PARTIAL/NO_DATA в момент решения.

Подробнее →
05

SHADOW comparison

Predicted action можно анализировать без изменения visitor response.

Подробнее →
Readiness & evidence

Trace полезен только если evidence current и честно маркирован

STALE model, NO_DATA source и SIMULATED fixture должны быть видны прямо в trace.

CURRENT
Evidence свежийSource/model соответствует текущему состоянию.
STALE
Evidence устарелНе использовать silently как high-confidence signal.
NO_DATA
Источник отсутствовалContribution должен быть 0/недоступен.
SIMULATED
FixtureРезультат создан simulator и не является production event.
Практическое применение

Как использовать Trace в работе

Главный сценарий — разбирать конкретные спорные визиты и на их основе корректировать policy, а не подгонять модель вслепую.

FALSE POSITIVE

Почему человек получил Challenge

Разложить browser/network/behavior contributions и найти слабый source.

Связанный сценарий →
ADS

Почему визит считается suspicious

Сопоставить risk evidence с anti-fraud context, а не смотреть только IP.

Связанный сценарий →
Приватность

Explainability не требует сохранять секреты и сырые персональные профили

Trace должен хранить только то, что необходимо для объяснения решения: нормализованные signal/value/confidence/source/freshness и безопасные identifiers.

FAQ

Вопросы про Decision Trace

Что показывает SHADOW trace?

Какое действие AntiPF прогнозировал бы при текущих signals/policy, при этом фактический visitor response остаётся неизменённым.

В trace хранится fingerprint?

10.050 запрещает превращать trace в хранилище raw secrets или полного invasive fingerprint vector.

Можно ли увидеть NO_DATA?

Да, отсутствие source должно быть отдельным состоянием и не маскироваться под false/safe.

Чем actual action отличается от predicted?

Predicted рассчитывается model/policy, а actual учитывает режим SHADOW и higher-authority overrides.

Следующий шаг

Разберём реальные решения AntiPF по trace

Это лучший способ проверить false positives и подготовить policy к enforcement без угадывания по одному score.