|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
java.lang.Objectjava.security.cert.PKIXParameters
public class PKIXParameters
PKIX CertPathValidator
알고리즘의 입력으로 사용되는 파라미터입니다.
PKIX CertPathValidator
에서는 이러한 파라미터를 사용해, PKIX 증명서 패스 검사 알고리즘에 따라 CertPath
를 검사합니다.
PKIXParameters
객체를 인스턴스화하려면 , 어플리케이션으로 PKIX 증명서 패스 검사 알고리즘으로 정의되는 「가장 신뢰할 수 있는 CA」를 1 개 이상 지정하지 않으면 안됩니다. 무엇보다 신뢰할 수 있는 CA 는, 2 개의 생성자 의 어느 쪽인지를 사용해 지정됩니다. PKIXParameters(Set)
를 호출하는 경우는,TrustAnchor
객체의 Set
를 지정합니다. 각각의 TrustAnchor
객체에서는 가장 신뢰할 수 있는 CA 를 특정합니다. 대신에 PKIXParameters(KeyStore)
를 호출하는 경우는, 신뢰할 수 있는 증명서 엔트리가 포함되는 KeyStore
인스턴스를 지정합니다. 각각의 증명서 엔트리를 가장 신뢰할 수 있는 CA 가 됩니다.
PKIXParameters
객체가 작성되면(자), (예를 들어 setInitialPolicies
또는 setDate
를 호출해) 다른 파라미터를 지정해,PKIXParameters
가 검사 대상의 CertPath
와 함께 CertPathValidator.validate
에게 건네집니다.
설정되어 있지 않은 (또는 null
로 설정되어 있다) 파라미터는, 각각의 디폴트 값로 설정됩니다. date
파라미터의 디폴트 값는 null
로, 패스가 검증되었을 때의 현재 시각을 나타냅니다. 그 다른 파라미터의 디폴트 값는 거의 제약되지 않습니다.
병행 액세스
특별히 거절하지 않는 한, 이 클래스에서 정의되고 있는 메소드는 thread 세이프가 아닙니다. 단일의 객체에 병행 액세스 할 필요가 있는 복수 thread는, thread간에 동기를 잡아, 필요에 따라서 잠글 필요가 있습니다. 복수의 thread가 각각 개별의 객체를 처리하는 경우, 그러한 thread는 동기 할 필요는 없습니다.
CertPathValidator
생성자 의 개요 | |
---|---|
PKIXParameters (KeyStore keystore)
가장 신뢰할 수 있는 CA 세트를, 지정한 KeyStore 에 포함되는 신뢰할 수 있는 증명서 엔트리로부터 생성하는,PKIXParameters 의 인스턴스를 작성합니다. |
|
PKIXParameters (Set <TrustAnchor > trustAnchors)
가장 신뢰할 수 있는 CA 로부터 되는 지정한 Set 로,PKIXParameters 의 인스턴스를 작성합니다. |
메소드의 개요 | |
---|---|
void |
addCertPathChecker (PKIXCertPathChecker checker)
PKIXCertPathChecker 를 증명서 패스 checker의 리스트에 추가합니다. |
void |
addCertStore (CertStore store)
CertStore 를, 증명서와 CRL 를 찾아내기 위해서(때문에) 사용되는 CertStore 의 리스트의 마지막에 추가합니다. |
Object |
clone ()
PKIXParameters 객체의 복제를 작성합니다. |
List <PKIXCertPathChecker > |
getCertPathCheckers ()
증명서 패스 checker의 List 를 돌려줍니다. |
List <CertStore > |
getCertStores ()
증명서와 CRL 를 찾아내기 위해서(때문에) 사용되는 CertStore 의 불변인 List 를 돌려줍니다. |
Date |
getDate ()
증명서 패스의 타당성이 판단될 때 각을 돌려줍니다. |
Set <String > |
getInitialPolicies ()
어느 초기 정책도 증명서 패스 처리를 위해서(때문에) 증명서 사용자에게 있어 허용 할 수 있는 것 같은 초기 정책 식별자 (OID 캐릭터 라인)의 불변인 Set 를 돌려줍니다. |
boolean |
getPolicyQualifiersRejected ()
PolicyQualifiersRejected 플래그를 가져옵니다. |
String |
getSigProvider ()
서명 프로바이더의 이름을 돌려줍니다. |
CertSelector |
getTargetCertConstraints ()
타겟 증명서에 요구된 제약을 돌려줍니다. |
Set <TrustAnchor > |
getTrustAnchors ()
가장 신뢰할 수 있는 CA 의 불변인 Set 를 돌려줍니다. |
boolean |
isAnyPolicyInhibited ()
임의의 정책 OID 가 증명서에 포함될 때, 그 정책 OID 가 처리되어야할 것인가 어떤가를 체크합니다. |
boolean |
isExplicitPolicyRequired ()
명시적인 정책가 요구되고 있는지 어떤지를 체크합니다. |
boolean |
isPolicyMappingInhibited ()
정책 매핑이 억제되고 있는지 어떤지를 체크합니다. |
boolean |
isRevocationEnabled ()
RevocationEnabled 플래그를 체크합니다. |
void |
setAnyPolicyInhibited (boolean val)
임의의 정책 OID 가 증명서에 포함될 때, 그 정책 OID 가 처리되지 않으면 안 되는지 어떤지를 판단하는 상태를 설정합니다. |
void |
setCertPathCheckers (List <PKIXCertPathChecker > checkers)
추가의 증명서 패스 checker의 List 를 설정합니다. |
void |
setCertStores (List <CertStore > stores)
증명서와 CRL 를 찾아내기 위해서(때문에) 사용되는 CertStore 의 리스트를 설정합니다. |
void |
setDate (Date date)
증명서 패스의 타당성이 판단될 때 각을 설정합니다. |
void |
setExplicitPolicyRequired (boolean val)
ExplicitPolicyRequired 플래그를 설정합니다. |
void |
setInitialPolicies (Set <String > initialPolicies)
어느 초기 정책도 증명서 패스 처리를 위해서(때문에) 증명서 사용자에게 있어 허용 할 수 있는, 그러한 초기 정책 식별자 (OID 캐릭터 라인)의 불변인 Set 를 설정합니다. |
void |
setPolicyMappingInhibited (boolean val)
PolicyMappingInhibited 플래그를 설정합니다. |
void |
setPolicyQualifiersRejected (boolean qualifiersRejected)
PolicyQualifiersRejected 플래그를 설정합니다. |
void |
setRevocationEnabled (boolean val)
RevocationEnabled 플래그를 설정합니다. |
void |
setSigProvider (String sigProvider)
서명 프로바이더의 이름을 설정합니다. |
void |
setTargetCertConstraints (CertSelector selector)
타겟 증명서에 요구된 제약을 설정합니다. |
void |
setTrustAnchors (Set <TrustAnchor > trustAnchors)
가장 신뢰할 수 있는 CA 의 Set 를 설정합니다. |
String |
toString ()
파라미터를 설명하는 서식 첨부 캐릭터 라인을 돌려줍니다. |
클래스 java.lang. Object 로부터 상속된 메소드 |
---|
equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
생성자 의 상세 |
---|
public PKIXParameters(Set <TrustAnchor > trustAnchors) throws InvalidAlgorithmParameterException
Set
로,PKIXParameters
의 인스턴스를 작성합니다. 세트의 각 요소는 TrustAnchor
입니다.
이후의 변경으로부터 보호하기 위해서,Set
는 복제되고 있습니다.
trustAnchors
- TrustAnchor
의 Set
InvalidAlgorithmParameterException
- 지정되었다
Set
가 빈 상태(empty) (trustAnchors.isEmpty() == true)
인 경우
NullPointerException
- 지정된 Set
가 null
의 경우
ClassCastException
- Set
의 요소가 어느 것도 java.security.cert.TrustAnchor
형이 아닌 경우public PKIXParameters(KeyStore keystore) throws KeyStoreException , InvalidAlgorithmParameterException
KeyStore
에 포함되는 신뢰할 수 있는 증명서 엔트리로부터 생성하는,PKIXParameters
의 인스턴스를 작성합니다. 신뢰할 수 있는 X509Certificate
를 포함한 키스토어엔트리만이 대상이 되어, 그 이외의 증명서 타입은 모두 무시됩니다.
keystore
- 가장 신뢰할 수 있는 CA 세트가 생성되는 KeyStore
KeyStoreException
- 키스토어가 초기화되어 있지 않은 경우
InvalidAlgorithmParameterException
- 키스토어에 신뢰할 수 있는 증명서 엔트리가 1 개도 포함되지 않는 경우
NullPointerException
- 키스토어가 null
의 경우메소드의 상세 |
---|
public Set <TrustAnchor > getTrustAnchors()
Set
를 돌려줍니다.
TrustAnchor
의 불변의 Set
. null
는 되지 않는setTrustAnchors(java.util.Set)
public void setTrustAnchors(Set <TrustAnchor > trustAnchors) throws InvalidAlgorithmParameterException
Set
를 설정합니다.
이후의 변경으로부터 보호하기 위해서,Set
는 복제되고 있습니다.
trustAnchors
- TrustAnchor
의 Set
InvalidAlgorithmParameterException
- 지정되었다
Set
가 빈 상태(empty) (trustAnchors.isEmpty() == true)
인 경우
NullPointerException
- 지정된 Set
가 null
의 경우
ClassCastException
- 세트의 요소가 어느 것도 java.security.cert.TrustAnchor
형이 아닌 경우getTrustAnchors()
public Set <String > getInitialPolicies()
Set
를 돌려줍니다. 디폴트의 반환값은 빈 상태(empty)의 Set
로, 어느 정책도 허용 가능으로서 해석됩니다.
String
형식의 초기 정책 OID 의 불변의 Set
, 또는 빈 상태(empty)의 Set
(어느 정책도 허용 할 수 있는 것을 의미한다). null
를 돌려줄 것은 없는setInitialPolicies(java.util.Set)
public void setInitialPolicies(Set <String > initialPolicies)
Set
를 설정합니다. 디폴트에서는, 어느 정책도 (즉 모든 정책를) 허용 할 수 있기 (위해)때문에, 어느 정책도 허용 할 수 있도록(듯이) 하고 싶은 사용자는 이 메소드를 호출할 필요는 없습니다. 또는, 빈 상태(empty)의 Set
(또는 null
)로 호출할 수가 있습니다.
이후의 변경으로부터 보호하기 위해서,Set
는 복제되고 있습니다.
initialPolicies
- String
형식의 초기 정책 OID 의 Set
(또는 null
)
ClassCastException
- 세트의 요소가 어느 것도 String
형이 아닌 경우getInitialPolicies()
public void setCertStores(List <CertStore > stores)
CertStore
의 리스트를 설정합니다. 사용되는 CertStore
가 없는 경우에는,null
가 됩니다. 리스트중의 최초의 CertStore
는, 후속의 엔트리보다 우선됩니다.
이후의 변경으로부터 보호하기 위해서,List
는 복제되고 있습니다.
stores
- CertStore
의 List
, 또는 null
ClassCastException
- 리스트의 요소가 어느 것도 java.security.cert.CertStore
형이 아닌 경우getCertStores()
public void addCertStore(CertStore store)
CertStore
를, 증명서와 CRL 를 찾아내기 위해서(때문에) 사용되는 CertStore
의 리스트의 마지막에 추가합니다.
store
- 추가되는 CertStore
. null
의 경우, 스토어는 무시된다 (리스트에 추가되지 않는다)public List <CertStore > getCertStores()
CertStore
의 불변인 List
를 돌려줍니다.
CertStore
의 불변의 List
(빈 상태(empty)로는 되지만,null
는 되지 않는다)setCertStores(java.util.List)
public void setRevocationEnabled(boolean val)
PKIXParameters
객체가 작성되면(자), 이 플래그는 true 로 설정됩니다. 각 서비스 프로바이더에서는 PKIX 에 준거하기 위해서 취소해 체크를 지원할 필요가 있으므로, 이 설정은 취소를 체크하는 가장 일반적인 방법을 반영하고 있습니다. PKIX 서비스 프로바이더의 디폴트의 취소 체크 기구를 사용하는 것이 실제적이지 않을 때나, 대체의 취소 체크 기구가 대신을 할 때는 (addCertPathChecker
또는 setCertPathCheckers
메소드를 호출하는 것에 의해도), 고도의 어플리케이션으로 이 플래그를 false 로 설정할 필요가 있습니다.
val
- RevocationEnabled 플래그의 새로운 값public boolean isRevocationEnabled()
setRevocationEnabled
메소드를 참조해 주세요.
public void setExplicitPolicyRequired(boolean val)
val
- 명시적인 정책가 요구되고 있는 경우는 true
, 그렇지 않은 경우는 false
public boolean isExplicitPolicyRequired()
true
, 그렇지 않은 경우는 false
public void setPolicyMappingInhibited(boolean val)
val
- 정책 매핑이 억제되는 경우는 true
, 그렇지 않은 경우는 false
public boolean isPolicyMappingInhibited()
public void setAnyPolicyInhibited(boolean val)
isAnyPolicyInhibited()
는 false
를 돌려준다).
val
- 임의의 정책 OID 가 억제되는 경우는 true
, 그렇지 않은 경우는 false
public boolean isAnyPolicyInhibited()
true
, 그렇지 않은 경우는 false
public void setPolicyQualifiersRejected(boolean qualifiersRejected)
PKIXParameters
객체가 작성되면(자), 이 플래그는 true 로 설정됩니다. 이 설정은, 정책 수식자를 처리하기 위한 좀 더도 일반적인 (한편 간단한) 방법을 반영합니다. 보다 고도의 정책를 사용하는 어플리케이션에서는, 이 플래그를 false 로 설정하지 않으면 안됩니다.
PKIX 증명서 패스 검사 알고리즘에서는, 위기에 마크 된 증명서 정책 확장 기능의 정책 수식자가 반드시 처리되어 검사되도록(듯이) 지정합니다. 정책 수식자가 처리 및 검사되지 않으면 그 증명서 패스는 거부됩니다. policyQualifiersRejected 플래그가 false 로 설정되어 있는 경우, PKIX 호환을 위해서(때문에) 이 방법으로 모든 정책 수식자를 검사할지 어떨지는, 어플리케이션에 따라서 다릅니다.
qualifiersRejected
- PolicyQualifiersRejected 플래그의 새로운 값getPolicyQualifiersRejected()
,
PolicyQualifierInfo
public boolean getPolicyQualifiersRejected()
PKIXParameters
객체가 작성되면(자), 이 플래그는 true 로 설정됩니다. 이 설정은, 정책 수식자를 처리하기 위한 좀 더도 일반적인 (한편 간단한) 방법을 반영합니다. 보다 고도의 정책를 사용하는 어플리케이션에서는, 이 플래그를 false 로 설정하지 않으면 안됩니다.
setPolicyQualifiersRejected(boolean)
public Date getDate()
null
의 경우, 현재 시각이 사용됩니다.
이후의 변경으로부터 보호하기 위해서, 반환되는 Date
는 복제되고 있습니다.
Date
. 설정되어 있지 않은 경우는 null
setDate(java.util.Date)
public void setDate(Date date)
null
의 경우, 현재 시각이 사용됩니다.
이후의 변경으로부터 보호하기 위해서, 여기서 제공되는 Date
는 복제되고 있습니다.
date
- Date
. 현재 시각의 경우는 null
getDate()
public void setCertPathCheckers(List <PKIXCertPathChecker > checkers)
List
를 설정합니다. 지정한 List
에 PKIXCertPathChecker
가 아닌 객체가 포함되는 경우는 무시됩니다.
지정한 각 PKIXCertPathChecker
에서는, 증명서의 추가 체크를 구현하고 있습니다. 일반적으로, 증명서에 포함되어 있는 전용의 기능확장을, 처리 및 검사하고 있을지 어떨지를 체크합니다. 각각의 PKIXCertPathChecker
는, 체크를 실시하기 위해서(때문에) 필요한 초기화 파라미터로 인스턴스화 되지 않으면 안됩니다.
고도의 어플리케이션에서는, 이 메소드에 의해 PKIX CertPathValidator
나 CertPathBuilder
를 확장할 수 있습니다. 처리된, 또는 검사된 증명서에 대해, 지정한 PKIXCertPathChecker
가, PKIX CertPathValidator
나 CertPathBuilder
에 의해 각각 차례로 불려 갑니다.
이러한 추가 PKIXCertPathChecker
가 설정되어 있는지 어떤지에 관계없이, PKIX CertPathValidator
나 CertPathBuilder
에서는 요구된 각 증명서의 PKIX 체크를 모두 실행할 필요가 있습니다. 이 룰의 예외의 1 개에, RevocationEnabled 플래그가 false 로 설정되었을 경우가 있습니다 (setRevocationEnabled
메소드 참조).
이후의 변경으로부터 보호하기 위해서, 여기서 제공되는 List
와 리스트내의 각 PKIXCertPathChecker
는 복제되고 있습니다.
checkers
- PKIXCertPathChecker
의 List
.
null
의 경우, 추가의 checker는 사용되지 않는다
ClassCastException
- 리스트의 요소가 어느 것도 java.security.cert.PKIXCertPathChecker
형이 아닌 경우getCertPathCheckers()
public List <PKIXCertPathChecker > getCertPathCheckers()
List
를 돌려줍니다. 반환된 List
는 불변이며,List
내의 각 PKIXCertPathChecker
는 이후의 변경으로부터 보호하기 위해서 복제되고 있습니다.
PKIXCertPathChecker
의 불변의 List
(빈 상태(empty)로는 되지만,null
는 되지 않는다)setCertPathCheckers(java.util.List)
public void addCertPathChecker(PKIXCertPathChecker checker)
PKIXCertPathChecker
를 증명서 패스 checker의 리스트에 추가합니다. 상세한 것에 대하여는,setCertPathCheckers
를 참조해 주세요.
이후의 변경으로부터 보호하기 위해서,PKIXCertPathChecker
는 복제되고 있습니다.
checker
- 체크의 리스트에 추가되는 PKIXCertPathChecker
. null
의 경우, checker는 무시된다 (리스트에 추가되지 않는다)public String getSigProvider()
null
를 돌려줍니다.
null
setSigProvider(java.lang.String)
public void setSigProvider(String sigProvider)
Signature
객체를 작성할 경우에는, 지정한 프로바이더가 추천 됩니다. null
, 또는 설정되어 있지 않은 경우는, 알고리즘을 지원한다, 최초로 발견된 프로바이더가 사용됩니다.
sigProvider
- 서명 프로바이더의 이름, 또는 null
getSigProvider()
public CertSelector getTargetCertConstraints()
CertSelector
의 인스턴스로서 돌려주어집니다. null
의 경우는, 제약이 정의되고 있지 않습니다.
이후의 변경으로부터 보호하기 위해서, 반환되는 CertSelector
는 복제되고 있습니다.
CertSelector
, 또는 null
setTargetCertConstraints(java.security.cert.CertSelector)
public void setTargetCertConstraints(CertSelector selector)
CertSelector
의 인스턴스로서 지정됩니다. null
의 경우는, 제약이 정의되고 있지 않습니다.
이후의 변경으로부터 보호하기 위해서, 지정되는 CertSelector
는 복제되고 있습니다.
selector
- 타겟 증명서의 제약을 지정하는 CertSelector
, 또는 null
getTargetCertConstraints()
public Object clone()
PKIXParameters
객체의 복제를 작성합니다. 카피로 변경을 더해도 원의 속성에는 영향 없습니다. 또 역의 경우도 같습니다.
CertPathParameters
내의 clone
Object
내의 clone
PKIXParameters
객체의 복제Cloneable
public String toString()
Object
내의 toString
|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.