java.security
클래스 SecureRandom

java.lang.Object 
  java.util.Random 
      java.security.SecureRandom

모든 구현된 인터페이스:

Serializable

public class SecureRandom
extends Random 

이 클래스는 암호용으로 강화된 난수 제네레이터 (RNG)를 제공합니다. 많은 구현은 사 난수 제네레이터 (PRNG)의 형식입니다. 이것은 특정의 결정성 알고리즘을 사용해 진정한 난수 배정으로부터 사 난수 순서를 생성하는 것을의미합니다. 구현안에는 진정한 난수를 생성하는 것도 있으면, 양쪽 모두의 기술의 편성을 사용하는 것도 있습니다.

암호용으로 강화된 유사 난수 제네레이터는 「FIPS 140-2, Security Requirements for Cryptographic Modules」 섹션 4.9. 1 으로 가리키는 통계적 난수 제네레이터의 테스트에 최저한 적합하고 있습니다. 또, SecureRandom 에서는 결정성이 아닌 출력을 생성하지 않으면 안되어, 그 때문에 배정 소재는 예측 불가능해, SecureRandom 출력은 「RFC 1750: Randomness Recommendations for Security」 로 기술되고 있다, 암호용으로 강화된 순서일 필요가 있습니다.

Java Security API 알고리즘 베이스외의 클래스와 같이, SecureRandom 클래스는 구현에 존하지 않는 알고리즘을 제공합니다. 즉, 호출측 (어플리케이션의 코드)은 특정의 RNG 알고리즘을 요구하면, 그 알고리즘에 대응하는 SecureRandom 객체를 받을 수가 있습니다. 필요하면, 특정의 프로바이더로부터의 특정의 알고리즘을 요구하는 일도 가능합니다. 자세한 내용은 getInstance 메서드를 참조하십시오.

SecureRandom 객체를 요구하려면 2개의 방법이 있습니다. 1개는 알고리즘의 이름만을 지정하는 방법, 이제(이미 ) 1개는 알고리즘의 이름과 패키지 프로바이더를 지정하는 방법입니다.

• 다음과 같이 알고리즘의 이름만이 가리키는 경우

  
        SecureRandom random = SecureRandom.getInstance("SHA1PRNG");
   

  시스템은 요구된 알고리즘에 대해서 환경안에 사용 가능한 구현이 있을지 어떨지를 판단합니다. 또, 다수 있는 경우에는 우선 순위의 높은 것이 있을지 어떨지도 판단합니다.

• 다음과 같이 알고리즘의 이름과 패키지 프로바이더의 양쪽 모두가 가리키는 경우

  
        SecureRandom random = SecureRandom.getInstance("SHA1PRNG", "SUN");
   

  시스템은 요구된 패키지에 알고리즘의 구현이 있을지 어떨지를 판단해, 구현이 없는 경우는 예외를 Throw 합니다.

호출측이, 다음에 나타내도록 getInstance 메서드의 호출의 곧 나중에 setSeed 메서드를 호출하는 경우를 제외해, SecureRandom 구현은 제네레이터의 내부 상태를 완전하게 랜덤으로 하려고 시도합니다.

      SecureRandom random = SecureRandom.getInstance("SHA1PRNG");
      random.setSeed(seed);
 

호출측은, getInstance 호출에 의해 SecureRandom를 취득한 뒤, nextBytes를 호출해 난수 바이트를 생성할 수 있습니다.

      byte bytes[] = new byte[20];
      random.nextBytes(bytes);
 

호출측은 다음의 예의 같게 generateSeed 메서드를 호출해, 지정된 수의 배정 바이트를 생성할 수도 있습니다. 생성한 배정 바이트는 다른 난수 제네레이터를 배정 하는 등을 위해서 사용합니다.

      byte seed[] = random.generateSeed(20);
 

관련 항목:

SecureRandomSpi, Random, 직렬화 된 형식

생성자 개요

	SecureRandom () 이 생성자를 사용하면, 호출측은 구현된 SecureRandom를 가지고 있는 인스톨 끝난 그 중에서 가장 우선도의 높은 프로바이더로부터, SecureRandom 객체와 그 구현 코드를 취득할 수 있습니다.
	SecureRandom (byte[] seed) 이 생성자를 사용하면, 호출측은 구현된 SecureRandom를 가지고 있는 인스톨 끝난 그 중에서와 도 우선도의 높은 프로바이더로부터, SecureRandom 객체와 그 구현 코드를 취득할 수 있습니다.
protected	SecureRandom (SecureRandomSpi secureRandomSpi, Provider provider) SecureRandom 객체를 작성합니다.

메서드 개요

