DrbgParameters Classe

Définition

[Android.Runtime.Register("java/security/DrbgParameters", ApiSince=35, DoNotGenerateAcw=true)]
public class DrbgParameters : Java.Lang.Object

[<Android.Runtime.Register("java/security/DrbgParameters", ApiSince=35, DoNotGenerateAcw=true)>]
type DrbgParameters = class
    inherit Object

Héritage

Object

JavaObject

Object

DrbgParameters

Attributs

RegisterAttribute

Remarques

Cette classe spécifie les paramètres utilisés par un DRBG (Générateur de bits aléatoires déterministes).

Selon la publication spéciale NIST 800-90A Revision 1, recommandation pour la génération de nombres aléatoires à l’aide de générateurs de bits aléatoires déterministes (800-90Ar1), <blockquote> A DRBG est basé sur un mécanisme DRBG tel que spécifié dans cette recommandation et inclut une source de randomité. Un mécanisme DRBG utilise un algorithme (c’est-à-dire un algorithme DRBG) qui produit une séquence de bits à partir d’une valeur initiale déterminée par une valeur initiale déterminée par une valeur initiale qui est déterminée à partir de la sortie de la source de randomness. » </blockquote>

La spécification 800-90Ar1 permet de choisir divers choix d’implémentation DRBG, tels que : <ul><li> an entropy source, <li> a DRBG mechanism (par exemple, Hash_DRBG), <li> a DRBG algorithm (par exemple, SHA-256 for Hash_DRBG et AES-256 for CTR_DRBG. Notez qu’il ne s’agit pas de l’algorithme utilisé dans SecureRandom#getInstance, que nous appellerons un<> algorithme< Em SecureRandom/em> ci-dessous), <les fonctionnalités facultatives li>, notamment la résistance de prédiction et la prise en charge de la reseeding, <li> plus haute force de sécurité. </ul>

Ces choix sont définis dans chaque implémentation et ne sont pas directement gérés par l’API SecureRandom . Consultez la documentation de votre fournisseur DRBG pour trouver une implémentation appropriée pour la situation.

En revanche, la spécification 800-90Ar1 dispose de certaines options configurables, telles que : ul<li requis en matière de sécurité, >li< si la résistance de prédiction est requise, >la chaîne de personnalisation li< et les entrées supplémentaires.><> </ul>

Une instance DRBG peut être instanciée avec des paramètres d’un DrbgParameters.Instantiation objet et d’autres informations (par exemple, la nonce, qui n’est pas gérée par cette API). Cela correspond à la Instantiate_function valeur définie dans NIST SP 800-90Ar1.

Une instance DRBG peut être reseeded avec des paramètres d’un DrbgParameters.Reseed objet. Cela correspond à la Reseed_function valeur définie dans NIST SP 800-90Ar1. L’appel SecureRandom#reseed() équivaut à appeler SecureRandom#reseed(SecureRandomParameters) avec l’indicateur de résistance de prédiction instancié effectif (tel qu’il est retourné par SecureRandom#getParameters()) sans entrée supplémentaire.

Une instance DRBG génère des données avec des paramètres supplémentaires à partir d’un DrbgParameters.NextBytes objet. Cela correspond à la Generate_function valeur définie dans NIST SP 800-90Ar1. L’appel SecureRandom#nextBytes(byte[]) équivaut à appeler SecureRandom#nextBytes(byte[], SecureRandomParameters) avec la force instanciée effective et l’indicateur de résistance de prédiction (tel qu’il est retourné par SecureRandom#getParameters()) sans entrée supplémentaire.

Un DRBG doit être implémenté en tant que sous-classe de SecureRandomSpi. Il est recommandé que l’implémentation contienne le constructeur 1-arg SecureRandomSpi#SecureRandomSpi(SecureRandomParameters) qui accepte un DrbgParameters.Instantiation argument. Si elle est implémentée de cette façon, cette implémentation peut être choisie par n’importe quelle SecureRandom.getInstance() méthode. S’il est choisi par un SecureRandom.getInstance() paramètre avec un SecureRandomParameters paramètre, le paramètre est passé dans ce constructeur. S’il est choisi par un SecureRandom.getInstance() sans SecureRandomParameters paramètre, le constructeur est appelé avec un null argument et l’implémentation doit choisir ses propres paramètres. Il SecureRandom#getParameters() doit toujours retourner un objet effectif DrbgParameters.Instantiation non null qui reflète la façon dont le DRBG est réellement instancié. Un appelant peut utiliser ces informations pour déterminer si un SecureRandom objet est un DRBG et quelles fonctionnalités il prend en charge. Notez que la valeur retournée n’est pas nécessairement égale à l’objet DrbgParameters.Instantiation passé dans l’appel SecureRandom.getInstance() . Par exemple, la fonctionnalité demandée peut être DrbgParameters.Capability#NONE mais la valeur effective peut être DrbgParameters.Capability#RESEED_ONLY si l’implémentation prend en charge la réexédation. L’implémentation doit implémenter la SecureRandomSpi#engineNextBytes(byte[], SecureRandomParameters) méthode qui prend un DrbgParameters.NextBytes paramètre. À moins que le résultat de SecureRandom#getParameters() sa fonctionnalité DrbgParameters.Instantiation#getCapability() soit Capability#NONE NONE, il doit implémenter SecureRandomSpi#engineReseed(SecureRandomParameters) qui prend un DrbgParameters.Reseed paramètre.

En revanche, si une implémentation DRBG ne contient pas de constructeur qui a un DrbgParameters.Instantiation argument (non recommandé), elle ne peut être choisie que par un SecureRandom.getInstance() paramètre sans SecureRandomParameters paramètre, mais ne sera pas choisie si une getInstance méthode avec un SecureRandomParameters paramètre est appelée. S’il est implémenté de cette façon, il SecureRandom#getParameters() doit retourner null, et il n’a pas besoin d’implémenter l’un ou l’autre SecureRandomSpi#engineNextBytes(byte[], SecureRandomParameters) .SecureRandomSpi#engineReseed(SecureRandomParameters)

Un DRBG peut se réappliquer automatiquement si la période de départ est supérieure à la durée maximale de vie des semences définie par le mécanisme DRBG.

Une implémentation DRBG doit prendre en charge la sérialisation et la désérialisation en conservant les paramètres de configuration et effectifs, mais l’état interne ne doit pas être sérialisé et l’objet désérialisé doit être réinitialisé.

Exemples : <blockquote>

SecureRandom drbg;
            byte[] buffer = new byte[32];

            // Any DRBG is OK
            drbg = SecureRandom.getInstance("DRBG");
            drbg.nextBytes(buffer);

            SecureRandomParameters params = drbg.getParameters();
            if (params instanceof DrbgParameters.Instantiation) {
                DrbgParameters.Instantiation ins = (DrbgParameters.Instantiation) params;
                if (ins.getCapability().supportsReseeding()) {
                    drbg.reseed();
                }
            }

            // The following call requests a weak DRBG instance. It is only
            // guaranteed to support 112 bits of security strength.
            drbg = SecureRandom.getInstance("DRBG",
                    DrbgParameters.instantiation(112, NONE, null));

            // Both the next two calls will likely fail, because drbg could be
            // instantiated with a smaller strength with no prediction resistance
            // support.
            drbg.nextBytes(buffer,
                    DrbgParameters.nextBytes(256, false, "more".getBytes()));
            drbg.nextBytes(buffer,
                    DrbgParameters.nextBytes(112, true, "more".getBytes()));

            // The following call requests a strong DRBG instance, with a
            // personalization string. If it successfully returns an instance,
            // that instance is guaranteed to support 256 bits of security strength
            // with prediction resistance available.
            drbg = SecureRandom.getInstance("DRBG", DrbgParameters.instantiation(
                    256, PR_AND_RESEED, "hello".getBytes()));

            // Prediction resistance is not requested in this single call,
            // but an additional input is used.
            drbg.nextBytes(buffer,
                    DrbgParameters.nextBytes(-1, false, "more".getBytes()));

            // Same for this call.
            drbg.reseed(DrbgParameters.reseed(false, "extra".getBytes()));

</blockquote>

Ajouté dans 9.

Java documentation pour java.security.DrbgParameters.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.