SecureRandom (Платформа Java SE 7)

java.lang. Объект
- java.util. Случайный
- - java.security. SecureRandom

Все Реализованные Интерфейсы:

Сериализуемый
```
public class SecureRandom
extends Random
```
Этот класс обеспечивает криптографически сильный генератор случайных чисел (RNG).
Криптографически сильное случайное число минимально выполняет статистические тесты генератора случайных чисел, определенные в FIPS 140-2, Требованиях к защите для Криптографических Модулей, разделите 4.9.1. Дополнительно, SecureRandom должен произвести недетерминированный вывод. Поэтому любой материал семени, который передают к объекту SecureRandom, должен быть непредсказуемым, и все выходные последовательности SecureRandom должны быть криптографически сильными, как описано в RFC 1750: Рекомендации Случайности для Безопасности.
Вызывающая сторона получает экземпляр SecureRandom через конструктора без параметров или один из getInstance методы:
```
      SecureRandom random = new SecureRandom();
 
```
Много реализаций SecureRandom находятся в форме генератора псевдослучайного числа (PRNG), что означает, что они используют детерминированный алгоритм, чтобы произвести псевдослучайную последовательность из истинного случайного семени. Другие реализации могут произвести истинные случайные числа, и все же другие могут использовать комбинацию обоих методов.
Типичные вызывающие стороны SecureRandom вызывают следующие методы, чтобы получить случайные байты:
```
      SecureRandom random = new SecureRandom();
      byte bytes[] = new byte[20];
      random.nextBytes(bytes);
 
```
Вызывающие стороны могут также вызвать generateSeed метод, чтобы генерировать данное число байтов семени (чтобы отобрать другие генераторы случайных чисел, например):
```
      byte seed[] = random.generateSeed(20);
 
```
Отметьте: В зависимости от реализации, generateSeed и nextBytes методы могут блокировать, поскольку энтропия собирается, например, если они должны читать из/dev/random на различных подобных Unix операционных системах.
См. Также:
SecureRandomSpi, Random, Сериализированная Форма

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
	`SecureRandom()` Создает безопасный генератор случайных чисел (RNG) реализация алгоритма случайного числа по умолчанию.
	`SecureRandom(byte[] seed)` Создает безопасный генератор случайных чисел (RNG) реализация алгоритма случайного числа по умолчанию.
`protected`	`SecureRandom(SecureRandomSpi secureRandomSpi, Provider provider)` Создает объект SecureRandom.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`byte[]`	`generateSeed(int numBytes)` Возвращает данное число байтов семени, вычисленное использование алгоритма генерации семени что этот класс использование, чтобы отобрать себя.
`Строка`	`getAlgorithm()` Возвращает имя алгоритма, реализованного этим объектом SecureRandom.
`static SecureRandom`	`getInstance(String algorithm)` Возвращается SecureRandom возражают, что реализует указанный Генератор случайных чисел (RNG) алгоритм.
`static SecureRandom`	`getInstance(String algorithm, Provider provider)` Возвращается SecureRandom возражают, что реализует указанный Генератор случайных чисел (RNG) алгоритм.
`static SecureRandom`	`getInstance(String algorithm, String provider)` Возвращается SecureRandom возражают, что реализует указанный Генератор случайных чисел (RNG) алгоритм.
`Провайдер`	`getProvider()` Возвращает провайдера этого объекта SecureRandom.
`static byte[]`	`getSeed(int numBytes)` Возвращает данное число байтов семени, вычисленное использование алгоритма генерации семени что этот класс использование, чтобы отобрать себя.
`protected int`	`next(int numBits)` Генерирует целое число, содержащее пользовательское конкретное количество псевдослучайных битов (выровненный по правому краю, с начальными нулями).
`void`	`nextBytes(byte[] bytes)` Генерирует пользовательское конкретное количество случайных байтов.
`void`	`setSeed(byte[] seed)` Пересемена этот случайный объект.
`void`	`setSeed(long seed)` Пересемена этот случайный объект, используя восемь байтов содержатся в данном `long seed`.

