Skip to content

Commit 1d55881

Browse files
authored
Provide guidelines for mitigation algorithms (#241)
Provide parameter values for mitigation algorithms This patch is providing normative and non-normative numerical values for the mitigation algorithms parameters. [1] [1] #197 (comment) Fixes: #240
1 parent 2873936 commit 1d55881

File tree

1 file changed

+47
-3
lines changed

1 file changed

+47
-3
lines changed

index.html

Lines changed: 47 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -883,7 +883,7 @@

Supporting algorithms

883883
<ul>
884884
<li>
885885
set |observer|.{{PressureObserver/[[ObservationWindow]]}} to an [=implementation-defined=] randomized integer value in
886-
milliseconds within an [=implementation-defined=] range, e.g., random between 300000 and 600000 (5 and 10 minutes).
886+
milliseconds within an [=implementation-defined=] range.
887887
li>
888888
<li>
889889
set |observer|.{{PressureObserver/[[MaxChangesThreshold]]}} to an [=implementation-defined=] randomized integer
@@ -1429,6 +1429,39 @@

Rate obfuscation

14291429
received from the platform collector during this penalty.
14301430
p>
14311431
section>
1432+
<section>
1433+
<h4>Rate obfuscation normative parametersh4>
1434+
<p>
1435+
Based on implementation experience, implementers must use:
1436+
<ul>
1437+
<li>
1438+
a range in between 50 and 100 changes for PressureObserver's {{PressureObserver/[[MaxChangesThreshold]]}} internal slot.
1439+
li>
1440+
<li>
1441+
a range in between 5000 milliseconds and 10000 milliseconds for PressureObserver's {{PressureObserver/[[PenaltyDuration]]}} internal slot.
1442+
li>
1443+
ul>
1444+
<aside class="note">
1445+
These values are subject to change and are updated based on further implementation experience and research findings.
1446+
aside>
1447+
<p>
1448+
section>
1449+
<section>
1450+
<h4>Rate obfuscation non-normative parametersh4>
1451+
<p><i>This section is non-normative.i>p>
1452+
<p>
1453+
Based on implementation experience, implementers are advised to use:
1454+
<ul>
1455+
<li>
1456+
a range in between 300000 milliseconds (5 minutes) and 600000 milliseconds (10 minutes) for PressureObserver's
1457+
{{PressureObserver/[[ObservationWindow]]}} internal slot.
1458+
li>
1459+
ul>
1460+
<aside class="note">
1461+
These values are subject to change and are updated based on further implementation experience and research findings.
1462+
aside>
1463+
p>
1464+
section>
14321465
<section>
14331466
<h4>Break calibrationh4>
14341467
<p>
@@ -1442,14 +1475,25 @@

Break calibration

14421475
at runtime when this mitigation is running continuously. Any attempts to recalibrate
14431476
will similarly be mitigated against.
14441477
p>
1445-
<div class="note">
1478+
<aside class="note">
14461479
Modern browsers throttle background tabs using [=implementation-defined=]
14471480
heuristics in order to reduce resource usage. For example, after a period of
14481481
no user interaction a background tab can be throttled that will influence
14491482
the global pressure state of the system. This built-in feature of modern
14501483
browsers further improves the effectiveness of the break calibration
14511484
mitigation.
1452-
div>
1485+
aside>
1486+
section>
1487+
<section>
1488+
<h4>Break calibration parametersh4>
1489+
<p><i>This section is non-normative.i>p>
1490+
<p>
1491+
Based on implementation experience, implementers are advised to apply the mitigation
1492+
to a randomized time value within a range between 120000 milliseconds (2 minutes) and 240000 milliseconds (4 minutes).
1493+
p>
1494+
<aside class="note">
1495+
These values are subject to change and are updated based on further implementation experience and research findings.
1496+
aside>
14531497
section>
14541498
<section>
14551499
<h4>Same-origin restrictionh4>

0 commit comments

Comments
 (0)