byte[]	generateSeed (int numBytes) 지정된 바이트수의 배정 바이트를 리턴합니다.
String	getAlgorithm () 이 SecureRandom 객체가 구현하고 있는 알고리즘의 이름을 리턴합니다.
static SecureRandom	getInstance (String algorithm) 지정된 난수 제네레이터 (RNG) 알고리즘을 구현한 SecureRandom 객체를 작성합니다.
static SecureRandom	getInstance (String algorithm, Provider provider) 지정된 RNG 알고리즘에 한 SecureRandom 객체를 작성합니다.
static SecureRandom	getInstance (String algorithm, String provider) 지정된 RNG 알고리즘에 대한 SecureRandom 객체를 작성합니다.
Provider	getProvider () 이 SecureRandom 객체의 프로바이더를 리턴합니다.
static byte[]	getSeed (int numBytes) 지정된 바이트수의 배정 바이트를 리턴합니다.
protected int	next (int numBits) 사용자가 지정한 수의 유사 난수 비트 (right justify, 제로 매입)를 포함한 정수를 생성합니다.
void	nextBytes (byte[] bytes) 사용자가 지정한 바이트수의 난수 바이트를 생성합니다.
void	setSeed (byte[] seed) 난수 객체를 재배정 합니다.
void	setSeed (long seed) 지정된 long seed에 포함되어 있는 8 바이트를 사용해, 이 난수 객체를 재배정 합니다.

클래스 java.util. Random 로부터 상속된 메서드

nextBoolean, nextDouble, nextFloat, nextGaussian, nextInt, nextInt, nextLong

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

SecureRandom

public SecureRandom()

이 생성자를 사용하면, 호출측은 구현된 SecureRandom를 가지고 있는 인스톨 끝난 그 중에서 가장 우선도의 높은 프로바이더로부터, SecureRandom 객체와 그 구현 코드를 취득할 수 있습니다.

이 SecureRandom 인스턴스는 배정 되지 않습니다. SecureRandom 객체를 배정 하려면, setSeed 메서드를 호출합니다. setSeed가 불려가 지 않았던 경우는 최초로 nextBytes 메서드를 호출했을 때에 SecureRandom 객체가 그것 자신을 배정 하는 것을 강제합니다.

이 생성자는 하위 호환을 위해서 제공되고 있습니다. 호출측으로부터는 대체의 getInstance 메서드 가운데 1개를 사용해 SecureRandom 객체를 얻는 것을 추천합니다.

SecureRandom

public SecureRandom(byte[] seed)

이 생성자를 사용하면, 호출측은 구현된 SecureRandom를 가지고 있는 인스톨 끝난 그 중에서와 도 우선도의 높은 프로바이더로부터, SecureRandom 객체와 그 구현 코드를 취득할 수 있습니다. 이 생성자는 인수 없음의 생성자 기술에 의해 참조되는 알고리즘의 자기 배정보다, 사용자에 게 제공된 배정을 우선해 사용합니다. 호출측이 하등의 물리 디바이스로부터의 고품질인 난수 바이트에 액세스 할 수 있는 경우는 인수 없음의 생성자 보다 이 생성자를 사용하는 것을 추천합니다.

이 생성자는 하위 호환을 위해서 제공되고 있습니다. 호출측으로부터는 대체의 getInstance 메서드 가운데 1개를 사용해 SecureRandom 객체를 취득한 곧 나중에 setSeed 메서드를 호출해 배정 하는 것을 추천합니다.

파라미터:

seed - 배정

SecureRandom

protected SecureRandom(SecureRandomSpi  secureRandomSpi,
                       Provider  provider)

SecureRandom 객체를 작성합니다.

파라미터:

secureRandomSpi - SecureRandom 구현

provider - 프로바이더

메서드의 상세

getInstance

public static SecureRandom  getInstance(String  algorithm)
                                throws NoSuchAlgorithmException 

지정된 난수 제네레이터 (RNG) 알고리즘을 구현한 SecureRandom 객체를 작성합니다. 요구된 알고리즘의 구현을 디폴트의 프로바이더 패키지가 제공하고 있는 경우는 그 구현을 포함한 SecureRandom 인스턴스를 리턴합니다. 디폴트의 패키지로 알고리즘을 이용할 수 없는 경우는 다른 패키지를 검색합니다.

리턴된 SecureRandom 인스턴스는 배정 되지 않습니다. SecureRandom 객체를 배정 하려면, setSeed 메서드를 호출합니다. setSeed가 불려가 지 않았던 경우는 최초로 nextBytes 메서드를 호출했을 때에 SecureRandom 객체가 그것 자신을 배정 하는 것을 강제합니다.

파라미터:

algorithm - RNG 알고리즘의 이름. RNG 알고리즘의 표준적인 이름에 대해서는 「Java 암호화 아키텍쳐 API 사양 및 레퍼런스」의 부록 A를 참조

반환값:

새로운 SecureRandom 객체

예외:

NoSuchAlgorithmException - RNG 알고리즘이 호출해 옆의 환경에서 사용 가능하지 않은 경우

도입된 버전 :

1.2

getInstance

public static SecureRandom  getInstance(String  algorithm,
                                       String  provider)
                                throws NoSuchAlgorithmException,

                                       NoSuchProviderException 

지정된 RNG 알고리즘에 대한 SecureRandom 객체를 작성합니다. 지정된 프로바이더로 RNG 구현을 이용할 수 있는 경우는 그 프로바이더의 구현에 의해 제공된 RNG 알고리즘이 사용됩니다.

