Package org.bouncycastle.crypto

Class CryptoServicesRegistrar

  • public final class CryptoServicesRegistrar
extends java.lang.Object
    Basic registrar class for providing defaults for cryptography services in this module.

    • Method Detail

      • getSecureRandom

        public static java.security.SecureRandom getSecureRandom()
        Return the default source of randomness.
        Returns:
        the default SecureRandom

      • getSecureRandom

        public static java.security.SecureRandom getSecureRandom​(java.security.SecureRandom secureRandom)
        Return either the passed-in SecureRandom, or if it is null, then the default source of randomness.
        Parameters:
        secureRandom - the SecureRandom to use if it is not null.
        Returns:
        the SecureRandom parameter if it is not null, or else the default SecureRandom

      • setSecureRandom

        public static void setSecureRandom​(java.security.SecureRandom secureRandom)
        Set a default secure random to be used where none is otherwise provided.
        Parameters:
        secureRandom - the SecureRandom to use as the default.

      • setSecureRandomProvider

        public static void setSecureRandomProvider​(SecureRandomProvider secureRandomProvider)
        Set a default secure random provider to be used where none is otherwise provided.
        Parameters:
        secureRandomProvider - a provider SecureRandom to use when a default SecureRandom is requested.

      • getServicesConstraints

        public static CryptoServicesConstraints getServicesConstraints()
        Return the current algorithm/services constraints.
        Returns:
        the algorithm/services constraints.

      • checkConstraints

        public static void checkConstraints​(CryptoServiceProperties cryptoService)
        Check a service to make sure it meets the current constraints.
        Parameters:
        cryptoService - the service to be checked.
        Throws:
        CryptoServiceConstraintsException - if the service violates the current constraints.

      • setServicesConstraints

        public static void setServicesConstraints​(CryptoServicesConstraints constraints)
        Set the current algorithm constraints.

      • getProperty

        public static java.lang.Object getProperty​(CryptoServicesRegistrar.Property property)
        Return the default value for a particular property if one exists. The look up is done on the thread's local configuration first and then on the global configuration in no local configuration exists.
        Parameters:
        property - the property to look up.
        the - type to be returned
        Returns:
        null if the property is not set, the default value otherwise,

      • getSizedProperty

        public static java.lang.Object[] getSizedProperty​(CryptoServicesRegistrar.Property property)
        Return an array representing the current values for a sized property such as DH_DEFAULT_PARAMS or DSA_DEFAULT_PARAMS.
        Parameters:
        property - the name of the property to look up.
        the - base type of the array to be returned.
        Returns:
        null if the property is not set, an array of the current values otherwise.

      • getSizedProperty

        public static java.lang.Object getSizedProperty​(CryptoServicesRegistrar.Property property,
                                                int size)
        Return the value for a specific size for a sized property such as DH_DEFAULT_PARAMS or DSA_DEFAULT_PARAMS.
        Parameters:
        property - the name of the property to look up.
        size - the size (in bits) of the defining value in the property type.
        the - type of the value to be returned.
        Returns:
        the current value for the size, null if there is no value set,

      • setThreadProperty

        public static void setThreadProperty​(CryptoServicesRegistrar.Property property,
                                     java.lang.Object[] propertyValue)
        Set the value of the the passed in property on the current thread only. More than one value can be passed in for a sized property. If more than one value is provided the first value in the argument list becomes the default value.
        Parameters:
        property - the name of the property to set.
        propertyValue - the values to assign to the property.
        the - base type of the property value.

      • setGlobalProperty

        public static void setGlobalProperty​(CryptoServicesRegistrar.Property property,
                                     java.lang.Object[] propertyValue)
        Set the value of the the passed in property globally in the JVM. More than one value can be passed in for a sized property. If more than one value is provided the first value in the argument list becomes the default value.
        Parameters:
        property - the name of the property to set.
        propertyValue - the values to assign to the property.
        the - base type of the property value.

      • clearGlobalProperty

        public static java.lang.Object[] clearGlobalProperty​(CryptoServicesRegistrar.Property property)
        Clear the global value for the passed in property.
        Parameters:
        property - the property to be cleared.
        the - base type of the property value
        Returns:
        an array of T if a value was previously set, null otherwise.

      • clearThreadProperty

        public static java.lang.Object[] clearThreadProperty​(CryptoServicesRegistrar.Property property)
        Clear the thread local value for the passed in property.
        Parameters:
        property - the property to be cleared.
        the - base type of the property value
        Returns:
        an array of T if a value was previously set, null otherwise.