GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing github.com — crypto: return `this` in setAuthTag/setAAD · nodejs/node@875674b

File tree

Expand file treeCollapse file tree

Open diff view settings

Filter options

doc/api
- crypto.md
lib
- crypto.js
test/parallel
- test-crypto-cipher-decipher.js

Expand file treeCollapse file tree

Open diff view settings

Collapse file

`‎doc/api/crypto.md‎`

Copy file name to clipboardExpand all lines: doc/api/crypto.md

+10Lines changed: 10 additions & 0 deletions

Display the source diff
Display the rich diff

Original file line number	Diff line number	Diff line change
@@ -194,6 +194,8 @@ When using an authenticated encryption mode (only `GCM` is currently
`194`	`194`	supported), the `cipher.setAAD()` method sets the value used for the
`195`	`195`	`_additional authenticated data_ (AAD) input parameter.`
`196`	`196`
	`197`	+Returns `this` for method chaining.
	`198`	`+`
`197`	`199`	`### cipher.getAuthTag()`
`198`	`200`	`<!-- YAML`
`199`	`201`	`added: v1.0.0`
@@ -222,6 +224,8 @@ using `0x0` instead of PKCS padding.
`222`	`224`
`223`	`225`	The `cipher.setAutoPadding()` method must be called before [`cipher.final()`][].
`224`	`226`
	`227`	+Returns `this` for method chaining.
	`228`	`+`
`225`	`229`	`### cipher.update(data[, input_encoding][, output_encoding])`
`226`	`230`	`<!-- YAML`
`227`	`231`	`added: v0.1.94`
@@ -329,6 +333,8 @@ When using an authenticated encryption mode (only `GCM` is currently
`329`	`333`	supported), the `decipher.setAAD()` method sets the value used for the
`330`	`334`	`_additional authenticated data_ (AAD) input parameter.`
`331`	`335`
	`336`	+Returns `this` for method chaining.
	`337`	`+`
`332`	`338`	`### decipher.setAuthTag(buffer)`
`333`	`339`	`<!-- YAML`
`334`	`340`	`added: v1.0.0`
`@@ -340,6 +346,8 @@ received _authentication tag_. If no tag is provided, or if the cipher text`
`340`	`346`	has been tampered with, [`decipher.final()`][] with throw, indicating that the
`341`	`347`	`cipher text should be discarded due to failed authentication.`
`342`	`348`
	`349`	+Returns `this` for method chaining.
	`350`	`+`
`343`	`351`	`### decipher.setAutoPadding(auto_padding=true)`
`344`	`352`	`<!-- YAML`
`345`	`353`	`added: v0.7.1`
`@@ -355,6 +363,8 @@ multiple of the ciphers block size.`
`355`	`363`	The `decipher.setAutoPadding()` method must be called before
`356`	`364`	[`decipher.update()`][].
`357`	`365`
	`366`	+Returns `this` for method chaining.
	`367`	`+`
`358`	`368`	`### decipher.update(data[, input_encoding][, output_encoding])`
`359`	`369`	`<!-- YAML`
`360`	`370`	`added: v0.1.94`

Collapse file

`‎lib/crypto.js‎`

Copy file name to clipboardExpand all lines: lib/crypto.js

+2Lines changed: 2 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -178,10 +178,12 @@ Cipher.prototype.getAuthTag = function() {`
`178`	`178`
`179`	`179`	`Cipher.prototype.setAuthTag = function(tagbuf) {`
`180`	`180`	`this._handle.setAuthTag(tagbuf);`
	`181`	`+ return this;`
`181`	`182`	`};`
`182`	`183`
`183`	`184`	`Cipher.prototype.setAAD = function(aadbuf) {`
`184`	`185`	`this._handle.setAAD(aadbuf);`
	`186`	`+ return this;`
`185`	`187`	`};`
`186`	`188`
`187`	`189`	`exports.createCipheriv = exports.Cipheriv = Cipheriv;`

Collapse file

`‎test/parallel/test-crypto-cipher-decipher.js‎`

Copy file name to clipboardExpand all lines: test/parallel/test-crypto-cipher-decipher.js

+11Lines changed: 11 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -139,3 +139,14 @@ testCipher2(Buffer.from('0123456789abcdef'));`
`139`	`139`	`assert.doesNotThrow(() => txt += decipher.final('utf-16le'));`
`140`	`140`	`assert.strictEqual(txt, plaintext, 'decrypted result in utf-16le');`
`141`	`141`	`}`
	`142`	`+`
	`143`	+// setAutoPadding/setAuthTag/setAAD should return `this`
	`144`	`+{`
	`145`	`+ const key = '0123456789';`
	`146`	`+ const tagbuf = Buffer.from('tagbuf');`
	`147`	`+ const aadbuf = Buffer.from('aadbuf');`
	`148`	`+ const decipher = crypto.createDecipher('aes-256-gcm', key);`
	`149`	`+ assert.strictEqual(decipher.setAutoPadding(), decipher);`
	`150`	`+ assert.strictEqual(decipher.setAuthTag(tagbuf), decipher);`
	`151`	`+ assert.strictEqual(decipher.setAAD(aadbuf), decipher);`
	`152`	`+}`

0 commit comments

Comments

0 (0)

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.