The purpose of the Random Number Generation API is the generation of cryptographically strong random numbers.
Several cryptographic applications rely upon the randomness, unpredictability and irreproducibility of the random number generator, such as:
Initialization Vectors (IVs)
salts to be hashed with passwords
unique parameters in signing operations.
In order to be fully compliant with DSS (Digital Signature Standard), applications using the cryptography library must supply a FIPS-186-2 CR 1 compliant random number generator. The library provides a mechanism for using such a random number generator if required.
The diagram below shows the main classes used in the RNG, which are implemented in random.dll . For information on each class see the Cryptography API Reference material.
How to use TRandom
TRandom is a cryptographically stong random number generator. Its declaration is:
TRandom::RandomL() generates random bytes by first connecting to the random number generation server (using RRandomSession ). If the attempt to connect fails, TRandom::RandomL() leaves.
The server fills aDestination with randomly generated bytes up to its current length (not its maximum length). If this fails, TRandom::RandomL() leaves. If aDestination is 1024 or more bytes long, multiple calls are made to the server. Finally, TRandom closes the session.
TRandom can be used like this:
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.