Skip to content
Open
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
178 changes: 176 additions & 2 deletions lang/js/lib/schemas.js
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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) {
Expand Down Expand Up @@ -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);
Expand All @@ -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 +1203 to 1223

Copy link
Copy Markdown
Member Author

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).

Comment on lines 1204 to 1223

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in MapType._skip — the sized-block path now rejects a len that exceeds the remaining buffer, and (when minBytes > 0) a len too small to hold n entries at their minimum on-wire size, so the skip can't misalign subsequent decoding.

} else {
Comment on lines 1199 to 1224

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The 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);
Expand Down Expand Up @@ -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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed — added _itemsMinBytes and _valuesMinBytes (initialized to undefined) to the Resolver constructor so all resolvers keep the same hidden class; _updateResolver now just assigns existing fields. The !== undefined fallback checks in the read paths still work.

}
};
Expand Down Expand Up @@ -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));
}
Expand All @@ -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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The 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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed the same way in ArrayType._skip — added the len <= remaining and n <= len / minBytes sanity checks before tap.pos += len.

} else {
Comment on lines 1374 to 1399

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The 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);
}
}
}
Expand Down Expand Up @@ -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;
}
};
Expand Down Expand Up @@ -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).

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The 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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The 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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The 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.
*
Expand Down
16 changes: 15 additions & 1 deletion lang/js/lib/utils.js
Original file line number Diff line number Diff line change
Expand Up @@ -335,10 +335,18 @@ Tap.prototype.readInt = Tap.prototype.readLong = function () {
// Switch to float arithmetic, otherwise we might overflow.
f = n;
fk = 268435456; // 2 ** 28.
// A 64-bit value uses at most 10 bytes; the integer loop above consumed 4,
// so the float loop may read at most 6 more. Reject an overlong varint
// rather than reading an unbounded continuation chain.
var m = 0;
do {
if (m === 6) {
throw new Error('overlong varint');
}
b = buf[this.pos++];
f += (b & 0x7f) * fk;
fk *= 128;
m++;
} while (b & 0x80);
return (f % 2 ? -(f + 1) : f) / 2;
}
Expand All @@ -348,7 +356,13 @@ Tap.prototype.readInt = Tap.prototype.readLong = function () {

Tap.prototype.skipInt = Tap.prototype.skipLong = function () {
var buf = this.buf;
while (buf[this.pos++] & 0x80) {}
var m = 0;
while (buf[this.pos++] & 0x80) {
// At most 10 bytes for a 64-bit varint; reject an overlong encoding.
if (++m === 10) {
throw new Error('overlong varint');
}
}
};

Tap.prototype.writeInt = Tap.prototype.writeLong = function (n) {
Expand Down
Loading
Loading