Italian Translation Report: Node.js [Part 42 - 1137 words]

Prints: some clear text data
When using an authenticated encryption mode (only and are currently supported), the method is used to pass in the received
If no tag is provided, or if the cipher text has been tampered with, will throw, indicating that the cipher text should be discarded due to failed authentication.
Note that this Node.js version does not verify the length of GCM authentication tags.
Such a check must be implemented by applications and is crucial to the authenticity of the encrypted data, otherwise, an attacker can use an arbitrarily short authentication tag to increase the chances of successfully passing authentication (up to 0.39%).
It is highly recommended to associate one of the values 16, 15, 14, 13, 12, 8 or 4 bytes with each key, and to only permit authentication tags of that length, see
When data has been encrypted without standard block padding, calling will disable automatic padding to prevent from checking for and removing padding.
Turning auto padding off will only work if the input data's length is a multiple of the ciphers block size.
The class is a utility for creating Diffie-Hellman key exchanges.
Instances of the class can be created using the function.
Generate Alice's keys...
Generate Bob's keys...
Exchange and generate the secret...
Computes the shared secret using as the other party's public key and returns the computed shared secret.
The supplied key is interpreted using the specified, and secret is encoded using specified
Encodings can be or
If the is not provided, is expected to be a or
If is given a string is returned; otherwise, a is returned.
Generates private and public Diffie-Hellman key values, and returns the public key in the specified
This key should be transferred to the other party.
Encoding can be or
If is provided a string is returned; otherwise a is returned.
Returns the Diffie-Hellman generator in the specified, which can be or
Sets the Diffie-Hellman private key.
If the argument is provided and is either or, is expected to be a string.
If no is provided, is expected to be a or
A bit field containing any warnings and/or errors resulting from a check performed during initialization of the object.
The following values are valid for this property (as defined in module):
The class is a utility for creating Elliptic Curve Diffie-Hellman (ECDH) key exchanges.
Instances of the class can be created using the function.
Converts the EC Diffie-Hellman public key specified by and to the format specified by
The argument specifies point encoding and can be or
The supplied key is interpreted using the specified, and the returned key is encoded using the specified
Use to obtain a list of available curve names.
On recent OpenSSL releases, will also display the name and description of each available elliptic curve.
If is not specified the point will be returned in format.
Example (uncompressing a key):
the converted key and the uncompressed public key should be the same
will throw an error when lies outside of the elliptic curve.
Since is usually supplied from a remote user over an insecure network, its recommended for developers to handle this exception accordingly.
This key should be transferred to the other party.
The argument specifies point encoding and can be or
If is not specified, the point will be returned in format.
If is not valid for the curve specified when the object was created, an error is thrown
Upon setting the private key, the associated public point (key) is also generated and set in the object.
Note that there is not normally a reason to call this method because only requires a private key and the other party's public key to compute the shared secret.
Typically either or will be called.
The method attempts to generate the public point/key associated with the private key being set.
Example (obtaining a shared secret):
Note: This is a shortcut way to specify one of Alice's previous private keys.
It would be unwise to use such a predictable private key in a real application.
Bob uses a newly generated cryptographically strong pseudorandom key pair
and should be the same shared
The class is a utility for creating hash digests of data.
As a that is both readable and writable, where data is written to produce a computed hash digest on the readable side, or
Using the and methods to produce the computed hash.
Calculates the digest of all of the data passed to be hashed (using the
The object can not be used again after method has been called.
Multiple calls will cause an error to be thrown.
Updates the hash content with the given, the encoding of which is given in and can be or
If is not provided, and the is a string, an encoding of is enforced.
This can be called many times with new data as it is streamed.
The Class is a utility for creating cryptographic HMAC digests.
As a that is both readable and writable, where data is written to produce a computed HMAC digest on the readable side, or
Using the and methods to produce the computed HMAC digest.
Calculates the HMAC digest of all of the data passed using
The object can not be used again after has been called.
Multiple calls to will result in an error being thrown.
The Class is a utility for generating signatures.
As a writable stream, where data to be signed is written and the method is used to generate and return the signature, or
Using the and methods to produce the signature.
The argument is the string name of the hash function to use.
the calculated signature using the specified private key and
For RSA keys, the algorithm is (see padding parameter below for).
For EC keys, the algorithm is
In some cases, a instance can also be created by passing in a signature algorithm name, such as
This will use the corresponding digest algorithm.
This does not work for all signature algorithms, such as
Use digest names instead.
signing using legacy signature algorithm name
the calculated signature
Calculates the signature on all the data passed through using either
The argument can be an object or a string.
If is a string, it is treated as a raw key with no passphrase.
If is an object, it must contain one or more of the following properties:
PEM encoded private key (required)
passphrase for the private key
Optional padding value for RSA, one of the following:
Note that will use with the same hash function used to sign the message as specified in section of
salt length for when padding is
The special value
sets the salt length to the digest size, (default) sets it to the maximum permissible value.
The object can not be again used after method has been called.