Методы java.util унаследованный от класса. Случайный
nextBoolean, nextDouble, nextFloat, nextGaussian, nextInt, nextInt, nextLong

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - SecureRandom
```
public SecureRandom()
```
    Создает безопасный генератор случайных чисел (RNG) реализация алгоритма случайного числа по умолчанию.
    Этот конструктор пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект SecureRandom инкапсуляция реализации SecureRandomSpi от первого Провайдера, который поддерживает SecureRandom (RNG) алгоритм. Если ни один из Провайдеров не поддерживает алгоритм RNG, то специфичное для реализации значение по умолчанию возвращается.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    См. раздел SecureRandom в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма RNG.
    Возвращенный объект SecureRandom не был отобран. Чтобы отобрать возвращенный объект, вызовите setSeed метод. Если setSeed не вызывается, первый звонок nextBytes вызовет объект SecureRandom отобрать себя. Этот самоотбор не будет происходить если setSeed был ранее вызван.
  - SecureRandom
```
public SecureRandom(byte[] seed)
```
    Создает безопасный генератор случайных чисел (RNG) реализация алгоритма случайного числа по умолчанию. Экземпляр SecureRandom отбирается с указанными байтами семени.
    Этот конструктор пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект SecureRandom инкапсуляция реализации SecureRandomSpi от первого Провайдера, который поддерживает SecureRandom (RNG) алгоритм. Если ни один из Провайдеров не поддерживает алгоритм RNG, то специфичное для реализации значение по умолчанию возвращается.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    См. раздел SecureRandom в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма RNG.
    
    Параметры:
    seed - семя.
  - SecureRandom
```
protected SecureRandom(SecureRandomSpi secureRandomSpi,
            Provider provider)
```
    Создает объект SecureRandom.
    
    Параметры:
    secureRandomSpi - реализация SecureRandom.
    provider - провайдер.
- Деталь метода
  - getInstance
```
public static SecureRandom getInstance(String algorithm)
                                throws NoSuchAlgorithmException
```
    Возвращается SecureRandom возражают, что реализует указанный Генератор случайных чисел (RNG) алгоритм.
    Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект SecureRandom инкапсуляция реализации SecureRandomSpi от первого Провайдера, который поддерживает указанный алгоритм.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    Возвращенный объект SecureRandom не был отобран. Чтобы отобрать возвращенный объект, вызовите setSeed метод. Если setSeed не вызывается, первый звонок nextBytes вызовет объект SecureRandom отобрать себя. Этот самоотбор не будет происходить если setSeed был ранее вызван.
    
    Параметры:
    algorithm - имя алгоритма RNG. См. раздел SecureRandom в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма RNG.
    
    Возвраты:
    новый объект SecureRandom.
    
    Броски:
    
    NoSuchAlgorithmException - если никакой Провайдер не поддерживает реализацию SecureRandomSpi для указанного алгоритма.
    С тех пор:
    
    1.2
    
    См. Также:
    Provider
  - getInstance
```
public static SecureRandom getInstance(String algorithm,
                       String provider)
                                throws NoSuchAlgorithmException,
                                       NoSuchProviderException
```
    Возвращается SecureRandom возражают, что реализует указанный Генератор случайных чисел (RNG) алгоритм.
    Возвращается новый объект SecureRandom инкапсуляция реализации SecureRandomSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    Возвращенный объект SecureRandom не был отобран. Чтобы отобрать возвращенный объект, вызовите setSeed метод. Если setSeed не вызывается, первый звонок nextBytes вызовет объект SecureRandom отобрать себя. Этот самоотбор не будет происходить если setSeed был ранее вызван.
    
    Параметры:
    algorithm - имя алгоритма RNG. См. раздел SecureRandom в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма RNG.
    provider - имя провайдера.
    
    Возвраты:
    новый объект SecureRandom.
    
    Броски:
    
    NoSuchAlgorithmException - если реализация SecureRandomSpi для указанного алгоритма не доступна от указанного провайдера.
    
    NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.
    
    IllegalArgumentException - если имя провайдера является нулем или пустой.
    С тех пор:
    
    1.2
    
    См. Также:
    Provider
  - getInstance
```
public static SecureRandom getInstance(String algorithm,
                       Provider provider)
                                throws NoSuchAlgorithmException
```
    Возвращается SecureRandom возражают, что реализует указанный Генератор случайных чисел (RNG) алгоритм.
    Возвращается новый объект SecureRandom инкапсуляция реализации SecureRandomSpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.
    Возвращенный объект SecureRandom не был отобран. Чтобы отобрать возвращенный объект, вызовите setSeed метод. Если setSeed не вызывается, первый звонок nextBytes вызовет объект SecureRandom отобрать себя. Этот самоотбор не будет происходить если setSeed был ранее вызван.
    
    Параметры:
    algorithm - имя алгоритма RNG. См. раздел SecureRandom в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма RNG.
    provider - провайдер.
    
    Возвраты:
    новый объект SecureRandom.
    
    Броски:
    
    NoSuchAlgorithmException - если реализация SecureRandomSpi для указанного алгоритма не доступна от указанного объекта Провайдера.
    
    IllegalArgumentException - если указанный провайдер является нулем.
    С тех пор:
    
    1.4
    
    См. Также:
    Provider
  - getProvider
