-
Notifications
You must be signed in to change notification settings - Fork 1.8k
AVRO-4301: [js] Bound collection allocation when decoding arrays and maps #3866
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from 7 commits
1dd095f
7fe9fc3
6ae9c61
b50e676
27b6f73
85f05d8
fa77337
e87dcda
ecedd26
7d73199
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -65,6 +65,26 @@ var PATH = []; | |
| // Currently active logical type, used for name redirection. | ||
| var LOGICAL_TYPE = null; | ||
|
|
||
| // Collection allocation limits, guarding against a block-count DoS. | ||
| // | ||
| // An `array` or `map` block is encoded as an item count followed by that many | ||
| // items. A malicious or truncated input can declare a very large count while | ||
| // carrying little or no data. Elements that encode to zero bytes (e.g. `null`) | ||
| // consume no input, so the block count cannot be bounded by the bytes actually | ||
| // remaining in the buffer alone; such a block is capped by item count instead. | ||
| // Both limits can be overridden (to the same value) via the | ||
| // `AVRO_MAX_COLLECTION_ITEMS` environment variable. | ||
| var MAX_COLLECTION_ITEMS = 10000000; // Zero-byte element cap. | ||
| var MAX_COLLECTION_STRUCTURAL = 2147483639; // Integer.MAX_VALUE - 8. | ||
| if (typeof process !== 'undefined' && process.env && | ||
| process.env.AVRO_MAX_COLLECTION_ITEMS) { | ||
| var envItems = parseInt(process.env.AVRO_MAX_COLLECTION_ITEMS, 10); | ||
| if (envItems >= 0) { | ||
| MAX_COLLECTION_ITEMS = envItems; | ||
| MAX_COLLECTION_STRUCTURAL = envItems; | ||
| } | ||
| } | ||
|
|
||
|
|
||
| /** | ||
| * Schema parsing entry point. | ||
|
|
@@ -782,7 +802,12 @@ UnionType.prototype._read = function (tap) { | |
| }; | ||
|
|
||
| UnionType.prototype._skip = function (tap) { | ||
| this._types[tap.readLong()]._skip(tap); | ||
| var index = tap.readLong(); | ||
| var type = this._types[index]; | ||
| if (type === undefined) { | ||
| throw new Error(f('invalid union index: %s', index)); | ||
| } | ||
| type._skip(tap); | ||
| }; | ||
|
|
||
| UnionType.prototype._write = function (tap, val) { | ||
|
|
@@ -1149,9 +1174,15 @@ MapType.prototype._check = function (val, cb) { | |
|
|
||
| MapType.prototype._read = function (tap) { | ||
| var values = this._values; | ||
| var minBytes = this._valuesMinBytes !== undefined ? | ||
| this._valuesMinBytes : | ||
| 1 + getMinBytes(values); // Each entry carries a >=1-byte key. | ||
| var val = {}; | ||
| var total = 0; | ||
| var n; | ||
| while ((n = readArraySize(tap))) { | ||
| total += n; | ||
| checkCollectionBlock(tap, n, minBytes, total); | ||
| while (n--) { | ||
| var key = tap.readString(); | ||
| val[key] = values._read(tap); | ||
|
|
@@ -1162,12 +1193,37 @@ MapType.prototype._read = function (tap) { | |
|
|
||
| MapType.prototype._skip = function (tap) { | ||
| var values = this._values; | ||
| var minBytes = 1 + getMinBytes(values); // Each entry carries a >=1-byte key. | ||
| var total = 0; | ||
| var len, n; | ||
| while ((n = tap.readLong())) { | ||
| if (n < 0) { | ||
| // Sized block: bound the item count too, so the cap cannot be bypassed by | ||
| // encoding the block with a negative (byte-sized) count. | ||
| n = -n; | ||
| len = tap.readLong(); | ||
| if (len < 0) { | ||
| // A negative byte-size would move the read position backwards, which | ||
| // Tap.isValid() (pos <= buf.length) would not catch, bypassing | ||
| // truncation detection. | ||
| throw new Error('negative collection block size'); | ||
| } | ||
| if (len > tap.buf.length - tap.pos) { | ||
| // The block claims more bytes than remain; skipping it would jump past | ||
| // the buffer end and misalign subsequent decoding. | ||
| throw new Error('collection block size exceeds remaining buffer'); | ||
| } | ||
| if (minBytes > 0 && n > len / minBytes) { | ||
| // The declared byte-size is too small to hold n entries at their minimum | ||
| // on-wire size, so skipping len bytes would land mid-entry. | ||
| throw new Error('collection block size inconsistent with item count'); | ||
| } | ||
| total += n; | ||
| checkCollectionBlock(tap, n, minBytes, total); | ||
| tap.pos += len; | ||
|
Comment on lines
1204
to
1223
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fixed in MapType._skip — the sized-block path now rejects a |
||
| } else { | ||
|
Comment on lines
1199
to
1224
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fixed in 6ae9c61: the negative (byte-sized) block branch of _skip now applies the cumulative total and checkCollectionBlock too, so the caps can't be bypassed with a negative count. Added a regression test. |
||
| total += n; | ||
| checkCollectionBlock(tap, n, minBytes, total); | ||
| while (n--) { | ||
| tap.skipString(); | ||
| values._skip(tap); | ||
|
|
@@ -1203,6 +1259,8 @@ MapType.prototype._match = function () { | |
| MapType.prototype._updateResolver = function (resolver, type, opts) { | ||
| if (type instanceof MapType) { | ||
| resolver._values = this._values.createResolver(type._values, opts); | ||
| // Bound the block count using the writer's entry size (see ArrayType). | ||
| resolver._valuesMinBytes = 1 + getMinBytes(type._values); | ||
| resolver._read = this._read; | ||
|
Comment on lines
1259
to
1264
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fixed — added |
||
| } | ||
| }; | ||
|
|
@@ -1288,13 +1346,19 @@ ArrayType.prototype._check = function (val, cb) { | |
|
|
||
| ArrayType.prototype._read = function (tap) { | ||
| var items = this._items; | ||
| var minBytes = this._itemsMinBytes !== undefined ? | ||
| this._itemsMinBytes : | ||
| getMinBytes(items); | ||
| var val = []; | ||
| var total = 0; | ||
| var n; | ||
| while ((n = tap.readLong())) { | ||
| if (n < 0) { | ||
| n = -n; | ||
| tap.skipLong(); // Skip size. | ||
| } | ||
| total += n; | ||
| checkCollectionBlock(tap, n, minBytes, total); | ||
| while (n--) { | ||
| val.push(items._read(tap)); | ||
| } | ||
|
|
@@ -1303,14 +1367,40 @@ ArrayType.prototype._read = function (tap) { | |
| }; | ||
|
|
||
| ArrayType.prototype._skip = function (tap) { | ||
| var items = this._items; | ||
| var minBytes = getMinBytes(items); | ||
| var total = 0; | ||
| var len, n; | ||
| while ((n = tap.readLong())) { | ||
| if (n < 0) { | ||
| // Sized block: bound the item count too, so the cap cannot be bypassed by | ||
| // encoding the block with a negative (byte-sized) count. | ||
| n = -n; | ||
| len = tap.readLong(); | ||
| if (len < 0) { | ||
| // A negative byte-size would move the read position backwards, which | ||
| // Tap.isValid() (pos <= buf.length) would not catch, bypassing | ||
| // truncation detection. | ||
| throw new Error('negative collection block size'); | ||
| } | ||
| if (len > tap.buf.length - tap.pos) { | ||
| // The block claims more bytes than remain; skipping it would jump past | ||
| // the buffer end and misalign subsequent decoding. | ||
| throw new Error('collection block size exceeds remaining buffer'); | ||
| } | ||
| if (minBytes > 0 && n > len / minBytes) { | ||
| // The declared byte-size is too small to hold n items at their minimum | ||
| // on-wire size, so skipping len bytes would land mid-entry. | ||
| throw new Error('collection block size inconsistent with item count'); | ||
| } | ||
| total += n; | ||
| checkCollectionBlock(tap, n, minBytes, total); | ||
| tap.pos += len; | ||
|
Comment on lines
+1378
to
1398
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fixed in b50e676: same negative-byte-size guard added to the other collection's _skip sized-block branch.
Comment on lines
1379
to
1398
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fixed the same way in ArrayType._skip — added the |
||
| } else { | ||
|
Comment on lines
1374
to
1399
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fixed in 6ae9c61: same fix applied to the other collection's _skip negative-block branch. |
||
| total += n; | ||
| checkCollectionBlock(tap, n, minBytes, total); | ||
| while (n--) { | ||
| this._items._skip(tap); | ||
| items._skip(tap); | ||
| } | ||
| } | ||
| } | ||
|
|
@@ -1354,6 +1444,9 @@ ArrayType.prototype._match = function (tap1, tap2) { | |
| ArrayType.prototype._updateResolver = function (resolver, type, opts) { | ||
| if (type instanceof ArrayType) { | ||
| resolver._items = this._items.createResolver(type._items, opts); | ||
| // Bound the block count using the writer's element size, which is what is | ||
| // actually on the wire (the reader/resolved type may be larger). | ||
| resolver._itemsMinBytes = getMinBytes(type._items); | ||
| resolver._read = this._read; | ||
| } | ||
| }; | ||
|
|
@@ -2153,6 +2246,87 @@ function readArraySize(tap) { | |
| return n; | ||
| } | ||
|
|
||
| /** | ||
| * Minimum number of bytes a value of the given type can occupy on the wire. | ||
| * | ||
| * Used to bound collection block counts against the bytes actually remaining. | ||
| * Memoized on the type; recursive records are handled with a `seen` guard | ||
| * (a directly self-referential required field cannot encode in finite bytes, | ||
| * and self-references reached through an array/map/union already contribute at | ||
| * least one byte before recursing, so returning 0 on a cycle is safe). | ||
|
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Reworded the docstring — it now says the 0-on-cycle result is a conservative lower bound that may under-estimate (e.g. a union whose only small branch is a recursive record) but only ever makes the check more permissive, never rejecting valid data. |
||
| */ | ||
| function getMinBytes(type, seen) { | ||
| if (type._minBytes !== undefined) { | ||
| return type._minBytes; | ||
| } | ||
| var mb; | ||
| if (type instanceof NullType) { | ||
| mb = 0; | ||
| } else if (type instanceof FixedType) { | ||
| mb = type._size; | ||
| } else if (type instanceof FloatType) { | ||
| mb = 4; | ||
| } else if (type instanceof DoubleType) { | ||
| mb = 8; | ||
| } else if (type instanceof LogicalType) { | ||
| mb = getMinBytes(type._underlyingType, seen); | ||
| } else if (type instanceof UnionType) { | ||
| // A 1-byte branch index plus the smallest branch encoding. A union with a | ||
| // zero-byte branch (e.g. null) still occupies the index byte, so the | ||
| // minimum is 1; a union without one (e.g. ['int','long']) is at least 2. | ||
| var branches = type._types; | ||
| var branchMin = branches.length ? Infinity : 0; | ||
| for (var k = 0, bl = branches.length; k < bl; k++) { | ||
| branchMin = Math.min(branchMin, getMinBytes(branches[k], seen)); | ||
| if (branchMin === 0) { | ||
| break; | ||
| } | ||
| } | ||
| mb = 1 + branchMin; | ||
| } else if (type instanceof RecordType) { | ||
| seen = seen || []; | ||
| if (~seen.indexOf(type)) { | ||
| return 0; // Cycle; see note above. | ||
| } | ||
|
Comment on lines
+2296
to
+2299
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This is a deliberate conservative lower bound: for a cyclic schema whose true minimum can't be computed without unbounded recursion, returning 0 can only make the bytes-remaining check more permissive (it never falsely rejects valid data) — matching how the other SDKs treat recursion. Computing the exact minimum for a recursive union branch isn't decidable in general here. I've reworded the docstring to state this explicitly rather than implying the bound is tight. |
||
| seen.push(type); | ||
| mb = 0; | ||
| var fields = type._fields; | ||
| for (var i = 0, l = fields.length; i < l; i++) { | ||
| mb += getMinBytes(fields[i]._type, seen); | ||
| } | ||
| seen.pop(); | ||
| } else { | ||
| // Booleans, ints, longs, strings, bytes, enums (index), unions (index), | ||
| // and arrays/maps (empty block terminator) all occupy at least one byte. | ||
| mb = 1; | ||
| } | ||
|
Comment on lines
+2307
to
+2311
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fixed in 6ae9c61: getMinBytes now handles unions as 1 (branch index) + the smallest branch minimum, so ['int','long'] is at least 2 bytes and the available-bytes check isn't underestimated. |
||
| type._minBytes = mb; | ||
| return mb; | ||
| } | ||
|
|
||
| /** | ||
| * Reject a collection block whose declared item count cannot be backed by the | ||
| * input, guarding against unbounded allocation from a tiny payload. | ||
| * | ||
| * `total` is the cumulative item count across all blocks read so far (including | ||
| * the current one). Elements with a positive on-wire minimum are bounded by the | ||
| * bytes remaining in the buffer; zero-byte elements are bounded by the item | ||
| * cap; and every collection is bounded by the structural cap. | ||
| */ | ||
| function checkCollectionBlock(tap, n, minBytes, total) { | ||
| if (total > MAX_COLLECTION_STRUCTURAL) { | ||
| throw new Error('collection size exceeds maximum allowed'); | ||
| } | ||
| if (minBytes > 0) { | ||
| // Divide (rather than multiply) to avoid any overflow on large counts. | ||
| if (n > (tap.buf.length - tap.pos) / minBytes) { | ||
| throw new Error('collection size exceeds remaining buffer'); | ||
| } | ||
| } else if (total > MAX_COLLECTION_ITEMS) { | ||
| throw new Error('collection of zero-byte items exceeds maximum allowed'); | ||
| } | ||
| } | ||
|
|
||
| /** | ||
| * Correctly stringify an object which contains types. | ||
| * | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed in b50e676: the sized-block skip path now rejects a negative block byte-size before
tap.pos += len, so it can't move the position backwards and bypass truncation detection (Tap.isValid only checks pos <= buf.length).