리턴된 SecureRandom 인스턴스는 배정 되지 않습니다. SecureRandom 객체를 배정 하려면, setSeed 메서드를 호출합니다. setSeed가 불려가 지 않았던 경우는 최초로 nextBytes 메서드를 호출했을 때에 SecureRandom 객체가 그것 자신을 배정 하는 것을 강제합니다.

파라미터:

algorithm - RNG 알고리즘의 이름. RNG 알고리즘의 표준적인 이름에 대해서는 「Java 암호화 아키텍쳐 API 사양 및 레퍼런스」의 부록 A를 참조

provider - 프로바이더명

반환값:

새로운 SecureRandom 객체

예외:

NoSuchAlgorithmException - 요구된 RNG 구현이 프로바이더로부터 이용할 수 없는 경우

NoSuchProviderException - 프로바이더가 설정되어 있지 않은 경우

IllegalArgumentException - 프로바이더의 이름이 null 나 비어있는 경우

도입된 버전 :

1.2

관련 항목:

Provider

getInstance

public static SecureRandom  getInstance(String  algorithm,
                                       Provider  provider)
                                throws NoSuchAlgorithmException 

지정된 RNG 알고리즘에 한 SecureRandom 객체를 작성합니다. 다만, 그러한 RNG 구현이 프로바이더로부터 사용 가능한 경우에 한정합니다. 주: provider를 등록할 필요는 없습니다.

리턴된 SecureRandom 인스턴스는 배정 되지 않습니다. SecureRandom 객체를 배정 하려면, setSeed 메서드를 호출합니다. setSeed가 불려가 지 않았던 경우는 최초로 nextBytes 메서드를 호출했을 때에 SecureRandom 객체가 그것 자신을 배정 하는 것을 강제합니다.

파라미터:

algorithm - RNG 알고리즘의 이름. RNG 알고리즘의 표준적인 이름에 대해서는 「Java 암호화 아키텍쳐 API 사양 및 레퍼런스」의 부록 A를 참조

provider - 프로바이더

반환값:

새로운 SecureRandom 객체

예외:

NoSuchAlgorithmException - 요구된 RNG 구현이 프로바이더로부터 이용할 수 없는 경우

IllegalArgumentException - provider가 null인 경우

도입된 버전 :

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에 포함되어 있는 8 바이트를 사용해, 이 난수 객체를 재배정 합니다. 지정된 배정은 기존의 배정을 옮겨놓는 것은 아니게 보충하는 것입니다. 따라서, 호출을 반복해도, 난수가 감소하지 않는 것이 보증되고 있습니다.

이 메서드는 java.util.Random와 의 호환성을 위해서 정의되고 있습니다.

오버라이드(override):

클래스 Random 내의 setSeed

파라미터:

seed - 배정

관련 항목:

getSeed(int)

nextBytes

public void nextBytes(byte[] bytes)

사용자가 지정한 바이트수의 난수 바이트를 생성합니다. 이 메서드는 이 클래스가 돌려주는 배정 바이트를 제외한 난수 엔티티의 모든 기준으로서 사용됩니다.

오버라이드(override):

클래스 Random 내의 nextBytes

파라미터:

bytes - 난수 바이트를 충전하는 배열

next

protected final int next(int numBits)

사용자가 지정한 수의 유사 난수 비트 (right justify, 제로 매입)를 포함한 정수를 생성합니다. 이 메서드는 java.util.Random 메서드를 오버라이드(override) 해, 그 클래스 (예를 들어, nextInt, nextLong 및 nextFloat)로부터 상속하는 메서드의 모두에게 난수 비트의 발생원을 제공하는데 도움이 됩니다.

오버라이드(override):

클래스 Random 내의 next

파라미터:

numBits - 0 <= numBits <= 32인 경우, 생성하는 유사 난수 비트의 수

반환값:

사용자 지정된 유사 난수 비트 (right justify, 제로 매입)를 포함한 int

getSeed

public static byte[] getSeed(int numBytes)

지정된 바이트수의 배정 바이트를 리턴합니다. 배정 바이트의 계산에는 이 클래스가 자신을 배정 하는데 사용하는 배정 생성 알고리즘이 사용됩니다. 이 호출을 사용하면, 다른 난수 제네레이터를 배정 할 수 있습니다.

이 메서드는 하위 호환 위해서만 제공되고 있습니다. 호출측으로부터는 대체의 getInstance 메서드 가운데 1개를 사용해 SecureRandom 객체를 취득한 곧 나중에 setSeed 메서드를 호출해 그 객체로부터 배정 바이트를 얻는 것을 추천합니다.

파라미터:

numBytes - 생성하는 배정 바이트수

반환값:

배정 바이트

관련 항목:

setSeed(byte[])

generateSeed

public byte[] generateSeed(int numBytes)

지정된 바이트수의 배정 바이트를 리턴합니다. 배정 바이트의 계산에는 이 클래스가 자신을 배정 하는데 사용하는 배정 생성 알고리즘이 사용됩니다. 이 호출을 사용하면, 다른 난수 제네레이터를 배정 할 수 있습니다.

파라미터:

numBytes - 생성하는 배정 바이트수

반환값:

배정 바이트