```
public final Provider getProvider()
```
    Возвращает провайдера этого объекта SecureRandom.
    
    Возвраты:
    провайдер этого объекта SecureRandom.
  - getAlgorithm
```
public String getAlgorithm()
```
    Возвращает имя алгоритма, реализованного этим объектом SecureRandom.
    
    Возвраты:
    имя алгоритма или unknown если имя алгоритма не может быть определено.
    С тех пор:
    
    1.5
  - setSeed
```
public void setSeed(byte[] seed)
```
    Пересемена этот случайный объект. Данные дополнения семени, а не замены, существующее семя. Таким образом повторные вызовы, как гарантируют, никогда не не уменьшат случайность.
    
    Параметры:
    seed - семя.
    См. Также:
    getSeed(int)
  - setSeed
```
public void setSeed(long seed)
```
    Пересемена этот случайный объект, используя восемь байтов содержатся в данном long seed. Данные дополнения семени, а не замены, существующее семя. Таким образом повторные вызовы, как гарантируют, никогда не не уменьшат случайность.
    Этот метод определяется для совместимости с java.util.Random.
    
    Переопределения:
    
    setSeed в классе Random
    
    Параметры:
    seed - семя.
    См. Также:
    getSeed(int)
  - nextBytes
```
public void nextBytes(byte[] bytes)
```
    Генерирует пользовательское конкретное количество случайных байтов.
    Если звонок setSeed не произошел ранее, первый звонок в этот метод вызывает этот объект SecureRandom отобрать себя. Этот самоотбор не будет происходить если setSeed был ранее вызван.
    
    Переопределения:
    
    nextBytes в классе Random
    
    Параметры:
    bytes - массив, чтобы быть заполненным в случайными байтами.
  - затем
```
protected final int next(int numBits)
```
    Генерирует целое число, содержащее пользовательское конкретное количество псевдослучайных битов (выровненный по правому краю, с начальными нулями). Этот метод переопределяет a java.util.Random метод, и подачи, чтобы обеспечить источник случайных битов ко всем методам, наследованным от того класса (например, nextInt, nextLong, и nextFloat).
    
    Переопределения:
    
    next в классе Random
    
    Параметры:
    numBits - число псевдослучайных битов, которые будут сгенерированы, где 0 <= numBits <= 32.
    
    Возвраты:
    int содержа пользовательское конкретное количество псевдослучайных битов (выровненный по правому краю, с начальными нулями).
  - getSeed
```
public static byte[] getSeed(int numBytes)
```
    Возвращает данное число байтов семени, вычисленное использование алгоритма генерации семени что этот класс использование, чтобы отобрать себя. Этот вызов может использоваться, чтобы отобрать другие генераторы случайных чисел.
    Этот метод только включается для назад совместимости. Вызывающая сторона поощряется использовать одну из альтернативы getInstance методы, чтобы получить объект SecureRandom, и затем вызвать generateSeed метод, чтобы получить байты семени из того объекта.
    
    Параметры:
    numBytes - число байтов семени, чтобы генерировать.
    
    Возвраты:
    байты семени.
    См. Также:
    setSeed(byte[])
  - generateSeed
```
public byte[] generateSeed(int numBytes)
```
    Возвращает данное число байтов семени, вычисленное использование алгоритма генерации семени что этот класс использование, чтобы отобрать себя. Этот вызов может использоваться, чтобы отобрать другие генераторы случайных чисел.
    
    Параметры:
    numBytes - число байтов семени, чтобы генерировать.
    
    Возвраты:
    байты семени.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс SecureRandom

Сводка конструктора

Сводка метода

Методы java.util унаследованный от класса. Случайный

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

SecureRandom

SecureRandom

SecureRandom

Деталь метода

getInstance

getInstance

getInstance

getProvider

getAlgorithm

setSeed

setSeed

nextBytes

затем

getSeed

generateSeed