N/crypto/random Module for Secure Random Data in SuiteScript

The N/crypto/random module enables developers to generate secure random data needed for various applications within NetSuite. This module is available for both client and server scripts, making it versatile for different scripting needs.

What Methods Are Available in the N/crypto/random Module?

The N/crypto/random module includes the following primary methods:

random.generateBytes(options)

• Return Type: Uint8Array
• Description: Generates a cryptographically strong pseudorandom set of bytes.
• Parameters:

  Parameter	Type	Required / Optional	Description
  options.size	number	Required	The number of bytes to generate; between 1 and 512.

Code Sample:

// Generate 5 random bytes of data
var bytes = random.generateBytes({size: 5});

random.generateInt(options)

• Return Type: number
• Description: Generates a cryptographically strong pseudorandom number.
• Parameters:

  Parameter	Type	Required / Optional	Description
  options.max	number	Required	End of random range (exclusive).
  options.min	number	Optional	Start of random range; default is 0.

Code Sample:

// Generate a random number between 0 and 100 (excluded)
var number = random.generateInt({max: 100});
// Generate a random number between 10 and 100 (excluded)
var anotherNumber = random.generateInt({min: 10, max: 100});

random.generateUUID()

• Return Type: string
• Description: Generates a v4 Universally Unique Identifier (UUID) using a secure random number generator.

Who This Affects

This module is particularly useful for:

• Developers creating custom scripts that require secure random data.
• Administrators managing security protocols that depend on unique identifiers or random data generation.

Key Takeaways

• The N/crypto/random module provides essential functions for secure random data generation.
• Available for both client and server scripts, enhancing flexibility.
• Critical for applications requiring unique identifiers or secure pseudorandom numbers.