JSON Threat Protection Policy

Policy Name

JSON Threat Protection

Summary

Protects against malicious JSON in API requests

Category

Security

First Omni Gateway version available

v1.4.0

Release Notes

JSON Threat Protection Policy

Returned Status Codes

400 - Bad Request

Summary

Applications processing JSON requests are susceptible to attacks characterized by unusual inflation of elements and nesting levels. Attackers use recursive techniques to consume memory resources. Dramatic swings in the size of the application data often signal a security problem. The JSON Threat Protection policy helps protect your applications from such intrusions.

If you find that attacks on your Anypoint Platform setup are difficult to detect, design your services architecture with layers of protection in addition to JSON Threat Protection.

The JSON Threat Protection policy doesn’t support multi-part form requests.

Configuring Policy Parameters

Omni Gateway Local Mode

When you apply the policy via declarative configuration files, Refer to the following policy definition and table of parameters:

- policyRef:
    name: json-threat-protection-flex
  config:
    maxContainerDepth: <int> // OPTIONAL
    maxObjectEntryCount: <int> // OPTIONAL
    maxObjectEntryNameLength: <int> // OPTIONAL
    maxArrayElementCount: <int> // OPTIONAL
    maxStringValueLength: <int> // OPTIONAL

Parameter Required or Optional Default Value Description

Parameter	Required or Optional	Default Value	Description
`maxContainerDepth`	Optional	-1	Specifies the maximum nested depth. JSON allows you to nest the containers (object and array) in any order to any depth. Specifying -1 indicates that the field value has no limits.
`maxObjectEntryCount`	Optional	-1	Specifies the maximum number of entries in an object. Specifying -1 indicates that the field value has no limits.
`maxObjectEntryNameLength`	Optional	-1	Specifies the maximum string length of an object’s entry name. Specifying -1 indicates that the field value has no limits.
`maxArrayElementCount`	Optional	-1	Specifies the maximum number of elements in an array. Specifying -1 indicates that the field value has no limits.
`maxStringValueLength`	Optional	-1	Specifies the maximum string value length. Specifying -1 indicates that the field value has no limits.

maxContainerDepth

Optional

-1

Specifies the maximum nested depth. JSON allows you to nest the containers (object and array) in any order to any depth. Specifying -1 indicates that the field value has no limits.

maxObjectEntryCount

Optional

-1

Specifies the maximum number of entries in an object. Specifying -1 indicates that the field value has no limits.

maxObjectEntryNameLength

Optional

-1

Specifies the maximum string length of an object’s entry name. Specifying -1 indicates that the field value has no limits.

maxArrayElementCount

Optional

-1

Specifies the maximum number of elements in an array. Specifying -1 indicates that the field value has no limits.

maxStringValueLength

Optional

-1

Specifies the maximum string value length. Specifying -1 indicates that the field value has no limits.

Resource Configuration Example

- policyRef:
    name: json-threat-protection-flex
  config:
    maxContainerDepth: 10
    maxObjectEntryCount: 10000
    maxObjectEntryNameLength: 80
    maxArrayElementCount: 10000
    maxStringValueLength: 255

Managed Omni Gateway and Omni Gateway Connected Mode

When you apply the policy from the UI, the following parameters are displayed:

Field

Description

Default

Required

Maximum Container Depth

Specifies the maximum nested depth. JSON allows you to nest the containers (object and array) in any order to any depth

-1

false

Maximum String Value Length

Specifies the maximum length of a string value

-1

false

Maximum Object Entry Name Length

Specifies the maximum string length of an object’s entry name

-1

false

Maximum Object Entry Count

Specifies the maximum number of entries in an object

-1

false

Maximum Array Element Count

Specifies the maximum number of elements in an array

-1

false

A value of -1 indicates that the field value has no limits.

Payload Example

If your payload contains the following example JSON:

{
   "Players":[
      {
         "Name":"Sachin",
         "Email":"sachin.tendulkar@example.com"
      },
      {
         "Name":"Suryakumar",
         "email":"Surya@example.com"
      },
      {   "Name":"Bhuvi",
          "email":"bhuvi@example.com"
      },
      {
         "Name":"Jonty",
         "Email":"jonty@example.com"
      }
   ]
}

The policy defines the example parameter values as follows:

Parameter Value Explanation

Parameter	Value	Explanation
Maximum Container Depth	3	The depth of the `Name` and `Email` entries
Maximum String Value Length	28	The length of `sachin.tendulkar@example.com`
Maximum Object Entry Name Length	7	The length of the `Players` object entry name
Maximum Object Entry Count	2	The number of entries in each `Players` object
Maximum Array Element Count	4	The number of elements in the `Players` array

Maximum Container Depth

The depth of the Name and Email entries

Maximum String Value Length

The length of sachin.tendulkar@example.com

Maximum Object Entry Name Length

The length of the Players object entry name

Maximum Object Entry Count

The number of entries in each Players object

Maximum Array Element Count

The number of elements in the Players array