DrbgParameters.Capability Class

Definition

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

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

Inheritance

Object

Object

Enum

DrbgParameters.Capability

Attributes

RegisterAttribute

Remarks

The reseedable and prediction resistance capabilities of a DRBG.

When this object is passed to a SecureRandom.getInstance() call, it is the requested minimum capability. When it's returned from SecureRandom.getParameters(), it is the effective capability.

Please note that while the Instantiate_function defined in NIST SP 800-90Ar1 only includes a prediction_resistance_flag parameter, the Capability type includes an extra value #RESEED_ONLY because reseeding is an optional function. If NONE is used in an Instantiation object in calling the SecureRandom.getInstance method, the returned DRBG instance is not guaranteed to support reseeding. If RESEED_ONLY or PR_AND_RESEED is used, the instance must support reseeding.

The table below lists possible effective values if a certain capability is requested, i.e. <blockquote>

Capability requested = ...;
            SecureRandom s = SecureRandom.getInstance("DRBG",
                    DrbgParameters(-1, requested, null));
            Capability effective = ((DrbgParametes.Initiate) s.getParameters())
                    .getCapability();

</blockquote> <table class="striped"> <caption style="display:none">requested and effective capabilities</caption> <thead> <tr> <th scope="col">Requested Value</th> <th scope="col">Possible Effective Values</th> </tr> </thead> <tbody style="text-align:left"> <tr><th scope="row">NONE</th><td>NONE, RESEED_ONLY, PR_AND_RESEED</td></tr> <tr><th scope="row">RESEED_ONLY</th><td>RESEED_ONLY, PR_AND_RESEED</td></tr> <tr><th scope="row">PR_AND_RESEED</th><td>PR_AND_RESEED</td></tr> </tbody> </table>

A DRBG implementation supporting prediction resistance must also support reseeding.

Added in 9.

Java documentation for java.security.DrbgParameters.Capability.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.