@kensio/yulin 1.21.23 → 1.21.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/dist/service/dynamodb/command/authorize/sim-dynamodb-authorizer.d.ts +19 -1
  2. package/dist/service/dynamodb/command/authorize/sim-dynamodb-authorizer.js +21 -3
  3. package/dist/service/dynamodb/command/authorize/sim-dynamodb-reached.d.ts +6 -3
  4. package/dist/service/dynamodb/command/query/sim-dynamodb-query.js +3 -1
  5. package/dist/service/dynamodb/command/scan/sim-dynamodb-scan.js +3 -1
  6. package/dist/service/dynamodb/command/table/sim-dynamodb-table-reach.d.ts +4 -0
  7. package/dist/service/dynamodb/command/table/sim-dynamodb-table-reach.js +1 -0
  8. package/dist/service/dynamodb/table/sim-dynamodb-table-arn.d.ts +13 -0
  9. package/dist/service/dynamodb/table/sim-dynamodb-table-arn.js +20 -0
  10. package/dist/service/wafv2/association/sim-aws-waf-protected-resources.js +4 -0
  11. package/dist/service/wafv2/association/sim-waf-associations.d.ts +6 -0
  12. package/dist/service/wafv2/association/sim-waf-associations.js +17 -0
  13. package/dist/service/wafv2/association/sim-waf-protected-resource.d.ts +13 -8
  14. package/dist/service/wafv2/association/sim-waf-protected-resource.js +23 -23
  15. package/dist/service/wafv2/association/sim-waf-protected-resources.d.ts +11 -6
  16. package/dist/service/wafv2/association/sim-waf-protected-resources.js +10 -7
  17. package/dist/service/wafv2/association/sim-waf-unsimulated-resource.d.ts +33 -0
  18. package/dist/service/wafv2/association/sim-waf-unsimulated-resource.js +66 -0
  19. package/dist/service/wafv2/cfn/association/sim-cfn-waf-association-creator.js +5 -0
  20. package/dist/service/wafv2/cfn/ip-set/sim-cfn-waf-ip-set-config.js +1 -0
  21. package/dist/service/wafv2/cfn/ip-set/sim-cfn-waf-ip-set-creator.js +2 -0
  22. package/dist/service/wafv2/cfn/regex-pattern-set/sim-cfn-waf-regex-set-config.js +1 -0
  23. package/dist/service/wafv2/cfn/regex-pattern-set/sim-cfn-waf-regex-set-creator.js +2 -0
  24. package/dist/service/wafv2/cfn/sim-cfn-waf-resource-config.d.ts +4 -0
  25. package/dist/service/wafv2/cfn/sim-cfn-waf-resource-config.js +10 -0
  26. package/dist/service/wafv2/cfn/sim-cfn-waf-unsimulated.d.ts +10 -0
  27. package/dist/service/wafv2/cfn/sim-cfn-waf-unsimulated.js +12 -0
  28. package/dist/service/wafv2/cfn/web-acl/sim-cfn-waf-web-acl-config.d.ts +1 -13
  29. package/dist/service/wafv2/cfn/web-acl/sim-cfn-waf-web-acl-config.js +8 -21
  30. package/dist/service/wafv2/cfn/web-acl/sim-cfn-waf-web-acl-creator.d.ts +4 -9
  31. package/dist/service/wafv2/cfn/web-acl/sim-cfn-waf-web-acl-creator.js +7 -15
  32. package/dist/service/wafv2/command/association/sim-wafv2-association-commands.js +2 -1
  33. package/dist/service/wafv2/command/association/sim-wafv2-association-input.d.ts +10 -2
  34. package/dist/service/wafv2/command/association/sim-wafv2-association-input.js +25 -13
  35. package/dist/service/wafv2/command/ip-set/sim-wafv2-ip-set-commands.d.ts +3 -3
  36. package/dist/service/wafv2/command/ip-set/sim-wafv2-ip-set-commands.js +5 -5
  37. package/dist/service/wafv2/command/managed-rule-group/sim-wafv2-managed-rule-group-commands.js +4 -4
  38. package/dist/service/wafv2/command/regex-pattern-set/sim-wafv2-regex-pattern-set-commands.js +2 -2
  39. package/dist/service/wafv2/command/sim-wafv2-input.d.ts +0 -7
  40. package/dist/service/wafv2/command/sim-wafv2-input.js +1 -13
  41. package/dist/service/wafv2/command/web-acl/sim-waf-web-acl-output.js +1 -0
  42. package/dist/service/wafv2/command/web-acl/sim-wafv2-unsimulated-web-acl-input.d.ts +9 -12
  43. package/dist/service/wafv2/command/web-acl/sim-wafv2-unsimulated-web-acl-input.js +27 -28
  44. package/dist/service/wafv2/command/web-acl/sim-wafv2-web-acl-commands.d.ts +3 -3
  45. package/dist/service/wafv2/command/web-acl/sim-wafv2-web-acl-commands.js +6 -6
  46. package/dist/service/wafv2/command/web-acl/web-acl.command.d.ts +6 -0
  47. package/dist/service/wafv2/index.d.ts +3 -0
  48. package/dist/service/wafv2/index.js +1 -0
  49. package/dist/service/wafv2/managed/group/sim-waf-bot-control.d.ts +27 -0
  50. package/dist/service/wafv2/managed/group/sim-waf-bot-control.js +68 -0
  51. package/dist/service/wafv2/managed/group/sim-waf-ip-reputation.d.ts +18 -0
  52. package/dist/service/wafv2/managed/group/sim-waf-ip-reputation.js +51 -0
  53. package/dist/service/wafv2/managed/sim-waf-bot-declaration.d.ts +35 -0
  54. package/dist/service/wafv2/managed/sim-waf-bot-declaration.js +42 -0
  55. package/dist/service/wafv2/managed/sim-waf-managed-declaration.d.ts +35 -0
  56. package/dist/service/wafv2/managed/sim-waf-managed-declaration.js +30 -0
  57. package/dist/service/wafv2/managed/sim-waf-managed-group-configs.d.ts +11 -0
  58. package/dist/service/wafv2/managed/sim-waf-managed-group-configs.js +42 -0
  59. package/dist/service/wafv2/managed/sim-waf-managed-group-input.d.ts +5 -4
  60. package/dist/service/wafv2/managed/sim-waf-managed-group-input.js +7 -9
  61. package/dist/service/wafv2/managed/sim-waf-managed-group-statement.js +16 -14
  62. package/dist/service/wafv2/managed/sim-waf-managed-group.type.d.ts +2 -2
  63. package/dist/service/wafv2/managed/sim-waf-managed-rule-actions.d.ts +30 -0
  64. package/dist/service/wafv2/managed/sim-waf-managed-rule-actions.js +26 -0
  65. package/dist/service/wafv2/managed/sim-waf-managed-rule-groups.d.ts +5 -3
  66. package/dist/service/wafv2/managed/sim-waf-managed-rule-groups.js +10 -3
  67. package/dist/service/wafv2/managed/sim-waf-managed-rule.type.d.ts +11 -2
  68. package/dist/service/wafv2/managed/sim-waf-managed-rules.d.ts +14 -9
  69. package/dist/service/wafv2/managed/sim-waf-managed-rules.js +15 -5
  70. package/dist/service/wafv2/resource/sim-waf-resource.d.ts +10 -0
  71. package/dist/service/wafv2/resource/sim-waf-resource.js +12 -0
  72. package/dist/service/wafv2/resource/sim-waf-unsimulated-part.d.ts +24 -0
  73. package/dist/service/wafv2/resource/sim-waf-unsimulated-part.js +8 -0
  74. package/dist/service/wafv2/sim-wafv2.d.ts +12 -12
  75. package/dist/service/wafv2/sim-wafv2.fixture.d.ts +19 -1
  76. package/dist/service/wafv2/sim-wafv2.fixture.js +29 -0
  77. package/dist/service/wafv2/sim-wafv2.js +25 -23
  78. package/dist/service/wafv2/statement/sim-waf-field-to-match.type.d.ts +2 -2
  79. package/dist/service/wafv2/statement/sim-waf-rule-refusals.d.ts +6 -4
  80. package/dist/service/wafv2/statement/sim-waf-rule-refusals.js +7 -6
  81. package/dist/service/wafv2/statement/sim-waf-statement.d.ts +3 -3
  82. package/dist/service/wafv2/statement/sim-waf-statement.js +3 -3
  83. package/dist/service/wafv2/statement/sim-waf-statement.type.d.ts +3 -3
  84. package/dist/service/wafv2/statement/sim-waf-unsimulated-statement.js +1 -1
  85. package/dist/service/wafv2/web-acl/sim-waf-association-config.d.ts +14 -7
  86. package/dist/service/wafv2/web-acl/sim-waf-association-config.js +17 -27
  87. package/dist/service/wafv2/web-acl/sim-waf-rule.d.ts +15 -3
  88. package/dist/service/wafv2/web-acl/sim-waf-rule.js +46 -10
  89. package/dist/service/wafv2/web-acl/sim-waf-statement-capacity.d.ts +4 -4
  90. package/dist/service/wafv2/web-acl/sim-waf-statement-capacity.js +4 -4
  91. package/dist/service/wafv2/web-acl/sim-waf-unsimulated-body-limit.d.ts +6 -0
  92. package/dist/service/wafv2/web-acl/sim-waf-unsimulated-body-limit.js +23 -0
  93. package/dist/service/wafv2/web-acl/sim-waf-web-acl-capacity.js +2 -2
  94. package/dist/service/wafv2/web-acl/sim-waf-web-acl-configuration.d.ts +5 -0
  95. package/dist/service/wafv2/web-acl/sim-waf-web-acl.d.ts +11 -2
  96. package/dist/service/wafv2/web-acl/sim-waf-web-acl.js +20 -1
  97. package/docs/services/dynamodb/README.md +26 -0
  98. package/docs/services/wafv2/README.md +243 -51
  99. package/package.json +3 -3
  100. package/dist/service/wafv2/cfn/web-acl/sim-cfn-waf-evaluatable-rules.d.ts +0 -15
  101. package/dist/service/wafv2/cfn/web-acl/sim-cfn-waf-evaluatable-rules.js +0 -21
  102. package/dist/service/wafv2/web-acl/sim-waf-unevaluatable-rules.d.ts +0 -25
  103. package/dist/service/wafv2/web-acl/sim-waf-unevaluatable-rules.js +0 -33
