java.security
클래스 SecureRandom

java.lang.Object 
  |
  +--java.util.Random 
        |
        +--java.security.SecureRandom

모든 구현 인터페이스:

Serializable

public class SecureRandom

extends Random

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

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

SecureRandom 오브젝트를 요구하려면 2 개의 방법이 있습니다. 1 kr은 알고리즘의 이름만을 지정하는 방법, 이제(벌써) 1 kr은 알고리즘의 이름과 패키지 프로바이더를 지정하는 방법입니다.

• 다음과 같이 알고리즘의 이름만이 지정되고 있는 경우

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

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

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

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

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

호출측이, 다음에 나타내도록(듯이) 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 () 이 constructor를 사용하면(자), 호출측은 구현된 SecureRandom 를 가지고 있는 인스톨 끝난 그 중에서, 가장 우선도의 높은 프로바이더로부터, SecureRandom 오브젝트와 그 구현 코드를 취득할 수 있습니다.
	SecureRandom (byte[] seed) 이 constructor를 사용하면(자), 호출측은 구현된 SecureRandom 를 가지고 있는 인스톨 끝난 그 중에서 와도 우선도의 높은 프로바이더로부터, SecureRandom 오브젝트와 그 구현 코드를 취득할 수 있습니다.
protected	SecureRandom (SecureRandomSpi secureRandomSpi, Provider provider) SecureRandom 오브젝트를 작성합니다.

메소드의 개요

byte[]	generateSeed (int numBytes) 지정된 바이트수의 배정 바이트를 돌려줍니다.
static SecureRandom	getInstance (String algorithm) 지정된 유사 난수 제네레이터 (PRNG) 알고리즘을 구현하는 SecureRandom 오브젝트를 작성합니다.
static SecureRandom	getInstance (String algorithm, Provider provider) 지정된 PRNG 알고리즘에 의한 SecureRandom 오브젝트를 작성합니다.
static SecureRandom	getInstance (String algorithm, String provider) 지정된 PRNG 알고리즘에 대한 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()

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

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

이 constructor 은 하위 호환을 위해서(때문에) 제공되고 있습니다. 호출측으로부터는 대체의 getInstance 메소드 가운데 1 개를 사용해 SecureRandom 오브젝트를 취득하는 것을 추천합니다.

SecureRandom

public SecureRandom(byte[] seed)

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

이 constructor 은 하위 호환을 위해서(때문에) 제공되고 있습니다. 호출측으로부터는 대체의 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 

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

돌려주어진 SecureRandom 의 인스턴스는 배정 되고 있지 않습니다. SecureRandom 오브젝트를 배정 하려면 ,setSeed 메소드를 호출합니다. setSeed 가 불려 가지 않았던 경우는 최초로 nextBytes 메소드를 호출했을 때에, SecureRandom 오브젝트가 그것 자신을 배정 하는 것을 강제합니다.

파라미터:

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

반환값:

신규 SecureRandom 오브젝트

예외:

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

도입된 버젼:

1.2

getInstance

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

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

돌려주어진 SecureRandom 의 인스턴스는 배정 되고 있지 않습니다. SecureRandom 오브젝트를 배정 하려면 ,setSeed 메소드를 호출합니다. setSeed 가 불려 가지 않았던 경우는 최초로 nextBytes 메소드를 호출했을 때에, SecureRandom 오브젝트가 그것 자신을 배정 하는 것을 강제합니다.

파라미터:

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

provider - 프로바이더명

반환값:

신규 SecureRandom 오브젝트

예외:

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

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

IllegalArgumentException - 프로바이더의 이름이 null 나 비었을 경우

도입된 버젼:

1.2

관련 항목:

Provider

getInstance

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

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

돌려주어진 SecureRandom 의 인스턴스는 배정 되고 있지 않습니다. SecureRandom 오브젝트를 배정 하려면 ,setSeed 메소드를 호출합니다. setSeed 가 불려 가지 않았던 경우는 최초로 nextBytes 메소드를 호출했을 때에, SecureRandom 오브젝트가 그것 자신을 배정 하는 것을 강제합니다.

파라미터:

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

provider - 프로바이더

반환값:

신규 SecureRandom 오브젝트

예외:

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

IllegalArgumentException - provider 가 null 의 경우

도입된 버젼:

1.4

관련 항목:

Provider

getProvider

public final Provider  getProvider()

이 SecureRandom 오브젝트의 프로바이더를 돌려줍니다.

반환값:

이 SecureRandom 오브젝트의 프로바이더

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 - 생성하는 배정 바이트수

반환값:

배정 바이트