@@ -11,6 +11,8 @@ export { SimWafNoProtection, type SimWafProtectedRequest, type SimWafProtection,
11
11
  export { SimWafInspected, SimWafRequestInspection, } from "./association/sim-waf-request-inspection.js";
12
12
  export { SimWafRestApiStage } from "./association/sim-waf-rest-api-stage.js";
13
13
  export { SimWafUserPool } from "./association/sim-waf-user-pool.js";
14
+ export { SimWafUnsimulatedResource, type SimWafUnsimulatedResourceType, simWafUnsimulatedResourceTypes, } from "./association/sim-waf-unsimulated-resource.js";
15
+ export type { SimWafUnsimulatedPart } from "./resource/sim-waf-unsimulated-part.js";
14
16
  export { SimWafResource, type SimWafResourceSummary, } from "./resource/sim-waf-resource.js";
15
17
  export { SimWafWebAcl } from "./web-acl/sim-waf-web-acl.js";
16
18
  export type { SimWafWebAclConfiguration } from "./web-acl/sim-waf-web-acl-configuration.js";
@@ -24,6 +26,7 @@ export { SimWafRegexPatternSet } from "./regex-pattern-set/sim-waf-regex-pattern
24
26
  export type { SimWafDecision } from "./evaluate/sim-waf-decision.js";
25
27
  export { SimWafRequestLabels } from "./evaluate/sim-waf-request-labels.js";
26
28
  export { SimWafManagedRules, type SimWafManagedMatchDeclaration, } from "./managed/sim-waf-managed-rules.js";
29
+ export type { SimWafBotDeclaration } from "./managed/sim-waf-bot-declaration.js";
27
30
  export type { SimWafManagedRuleReport } from "./managed/sim-waf-managed-rule-report.js";
28
31
  export type { SimWafManagedRuleTier } from "./managed/sim-waf-managed-rule.type.js";
29
32
  export type { SimWafManagedRuleGroupStatementInput, SimWafOverrideActionInput, SimWafRuleActionOverrideInput, } from "./managed/sim-waf-managed-group.type.js";
@@ -9,6 +9,7 @@ export { SimWafNoProtection, } from "./association/sim-waf-protection.js";
9
9
  export { SimWafInspected, SimWafRequestInspection, } from "./association/sim-waf-request-inspection.js";
10
10
  export { SimWafRestApiStage } from "./association/sim-waf-rest-api-stage.js";
11
11
  export { SimWafUserPool } from "./association/sim-waf-user-pool.js";
12
+ export { SimWafUnsimulatedResource, simWafUnsimulatedResourceTypes, } from "./association/sim-waf-unsimulated-resource.js";
12
13
  export { SimWafResource, } from "./resource/sim-waf-resource.js";
13
14
  export { SimWafWebAcl } from "./web-acl/sim-waf-web-acl.js";
14
15
  export { SimWafRule } from "./web-acl/sim-waf-rule.js";
@@ -0,0 +1,27 @@
1
+ import type { SimWafManagedRuleGroupDefinition } from "../sim-waf-managed-rule.type.js";
2
+ /**
3
+ * The bot categories Bot Control's common level names, each with the rule
4
+ * that matches an unverified bot of that category.
5
+ *
6
+ * The category is spelled the way the `bot:category:` label spells it, and
7
+ * the rule name is `Category` and the category in Pascal case.
8
+ */
9
+ export declare const simWafBotCategories: ReadonlyMap<string, string>;
10
+ /**
11
+ * The one category whose rule matches a verified bot as well.
12
+ */
13
+ export declare const simWafBotCategoryMatchingVerified = "ai";
14
+ /**
15
+ * AWS WAF Bot Control at its common inspection level.
16
+ *
17
+ * The common level identifies a bot by what the request says about itself,
18
+ * and AWS publishes the rule names, the categories and the labels and none of
19
+ * the signatures. Verifying a bot reads the source address, which is
20
+ * `127.0.0.1` for every request here. So every rule is declared-only, and a
21
+ * test says which bot sent a request with `managedRules().onRequest` and a
22
+ * `bot` declaration.
23
+ *
24
+ * The targeted level is held without being evaluated. Its rules read tokens,
25
+ * browser signals and traffic across requests.
26
+ */
27
+ export declare const simWafBotControlRuleSet: SimWafManagedRuleGroupDefinition;
@@ -0,0 +1,68 @@
1
+ /**
2
+ * The bot categories Bot Control's common level names, each with the rule
3
+ * that matches an unverified bot of that category.
4
+ *
5
+ * The category is spelled the way the `bot:category:` label spells it, and
6
+ * the rule name is `Category` and the category in Pascal case.
7
+ */
8
+ export const simWafBotCategories = new Map([
9
+ ["advertising", "CategoryAdvertising"],
10
+ ["archiver", "CategoryArchiver"],
11
+ ["content_fetcher", "CategoryContentFetcher"],
12
+ ["email_client", "CategoryEmailClient"],
13
+ ["http_library", "CategoryHttpLibrary"],
14
+ ["link_checker", "CategoryLinkChecker"],
15
+ ["miscellaneous", "CategoryMiscellaneous"],
16
+ ["monitoring", "CategoryMonitoring"],
17
+ ["page_preview", "CategoryPagePreview"],
18
+ ["scraping_framework", "CategoryScrapingFramework"],
19
+ ["search_engine", "CategorySearchEngine"],
20
+ ["security", "CategorySecurity"],
21
+ ["seo", "CategorySeo"],
22
+ ["social_media", "CategorySocialMedia"],
23
+ ["webhooks", "CategoryWebhooks"],
24
+ ["ai", "CategoryAI"],
25
+ ]);
26
+ /**
27
+ * The one category whose rule matches a verified bot as well.
28
+ */
29
+ export const simWafBotCategoryMatchingVerified = "ai";
30
+ const signals = [
31
+ ["SignalAutomatedBrowser", "automated_browser"],
32
+ ["SignalKnownBotDataCenter", "known_bot_data_center"],
33
+ ["SignalNonBrowserUserAgent", "non_browser_user_agent"],
34
+ ];
35
+ const categoryRules = simWafBotCategories
36
+ .entries()
37
+ .map(([category, name]) => ({
38
+ name,
39
+ label: name,
40
+ labels: [`bot:category:${category}`],
41
+ tier: "declared",
42
+ }))
43
+ .toArray();
44
+ const signalRules = signals.map(([name, signal]) => ({
45
+ name,
46
+ label: name,
47
+ labels: [`signal:${signal}`],
48
+ tier: "declared",
49
+ }));
50
+ /**
51
+ * AWS WAF Bot Control at its common inspection level.
52
+ *
53
+ * The common level identifies a bot by what the request says about itself,
54
+ * and AWS publishes the rule names, the categories and the labels and none of
55
+ * the signatures. Verifying a bot reads the source address, which is
56
+ * `127.0.0.1` for every request here. So every rule is declared-only, and a
57
+ * test says which bot sent a request with `managedRules().onRequest` and a
58
+ * `bot` declaration.
59
+ *
60
+ * The targeted level is held without being evaluated. Its rules read tokens,
61
+ * browser signals and traffic across requests.
62
+ */
63
+ export const simWafBotControlRuleSet = {
64
+ name: "AWSManagedRulesBotControlRuleSet",
65
+ labelNamespace: "awswaf:managed:aws:bot-control",
66
+ capacity: 50,
67
+ rules: [...categoryRules, ...signalRules],
68
+ };
@@ -0,0 +1,18 @@
1
+ import type { SimWafManagedRuleGroupDefinition } from "../sim-waf-managed-rule.type.js";
2
+ /**
3
+ * The Amazon IP reputation list, which decides by the address a request came
4
+ * from.
5
+ *
6
+ * Every request in this simulation reports a source address of `127.0.0.1`,
7
+ * so every rule here is declared-only. A test says which requests come from a
8
+ * flagged address with `managedRules().onRequest`, and the group labels and
9
+ * acts on them as AWS documents.
10
+ */
11
+ export declare const simWafIpReputationList: SimWafManagedRuleGroupDefinition;
12
+ /**
13
+ * The anonymous IP list, for VPNs, proxies, Tor nodes and hosting providers.
14
+ *
15
+ * It decides by source address as the reputation list does, and every rule is
16
+ * declared-only for the same reason.
17
+ */
18
+ export declare const simWafAnonymousIpList: SimWafManagedRuleGroupDefinition;
@@ -0,0 +1,51 @@
1
+ /**
2
+ * The Amazon IP reputation list, which decides by the address a request came
3
+ * from.
4
+ *
5
+ * Every request in this simulation reports a source address of `127.0.0.1`,
6
+ * so every rule here is declared-only. A test says which requests come from a
7
+ * flagged address with `managedRules().onRequest`, and the group labels and
8
+ * acts on them as AWS documents.
9
+ */
10
+ export const simWafIpReputationList = {
11
+ name: "AWSManagedRulesAmazonIpReputationList",
12
+ labelNamespace: "awswaf:managed:aws:amazon-ip-list",
13
+ capacity: 25,
14
+ rules: [
15
+ {
16
+ name: "AWSManagedIPReputationList",
17
+ label: "AWSManagedIPReputationList",
18
+ tier: "declared",
19
+ },
20
+ {
21
+ name: "AWSManagedReconnaissanceList",
22
+ label: "AWSManagedReconnaissanceList",
23
+ tier: "declared",
24
+ },
25
+ {
26
+ name: "AWSManagedIPDDoSList",
27
+ label: "AWSManagedIPDDoSList",
28
+ counts: true,
29
+ tier: "declared",
30
+ },
31
+ ],
32
+ };
33
+ /**
34
+ * The anonymous IP list, for VPNs, proxies, Tor nodes and hosting providers.
35
+ *
36
+ * It decides by source address as the reputation list does, and every rule is
37
+ * declared-only for the same reason.
38
+ */
39
+ export const simWafAnonymousIpList = {
40
+ name: "AWSManagedRulesAnonymousIpList",
41
+ labelNamespace: "awswaf:managed:aws:anonymous-ip-list",
42
+ capacity: 50,
43
+ rules: [
44
+ { name: "AnonymousIPList", label: "AnonymousIPList", tier: "declared" },
45
+ {
46
+ name: "HostingProviderIPList",
47
+ label: "HostingProviderIPList",
48
+ tier: "declared",
49
+ },
50
+ ],
51
+ };
@@ -0,0 +1,35 @@
1
+ /**
2
+ * The bot a test says sent a request, as Bot Control would identify it.
3
+ */
4
+ export interface SimWafBotDeclaration {
5
+ /**
6
+ * The category, spelled as the `bot:category:` label spells it, such as
7
+ * `search_engine` or `http_library`.
8
+ */
9
+ readonly category: string;
10
+ /** The bot's name, as the `bot:name:` label spells it, such as `googlebot`. */
11
+ readonly name?: string | undefined;
12
+ /** The bot's publisher, as the `bot:organization:` label spells it. */
13
+ readonly organization?: string | undefined;
14
+ /**
15
+ * Whether Bot Control could verify the bot. A verified bot is labelled and
16
+ * left alone, and an unverified one matches its category's rule.
17
+ */
18
+ readonly verified?: boolean | undefined;
19
+ }
20
+ /**
21
+ * What one declared bot adds to a request: the rules that match it, and the
22
+ * labels the group adds whether or not a rule matches.
23
+ */
24
+ export interface SimWafBotDeclared {
25
+ readonly matches: readonly string[];
26
+ readonly groupLabels: ReadonlyMap<string, readonly string[]>;
27
+ }
28
+ /**
29
+ * Read a declared bot into the rule it matches and the labels it carries.
30
+ *
31
+ * A verified bot matches no rule, `CategoryAI` aside, which AWS applies to
32
+ * verified bots too. Either way the group labels the bot's category, its name
33
+ * and publisher where the declaration gives them, and whether it was verified.
34
+ */
35
+ export declare function simWafBotDeclared(bot: SimWafBotDeclaration): SimWafBotDeclared;
@@ -0,0 +1,42 @@
1
+ import { SimWafDeclarationError } from "../error/sim-wafv2.error.js";
2
+ import { simWafBotCategories, simWafBotCategoryMatchingVerified, simWafBotControlRuleSet, } from "./group/sim-waf-bot-control.js";
3
+ /**
4
+ * Read a declared bot into the rule it matches and the labels it carries.
5
+ *
6
+ * A verified bot matches no rule, `CategoryAI` aside, which AWS applies to
7
+ * verified bots too. Either way the group labels the bot's category, its name
8
+ * and publisher where the declaration gives them, and whether it was verified.
9
+ */
10
+ export function simWafBotDeclared(bot) {
11
+ const rule = requiredCategoryRule(bot.category);
12
+ const verified = bot.verified === true;
13
+ const matches = !verified || bot.category === simWafBotCategoryMatchingVerified;
14
+ return {
15
+ matches: matches ? [rule] : [],
16
+ groupLabels: new Map([
17
+ [
18
+ simWafBotControlRuleSet.name,
19
+ [
20
+ `bot:category:${bot.category}`,
21
+ ...optionalLabel("bot:name", bot.name),
22
+ ...optionalLabel("bot:organization", bot.organization),
23
+ verified ? "bot:verified" : "bot:unverified",
24
+ ],
25
+ ],
26
+ ]),
27
+ };
28
+ }
29
+ /**
30
+ * The rule for one category, refusing a category Bot Control does not name.
31
+ */
32
+ function requiredCategoryRule(category) {
33
+ const rule = simWafBotCategories.get(category);
34
+ if (rule === undefined) {
35
+ throw new SimWafDeclarationError(`Bot Control names no bot category ${category}. The categories are ` +
36
+ `${simWafBotCategories.keys().toArray().join(", ")}.`);
37
+ }
38
+ return rule;
39
+ }
40
+ function optionalLabel(prefix, value) {
41
+ return value === undefined ? [] : [`${prefix}:${value}`];
42
+ }
@@ -0,0 +1,35 @@
1
+ import { type SimWafBotDeclaration } from "./sim-waf-bot-declaration.js";
2
+ /**
3
+ * The managed rules a test says claim a request.
4
+ */
5
+ export interface SimWafManagedMatchDeclaration {
6
+ /** The rules that claim the request, by the name AWS gives them. */
7
+ readonly matches?: readonly string[] | undefined;
8
+ /**
9
+ * The bot that sent the request, for Bot Control to match and label as it
10
+ * would have identified it.
11
+ */
12
+ readonly bot?: SimWafBotDeclaration | undefined;
13
+ }
14
+ /**
15
+ * What a test declared about the requests to one URI path.
16
+ */
17
+ export interface SimWafDeclared {
18
+ readonly matches: ReadonlySet<string>;
19
+ readonly groupLabels: ReadonlyMap<string, readonly string[]>;
20
+ }
21
+ /**
22
+ * What a request nothing was declared for carries.
23
+ */
24
+ export declare const simWafNothingDeclared: SimWafDeclared;
25
+ /**
26
+ * Read a declaration into the rules that match and the labels groups add.
27
+ *
28
+ * `ruleNamed` checks a rule name the declaration gives, and answers with the
29
+ * name the rule goes by.
30
+ */
31
+ export declare function simWafReadDeclaration(declaration: SimWafManagedMatchDeclaration, ruleNamed: (name: string) => string): SimWafDeclared;
32
+ /**
33
+ * The labels one group adds to a request whatever its rules decide.
34
+ */
35
+ export declare function simWafDeclaredGroupLabels(declared: SimWafDeclared, groupName: string): readonly string[];
@@ -0,0 +1,30 @@
1
+ import { simWafBotDeclared, } from "./sim-waf-bot-declaration.js";
2
+ /**
3
+ * What a request nothing was declared for carries.
4
+ */
5
+ export const simWafNothingDeclared = {
6
+ matches: new Set(),
7
+ groupLabels: new Map(),
8
+ };
9
+ /**
10
+ * Read a declaration into the rules that match and the labels groups add.
11
+ *
12
+ * `ruleNamed` checks a rule name the declaration gives, and answers with the
13
+ * name the rule goes by.
14
+ */
15
+ export function simWafReadDeclaration(declaration, ruleNamed) {
16
+ const bot = declaration.bot === undefined
17
+ ? simWafNothingDeclared
18
+ : simWafBotDeclared(declaration.bot);
19
+ const named = (declaration.matches ?? []).map((name) => ruleNamed(name));
20
+ return {
21
+ matches: new Set([...named, ...bot.matches]),
22
+ groupLabels: bot.groupLabels,
23
+ };
24
+ }
25
+ /**
26
+ * The labels one group adds to a request whatever its rules decide.
27
+ */
28
+ export function simWafDeclaredGroupLabels(declared, groupName) {
29
+ return declared.groupLabels.get(groupName) ?? [];
30
+ }
@@ -0,0 +1,11 @@
1
+ import type { SimWafManagedRuleGroupDefinition } from "./sim-waf-managed-rule.type.js";
2
+ /**
3
+ * Stop compiling a rule whose group configuration this simulation does not
4
+ * evaluate, so the web ACL holds it unevaluated.
5
+ *
6
+ * Bot Control at `COMMON` is evaluated, with or without the configuration
7
+ * that names the level. `TARGETED` is held, since its rules read tokens,
8
+ * browser signals and traffic across requests. Every other configuration sets
9
+ * up the account takeover and account creation groups, which are held too.
10
+ */
11
+ export declare function refuseUnsimulatedSimWafGroupConfigs(configs: readonly unknown[] | undefined, group: SimWafManagedRuleGroupDefinition, ruleName: string): void;
@@ -0,0 +1,42 @@
1
+ import { refuseSimWafRuleInput } from "../statement/sim-waf-rule-refusals.js";
2
+ import { simWafBotControlRuleSet } from "./group/sim-waf-bot-control.js";
3
+ /**
4
+ * Stop compiling a rule whose group configuration this simulation does not
5
+ * evaluate, so the web ACL holds it unevaluated.
6
+ *
7
+ * Bot Control at `COMMON` is evaluated, with or without the configuration
8
+ * that names the level. `TARGETED` is held, since its rules read tokens,
9
+ * browser signals and traffic across requests. Every other configuration sets
10
+ * up the account takeover and account creation groups, which are held too.
11
+ */
12
+ export function refuseUnsimulatedSimWafGroupConfigs(configs, group, ruleName) {
13
+ const written = configs ?? [];
14
+ for (const config of written) {
15
+ const level = botControlLevel(config);
16
+ if (group !== simWafBotControlRuleSet || level === undefined) {
17
+ refuseSimWafRuleInput(ruleName, "the rule group member ManagedRuleGroupConfigs", "it configures the account takeover and account creation groups, " +
18
+ "and Bot Control's level, and an entry holding nothing but Bot " +
19
+ "Control at COMMON is the one configuration simulated");
20
+ }
21
+ if (level !== "COMMON") {
22
+ refuseSimWafRuleInput(ruleName, `Bot Control at the ${level} inspection level`, "the targeted rules read tokens, browser signals and traffic across " +
23
+ "requests, and COMMON is the level simulated");
24
+ }
25
+ }
26
+ }
27
+ /**
28
+ * The level one entry runs Bot Control at, when the entry is Bot Control's
29
+ * configuration and nothing else.
30
+ *
31
+ * Anything else answers with no level, so a malformed entry or one carrying
32
+ * another member beside Bot Control's is held rather than read as `COMMON`.
33
+ */
34
+ function botControlLevel(config) {
35
+ const isBotControlAlone = typeof config === "object" &&
36
+ config !== null &&
37
+ Object.keys(config).join(",") === "AWSManagedRulesBotControlRuleSet";
38
+ return isBotControlAlone
39
+ ? config.AWSManagedRulesBotControlRuleSet
40
+ ?.InspectionLevel
41
+ : undefined;
42
+ }
@@ -1,12 +1,13 @@
1
1
  import type { SimWafManagedRuleGroupStatementInput, SimWafOverrideActionInput } from "./sim-waf-managed-group.type.js";
2
2
  import type { SimWafManagedRuleGroupDefinition } from "./sim-waf-managed-rule.type.js";
3
3
  /**
4
- * Find the simulated group a statement names, refusing any other.
4
+ * Find the simulated group a statement names, stopping the rule's compilation
5
+ * at any other so the web ACL holds it unevaluated.
5
6
  *
6
- * The refusal names the groups that are simulated, because the ones that are
7
+ * The reason names the groups that are simulated, because the ones that are
7
8
  * not are left out for reasons a reader cannot guess from the name: a group
8
- * that decides by caller address sees one client for the whole simulation, and
9
- * a group whose detection AWS does not describe cannot be reproduced at all.
9
+ * that decides by behaviour across requests has one request to look at, and a
10
+ * group whose detection AWS does not describe cannot be reproduced at all.
10
11
  */
11
12
  export declare function requiredSimWafManagedRuleGroup(statement: SimWafManagedRuleGroupStatementInput, ruleName: string): SimWafManagedRuleGroupDefinition;
12
13
  /**
@@ -1,5 +1,6 @@
1
1
  import { invalidSimWafRule, refuseSimWafRuleInput, } from "../statement/sim-waf-rule-refusals.js";
2
2
  import { findSimWafManagedRuleGroup, simWafManagedRuleGroupNames, } from "./sim-waf-managed-rule-groups.js";
3
+ import { refuseUnsimulatedSimWafGroupConfigs } from "./sim-waf-managed-group-configs.js";
3
4
  /**
4
5
  * The rule group statement members real WAFv2 takes and this simulation does
5
6
  * not.
@@ -15,19 +16,15 @@ const refusedMembers = new Map([
15
16
  "AWS replaced it with RuleActionOverrides, which says which action a " +
16
17
  "named rule takes rather than only that it takes none",
17
18
  ],
18
- [
19
- "ManagedRuleGroupConfigs",
20
- "it configures the Bot Control, account takeover and account creation " +
21
- "groups, and none of those is simulated",
22
- ],
23
19
  ]);
24
20
  /**
25
- * Find the simulated group a statement names, refusing any other.
21
+ * Find the simulated group a statement names, stopping the rule's compilation
22
+ * at any other so the web ACL holds it unevaluated.
26
23
  *
27
- * The refusal names the groups that are simulated, because the ones that are
24
+ * The reason names the groups that are simulated, because the ones that are
28
25
  * not are left out for reasons a reader cannot guess from the name: a group
29
- * that decides by caller address sees one client for the whole simulation, and
30
- * a group whose detection AWS does not describe cannot be reproduced at all.
26
+ * that decides by behaviour across requests has one request to look at, and a
27
+ * group whose detection AWS does not describe cannot be reproduced at all.
31
28
  */
32
29
  export function requiredSimWafManagedRuleGroup(statement, ruleName) {
33
30
  for (const [member, value] of Object.entries(statement)) {
@@ -42,6 +39,7 @@ export function requiredSimWafManagedRuleGroup(statement, ruleName) {
42
39
  const simulated = simWafManagedRuleGroupNames().join(", ");
43
40
  refuseSimWafRuleInput(ruleName, `the managed rule group ${named}`, `the simulated groups are ${simulated}`);
44
41
  }
42
+ refuseUnsimulatedSimWafGroupConfigs(statement.ManagedRuleGroupConfigs, group, ruleName);
45
43
  return group;
46
44
  }
47
45
  /**
@@ -1,6 +1,7 @@
1
1
  import { compileSimWafStatement } from "../statement/sim-waf-statement.js";
2
- import { SimWafAction } from "../web-acl/sim-waf-action.js";
3
2
  import { requiredSimWafManagedRuleGroup, simWafGroupCountsEverything, } from "./sim-waf-managed-group-input.js";
3
+ import { simWafDeclaredGroupLabels } from "./sim-waf-managed-declaration.js";
4
+ import { simWafAddGroupLabels, simWafManagedRuleActions, } from "./sim-waf-managed-rule-actions.js";
4
5
  import { simWafManagedRuleOverrides } from "./sim-waf-managed-rule-overrides.js";
5
6
  import { simWafManagedRequestParts } from "./sim-waf-managed-request.js";
6
7
  /**
@@ -20,8 +21,11 @@ import { simWafManagedRequestParts } from "./sim-waf-managed-request.js";
20
21
  export function compileSimWafManagedRuleGroup(properties) {
21
22
  const { statement, ruleName, scope } = properties;
22
23
  const group = requiredSimWafManagedRuleGroup(statement, ruleName);
23
- const overrides = simWafManagedRuleOverrides(statement, group, ruleName, scope.customResponseBodies);
24
- const counting = simWafGroupCountsEverything(properties.overrideAction, ruleName);
24
+ const actions = simWafManagedRuleActions({
25
+ ruleName,
26
+ overrides: simWafManagedRuleOverrides(statement, group, ruleName, scope.customResponseBodies),
27
+ counting: simWafGroupCountsEverything(properties.overrideAction, ruleName),
28
+ });
25
29
  const scopeDown = statement.ScopeDownStatement === undefined
26
30
  ? undefined
27
31
  : compileSimWafStatement(statement.ScopeDownStatement, {
@@ -29,10 +33,6 @@ export function compileSimWafManagedRuleGroup(properties) {
29
33
  clock: scope.clock,
30
34
  ruleName,
31
35
  });
32
- // Every rule in the three simulated groups blocks by default, and a group
33
- // that is counting counts whatever the rule that matched was set to.
34
- const blocking = SimWafAction.read({ Block: {} }, ruleName, {});
35
- const counted = SimWafAction.read({ Count: {} }, ruleName, {});
36
36
  const { managedRules } = scope;
37
37
  return (request) => {
38
38
  // A scope-down statement decides whether the group sees the request at
@@ -41,21 +41,23 @@ export function compileSimWafManagedRuleGroup(properties) {
41
41
  return undefined;
42
42
  }
43
43
  const parts = simWafManagedRequestParts(request);
44
- const declared = managedRules.declaredMatches(request);
44
+ const declared = managedRules.declared(request);
45
45
  let matched = false;
46
+ simWafAddGroupLabels(request, group, simWafDeclaredGroupLabels(declared, group.name));
46
47
  for (const rule of group.rules) {
47
- if (!declared.has(rule.name) && rule.detects?.(parts) !== true) {
48
+ if (!declared.matches.has(rule.name) && rule.detects?.(parts) !== true) {
48
49
  continue;
49
50
  }
50
- request.labels.add(`${group.labelNamespace}:${rule.label}`);
51
- const action = counting
52
- ? counted
53
- : (overrides.get(rule.name) ?? blocking);
51
+ simWafAddGroupLabels(request, group, [
52
+ rule.label,
53
+ ...(rule.labels ?? []),
54
+ ]);
55
+ const action = actions.of(rule);
54
56
  if (action.isTerminating) {
55
57
  return action;
56
58
  }
57
59
  matched = true;
58
60
  }
59
- return matched ? counted : undefined;
61
+ return matched ? actions.counted : undefined;
60
62
  };
61
63
  }
@@ -3,8 +3,8 @@ import type { SimWafActionInput } from "../web-acl/sim-waf-action.type.js";
3
3
  /**
4
4
  * Minimal structural WAFv2 ManagedRuleGroupStatement.
5
5
  *
6
- * The members Yulin refuses are declared here rather than left out, so a
7
- * statement that names one is refused by name.
6
+ * The members Yulin does not simulate are declared here rather than left out,
7
+ * so a rule whose statement names one is held and reported by name.
8
8
  *
9
9
  * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/wafv2/Interface/ManagedRuleGroupStatement/
10
10
  */
@@ -0,0 +1,30 @@
1
+ import type { SimWafInspectedRequest } from "../evaluate/sim-waf-inspected-request.js";
2
+ import { SimWafAction } from "../web-acl/sim-waf-action.js";
3
+ import type { SimWafManagedRuleDefinition, SimWafManagedRuleGroupDefinition } from "./sim-waf-managed-rule.type.js";
4
+ interface SimWafManagedRuleActionsProperties {
5
+ readonly ruleName: string;
6
+ readonly overrides: ReadonlyMap<string, SimWafAction>;
7
+ readonly counting: boolean;
8
+ }
9
+ /**
10
+ * What each rule of one managed rule group does to a request it claims.
11
+ */
12
+ export interface SimWafManagedRuleActions {
13
+ /** The action one rule of the group takes. */
14
+ of(rule: SimWafManagedRuleDefinition): SimWafAction;
15
+ /** The action a group answers with when its rules only counted. */
16
+ readonly counted: SimWafAction;
17
+ }
18
+ /**
19
+ * Settle what the rules of a group do, where the rule naming it is compiled.
20
+ *
21
+ * A rule takes its own default (`Block`, or `Count` for the few AWS ships
22
+ * counting), an action override replaces that, and a group counting as a
23
+ * whole counts whatever its rules were set to.
24
+ */
25
+ export declare function simWafManagedRuleActions(properties: SimWafManagedRuleActionsProperties): SimWafManagedRuleActions;
26
+ /**
27
+ * Add labels to a request within a group's namespace.
28
+ */
29
+ export declare function simWafAddGroupLabels(request: SimWafInspectedRequest, group: SimWafManagedRuleGroupDefinition, labels: readonly string[]): void;
30
+ export {};
@@ -0,0 +1,26 @@
1
+ import { SimWafAction } from "../web-acl/sim-waf-action.js";
2
+ /**
3
+ * Settle what the rules of a group do, where the rule naming it is compiled.
4
+ *
5
+ * A rule takes its own default (`Block`, or `Count` for the few AWS ships
6
+ * counting), an action override replaces that, and a group counting as a
7
+ * whole counts whatever its rules were set to.
8
+ */
9
+ export function simWafManagedRuleActions(properties) {
10
+ const { ruleName, overrides, counting } = properties;
11
+ const blocking = SimWafAction.read({ Block: {} }, ruleName, {});
12
+ const counted = SimWafAction.read({ Count: {} }, ruleName, {});
13
+ const ownAction = (rule) => rule.counts === true ? counted : blocking;
14
+ return {
15
+ of: (rule) => counting ? counted : (overrides.get(rule.name) ?? ownAction(rule)),
16
+ counted,
17
+ };
18
+ }
19
+ /**
20
+ * Add labels to a request within a group's namespace.
21
+ */
22
+ export function simWafAddGroupLabels(request, group, labels) {
23
+ for (const label of labels) {
24
+ request.labels.add(`${group.labelNamespace}:${label}`);
25
+ }
26
+ }
@@ -2,8 +2,9 @@ import type { SimWafManagedRuleDefinition, SimWafManagedRuleGroupDefinition } fr
2
2
  /**
3
3
  * The vendor the simulated managed rule groups belong to.
4
4
  *
5
- * A group from any other vendor is refused, marketplace groups included: a
6
- * subscription buys rules nobody outside the vendor has ever seen.
5
+ * A rule naming a group from any other vendor is held unevaluated,
6
+ * marketplace groups included: a subscription buys rules nobody outside the
7
+ * vendor has ever seen.
7
8
  */
8
9
  export declare const simWafManagedVendorName = "AWS";
9
10
  /**
@@ -18,7 +19,8 @@ export interface SimWafManagedRuleEntry {
18
19
  */
19
20
  export declare function findSimWafManagedRuleGroup(vendorName: string | undefined, name: string | undefined): SimWafManagedRuleGroupDefinition | undefined;
20
21
  /**
21
- * The groups that are simulated, named as a refusal names them.
22
+ * The groups that are simulated, named as an unsimulated group's reason names
23
+ * them.
22
24
  */
23
25
  export declare function simWafManagedRuleGroupNames(): readonly string[];
24
26
  /**
@@ -1,17 +1,23 @@
1
1
  import { simWafAdminProtectionRuleSet } from "./group/sim-waf-admin-protection.js";
2
+ import { simWafBotControlRuleSet } from "./group/sim-waf-bot-control.js";
2
3
  import { simWafCommonRuleSet } from "./group/sim-waf-common-rule-set.js";
4
+ import { simWafAnonymousIpList, simWafIpReputationList, } from "./group/sim-waf-ip-reputation.js";
3
5
  import { simWafKnownBadInputsRuleSet } from "./group/sim-waf-known-bad-inputs.js";
4
6
  /**
5
7
  * The vendor the simulated managed rule groups belong to.
6
8
  *
7
- * A group from any other vendor is refused, marketplace groups included: a
8
- * subscription buys rules nobody outside the vendor has ever seen.
9
+ * A rule naming a group from any other vendor is held unevaluated,
10
+ * marketplace groups included: a subscription buys rules nobody outside the
11
+ * vendor has ever seen.
9
12
  */
10
13
  export const simWafManagedVendorName = "AWS";
11
14
  const groups = [
12
15
  simWafCommonRuleSet,
13
16
  simWafKnownBadInputsRuleSet,
14
17
  simWafAdminProtectionRuleSet,
18
+ simWafIpReputationList,
19
+ simWafAnonymousIpList,
20
+ simWafBotControlRuleSet,
15
21
  ];
16
22
  const byName = new Map(groups.map((group) => [group.name, group]));
17
23
  const rulesByName = new Map(groups.flatMap((group) => group.rules.map((rule) => [rule.name, { group, rule }])));
@@ -24,7 +30,8 @@ export function findSimWafManagedRuleGroup(vendorName, name) {
24
30
  : undefined;
25
31
  }
26
32
  /**
27
- * The groups that are simulated, named as a refusal names them.
33
+ * The groups that are simulated, named as an unsimulated group's reason names
34
+ * them.
28
35
  */
29
36
  export function simWafManagedRuleGroupNames() {
30
37
  return groups.map((group) => group.name);