org.ietf.jgss.GSSManager
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public abstract class GSSManager
이 클래스는 다른 중요한 GSS-API 클래스의 팩토리로서 기능해, 지원
되고 있는 도구에 관한 정보도 제공합니다. 또한, GSSName,
GSSCredential,
GSSContext 라고 하는 3개의 GSS-API 인터페이스를 구현하는 클래스의 인스턴스를 작성할 수 있습니다. 게다가 이용할 수 있는 도구
의 일람 및 각 도구가 지원
하고 있는 이름형을 조회하기 위한 메서드도 삽입되어
있습니다.
디폴트의 GSSManager 서브 클래스는 static 메서드 getInstance를
사용해 인스턴스화할 수 있습니다. 디폴트 이외의 GSSManager 서브 클래스는 어플리케이션으로부터 임의에 인스턴스화할 수 있습니다. 디폴트의 GSSManager인스턴스에서는 Kerberos v5 등, 모든 GSS-API 도구가 지원
됩니다. Kerberos v5 도구는 OID 「1.2. 840.113554. 1.2. 2」(으)로서 식별되어 RFC 1964에 정의되고 있습니다.
GSSManager 추상 클래스의 확장으로서 작성한 서브 클래스는 기존의 서비스 프로바이더 사양을 이용하는 모듈화된 프로바이더 베이스층으로서 구현됩니다. GSSManager API를 사용하면, 이러한 서브 클래스의 구현에 대해서 프로바이더의 우선 순위를 설정할 수 있습니다. 프로바이더 베이스의 구성이 지원
되어 있지 않은 경우는 명확하게 정의된 예외가 발생 됩니다. 어플리케이션을 이식할 가능성이 있는 경우는 이것을 인식해, 예외를 캐치 하는 것에의해 적절히 회복할 필요가 있습니다.
프로바이더의 사용 방법으로서 다음의 3개의 방법을 상정하고 있습니다.
GSSManager 클래스에는 이러한 사용 모드를 유효하게 하기 위해서
addProviderAtFront 메서드와 addProviderAtEnd 메서드의 2개가 준비되어 있습니다. 이러한 메서드를 실행하면, <프로바이더, OID> 라고 하는 페어의 순서 첨부 리스트가 작성됩니다. 각 페어는 특정의 OID에 우선적으로 사용되는 프로바이더를 나타내고 있습니다.
GSSManager에 의해 작성된 GSS-API 객체간으로는 대화를 합니다. 이 때, 특정의 도구에 사용되는 프로바이더를, 모든 객체로 사용해야 하는 것이 있습니다. 예를 들어
어느 GSSCredential 가 도구
m에 사용되는 프로바이더 p
자격 요소로 구성되어 있다고 합니다. 이 자격은 보통, 이 프로바이더 p를 사용하는 GSSContext에 건네줄 필요가 있습니다. 이식성을 최대화하려면,
다른 GSSManager 로 작성한 객체를 혼재시키지 않는 것을 추천합니다. 객체를 이미
작성한 GSSManager 상에서 addProviderAtFront 메서드를 호출하는 경우는 할 수 있는 한 다른 GSSManager 인스턴스를 작성해 주세요.
다음의 코드예는 GSSManager 사용 방법을 나타내고 있습니다.
GSSManager manager = GSSManager.getInstance();
Oid krb5Mechanism = new Oid("1.2. 840.113554. 1.2. 2");
Oid krb5PrincipalNameType = new Oid("1.2. 840.113554. 1.2. 2.1");
// Identify who the client wishes to be
GSSName userName = manager.createName("duke", GSSName.NT_USER_NAME);
// Identify the name of the server. This uses a Kerberos specific
// name format.
GSSName serverName = manager.createName("nfs/foo.sun.com",
krb5PrincipalNameType);
// Acquire credentials for the user
GSSCredential userCreds = manager.createCredential(userName,
GSSCredential.DEFAULT_LIFETIME,
krb5Mechanism,
GSSCredential.INITIATE_ONLY);
// Instantiate and initialize a security context that will be
// established with the server
GSSContext context = manager.createContext(serverName,
krb5Mechanism,
userCreds,
GSSContext.DEFAULT_LIFETIME);
서버측에서는 다음의 소스가 사용됩니다.
// Acquire credentials for the server
GSSCredential serverCreds = manager.createCredential(serverName,
GSSCredential.DEFAULT_LIFETIME,
krb5Mechanism,
GSSCredential.ACCEPT_ONLY);
// Instantiate and initialize a security context that will
// wait for an establishment request token from the client
GSSContext context = manager.createContext(serverCreds);
GSSName,
GSSCredential,
GSSContext | 생성자 개요 | |
|---|---|
GSSManager ()
|
|
| 메서드 개요 | |
|---|---|
abstract void |
addProviderAtEnd (Provider p,
Oid mech)
이 메서드를 사용해, 지정된 도구를 지원하는 프로바이더가 발견되지 않을 때에 사용하는 프로바이더를, GSSManager 로 설정합니다. |
abstract void |
addProviderAtFront (Provider p,
Oid mech)
이 메서드를 사용해, 지원가 필요한 도구에 대해서 특정의 프로바이더를 우선해 사용하는 것을 GSSManager 로 설정합니다. |
abstract GSSContext |
createContext (byte[] interProcessToken)
이전에 export 된 컨텍스트를 작성하기 위한 팩토리 메서드입니다. |
abstract GSSContext |
createContext (GSSCredential myCred)
받아 들이는 쪽으로 컨텍스트를 작성하기 위한 팩토리 메서드입니다. |
abstract GSSContext |
createContext (GSSName peer,
Oid mech,
GSSCredential myCred,
int lifetime)
시작측에서 컨텍스트를 작성하기 위한 팩토리 메서드입니다. |
abstract GSSCredential |
createCredential (GSSName name,
int lifetime,
Oid [] mechs,
int usage)
복수의 도구에 대해서 자격을 취득하기 위한 팩토리 메서드입니다. |
abstract GSSCredential |
createCredential (GSSName name,
int lifetime,
Oid mech,
int usage)
도구 의 자격을 1개 만 취득하기 위한 팩토리 메서드입니다. |
abstract GSSCredential |
createCredential (int usage)
디폴트의 자격을 취득하기 위한 팩토리 메서드입니다. |
abstract GSSName |
createName (byte[] name,
Oid nameType)
지정된 이름 공간의 byte 배열을 GSSName 객체로 변환하는 팩토리 메서드입니다. |
abstract GSSName |
createName (byte[] name,
Oid nameType,
Oid mech)
지정된 이름 공간의 이름을 포함한 byte 배열을 GSSName 객체로 변환해, 그것을 도구에 대해서 표준화 하는 팩토리 메서드입니다. |
abstract GSSName |
createName (String nameStr,
Oid nameType)
지정된 이름 공간의 캐릭터 라인명을 GSSName 객체로 변환하는 팩토리 메서드입니다. |
abstract GSSName |
createName (String nameStr,
Oid nameType,
Oid mech)
지정된 이름 공간의 캐릭터 라인명을 GSSName 객체로 변환해, 그것을 도구에 대해서 표준화 하는 팩토리 메서드입니다. |
static GSSManager |
getInstance ()
디폴트의 GSSManager 구현을 리턴합니다. |
abstract Oid [] |
getMechs ()
이 GSSManager를 통해 GSS-API 호출측을 이용할 수 있는 도구 의 리스트를 리턴합니다. |
abstract Oid [] |
getMechsForName (Oid nameType)
지정된 이름형을 지원 하고 있는 도구 의 리스트를 리턴합니다. |
abstract Oid [] |
getNamesForMech (Oid mech)
지정된 도구가 지원 하고 있는 이름형을 리턴합니다. |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
| 생성자 상세 |
|---|
public GSSManager()
| 메서드의 상세 |
|---|
public static GSSManager getInstance()
public abstract Oid [] getMechs()
getInstance() 메서드로부터 리턴된
디폴트의 GSSManager
리스트에는 OID 「1.2. 840.113554. 1.2. 2」가 포함되어 있습니다. 이 OID는
RFC 1964에 정의되고 있는 Kerberos v5 GSS-API 도구
의 식별 ID 입니다.
null값이
리턴된다
public abstract Oid [] getNamesForMech(Oid mech)
throws GSSException
디폴트의 GSSManager 인스턴스에서는 Kerberos v5 도구가 지원
됩니다. 이 도구
( 「1.2. 840.113554. 1.2. 2」)을 지정했을 경우는 적어도 GSSName.NT_HOSTBASED_SERVICE,
GSSName.NT_EXPORT_NAME 및 Kerberos v5 고유의 OID 「1.2. 840.113554. 1.2. 2.1」을 포함한 이름형 리스트가 리턴됩니다
. OID 「1.2. 840.113554. 1.2. 2.1」의 이름 공간은 RFC 1964 로 정의되고 있습니다.
mech - 조회하는 도구
의 OID
GSSException - 메이저 에러 코드 GSSException.BAD_MECH 및 GSSException.FAILURE를
포함한getMechsForName(Oid) public abstract Oid [] getMechsForName(Oid nameType)
지정된 이름형이 GSSName.NT_HOSTBASED_SERVICE,
GSSName.NT_EXPORT_NAME,
또는 「1.2. 840.113554. 1.2. 2.1」의 몇개의 경우, 이 리스트에는 항상 Kerberos v5 도구
( 「1.2. 840.113554. 1.2. 2」)이 포함됩니다.
nameType - 검색 대상의 이름형의 OID
null이 리턴된
getNamesForMech(Oid)
public abstract GSSName createName(String nameStr,
Oid nameType)
throws GSSException
GSSName 객체에는 보통, 복수의 이름 표현 (지원
되고 있는 도구
마다 1개
씩)이 포함되어 있습니다. 다만, 이름 공간의 형태 파라미터에 NT_EXPORT_NAME가 지정되고 있을 때, 또는 이 GSS-API 구현이 복수 도구가 아닌 경우 등은 예외입니다. 이 메서드는 NT_EXPORT_NAME 형에는 사용하지 말아 주세요. 이전에 export 된 이름이 임의의 바이트로 구성되는 경우, 그 이름을 String 로서 표현하면, 문자 인코딩 방식의 문제가 발생하는 것이 있기 때문에입니다. 이러한 이름을 변환하는 경우는 이 메서드를 overload 한 createName에 그러한 바이트를 직접 건네주는 것을 추천합니다.
nameStr - 작성하는 이름의 프린트 가능 형식을 나타내는 캐릭터 라인nameType - 지정된 프린트 가능명의 이름 공간을 지정하는 OID. nameStr를 검사할 경우에
각 도구
고유의 디폴트의 프린트 가능 구문을 사용하는 경우는 null을
지정한다. 이름형 NT_EXPORT_NAME는 가능한 한 사용하지 않는다
GSSException - 메이저 에러 코드 GSSException.BAD_NAMETYPE,
GSSException.BAD_NAME,
GSSException.BAD_MECH,
GSSException.FAILURE를
포함한GSSName,
GSSName.NT_EXPORT_NAME
public abstract GSSName createName(byte[] name,
Oid nameType)
throws GSSException
GSSName 객체에는 보통, 복수의 이름 표현 (지원
되고 있는 도구
마다 1개
씩)이 포함되어 있습니다. 다만, 이름 공간의 형태 파라미터에 NT_EXPORT_NAME가 지정되고 있을 때, 또는 이 GSS-API 구현이 복수 도구가 아닌 경우 등은 예외입니다. 건네받는 바이트는 지정된 이름형에 선택되고 있는 인코딩 방식으로 응해, 부하의 각 도구에 의해 해석됩니다.
name - 작성하는 이름을 포함한 byte 배열nameType - byte 배열로 지정된 이름의 이름 공간을 나타내는 OID. byte 배열을 검사할 경우에
각 도구
고유의 디폴트의 구문이 사용하는 경우는 null을
지정한다
GSSException - 메이저 에러 코드 GSSException.BAD_NAMETYPE,
GSSException.BAD_NAME,
GSSException.BAD_MECH,
GSSException.FAILURE를
포함한GSSName,
GSSName.NT_EXPORT_NAME
public abstract GSSName createName(String nameStr,
Oid nameType,
Oid mech)
throws GSSException
createName 메서드를 호출하고 나서 GSSName.canonicalize 메서드를 호출하는 경우와 같은 처리를 실행하는 유틸리티입니다.
nameStr - 작성하는 이름의 프린트 가능 형식을 나타내는 캐릭터 라인nameType - 지정된 프린트 가능명의 이름 공간을 지정하는 OID. nameStr를 검사할 경우에
각 도구
고유의 디폴트의 프린트 가능 구문을 사용하는 경우는 null을
지정한다. 이름형 NT_EXPORT_NAME는 가능한 한 사용하지 않는mech - 도구를 나타내는 OID. 이 도구에 대해서 이름이 표준화 된다
GSSException - 메이저 에러 코드 GSSException.BAD_NAMETYPE,
GSSException.BAD_NAME,
GSSException.BAD_MECH,
GSSException.FAILURE를
포함한GSSName.canonicalize(Oid),
GSSName.NT_EXPORT_NAME
public abstract GSSName createName(byte[] name,
Oid nameType,
Oid mech)
throws GSSException
createName 메서드를 호출하고 나서 GSSName.canonicalize 메서드를 호출하는 경우와 같은 처리를 실행하는 유틸리티입니다.
name - 작성하는 이름을 포함한 byte 배열nameType - byte 배열로 지정된 이름의 이름 공간을 나타내는 OID. byte 배열을 검사할 경우에
각 도구
고유의 디폴트의 구문이 사용하는 경우는 null을
지정하는mech - 도구를 나타내는 OID. 이 도구에 대해서 이름이 표준화 된다
GSSException - 메이저 에러 코드 GSSException.BAD_NAMETYPE,
GSSException.BAD_NAME,
GSSException.BAD_MECH,
GSSException.FAILURE를
포함한GSSName.canonicalize(Oid),
GSSName.NT_EXPORT_NAME
public abstract GSSCredential createCredential(int usage)
throws GSSException
GSS-API
도구
프로바이더는 호출 측에 로컬 액세스 제어 정책를 적용하는 것으로써, 권한이 없는 호출측이 허가되어 있지 않은 자격을 얻는 것을 방지할 필요가 있습니다. 각 도구
프로바이더가 필요로 하는 접근 권한의 종류는 도구
마다 문서에 정리하고 있습니다. 접근 권한의 확인에 실패하면, 이 메서드로부터 SecurityException을 발생시킵니다.
usage - 이 자격 객체의 사용 목적. 이 파라미터의 값은, GSSCredential.INITIATE_AND_ACCEPT,
GSSCredential.ACCEPT_ONLY,
GSSCredential.INITIATE_ONLY
언젠가가 아니면 안된다
GSSException - 메이저 에러 코드 GSSException.BAD_MECH,
GSSException.BAD_NAMETYPE,
GSSException.BAD_NAME,
GSSException.CREDENTIALS_EXPIRED,
GSSException.NO_CRED,
GSSException.FAILURE를
포함한GSSCredential
public abstract GSSCredential createCredential(GSSName name,
int lifetime,
Oid mech,
int usage)
throws GSSException
GSS-API
도구
프로바이더는 호출 측에 로컬 액세스 제어 정책를 적용하는 것으로써, 권한이 없는 호출측이 허가되어 있지 않은 자격을 얻는 것을 방지할 필요가 있습니다. 각 도구
프로바이더가 필요로 하는 접근 권한의 종류는 도구
마다 문서에 정리하고 있습니다. 접근 권한의 확인에 실패하면, 이 메서드로부터 SecurityException을 발생시킵니다.
디폴트 이외의 lifetime 치는 부하의 도구
로 받아들일 수 없는 경우가 있습니다. 그 경우, 어플리케이션은 리턴된 자격에 대해서 getRemainingLifetime를
호출할 필요가 있습니다.
name - 이 자격을 얻는 주체의 이름. 디폴트의 주체를 지정하는 경우는 null을
사용하는lifetime - 자격의 나머지의 수명 (초단위). 자격의 수명을 설정 가능한 최대 기한으로 하는 것을 요구하려면,
GSSCredential.INDEFINITE_LIFETIME를
사용한다. 디폴트의 수명을 요구하려면,
GSSCredential.DEFAULT_LIFETIME를
사용하는mech - 목적의 도구
의 OID. 디폴트의 도구를 요구하는 경우는 (Oid) null 를 사용하는usage - 이 자격 객체의 사용 목적. 이 파라미터의 값은, GSSCredential.INITIATE_AND_ACCEPT,
GSSCredential.ACCEPT_ONLY,
GSSCredential.INITIATE_ONLY
언젠가가 아니면 안된다
GSSException - 메이저 에러 코드 GSSException.BAD_MECH,
GSSException.BAD_NAMETYPE,
GSSException.BAD_NAME,
GSSException.CREDENTIALS_EXPIRED,
GSSException.NO_CRED,
GSSException.FAILURE를
포함한GSSCredential
public abstract GSSCredential createCredential(GSSName name,
int lifetime,
Oid [] mechs,
int usage)
throws GSSException
GSSCredential.getMechs 메서드를 사용할 필요가 있습니다.
GSS-API
도구
프로바이더는 호출 측에 로컬 액세스 제어 정책를 적용하는 것으로써, 권한이 없는 호출측이 허가되어 있지 않은 자격을 얻는 것을 방지할 필요가 있습니다. 각 도구
프로바이더가 필요로 하는 접근 권한의 종류는 도구
마다 문서에 정리하고 있습니다. 접근 권한의 확인에 실패하면, 이 메서드로부터 SecurityException을 발생시킵니다.
디폴트 이외의 lifetime 치는 부하의 도구
로 받아들일 수 없는 경우가 있습니다. 그 경우, 어플리케이션은 리턴된 자격에 대해서 getRemainingLifetime를
호출할 필요가 있습니다.
name - 이 자격을 얻는 주체의 이름. 디폴트의 주체를 지정하는 경우는 null을
사용하는lifetime - 자격의 나머지의 수명 (초단위). 자격의 수명을 설정 가능한 최대 기한으로 하는 것을 요구하려면,
GSSCredential.INDEFINITE_LIFETIME를
사용한다. 디폴트의 수명을 요구하려면,
GSSCredential.DEFAULT_LIFETIME를
사용하는mechs - 이 자격을 얻는 도구를 나타내는 OID
배열. 시스템 고유의 디폴트의 도구를 요구하는 경우는 (Oid[]) null을
사용하는usage - 이 자격 객체의 사용 목적. 이 파라미터의 값은, GSSCredential.INITIATE_AND_ACCEPT,
GSSCredential.ACCEPT_ONLY,
GSSCredential.INITIATE_ONLY
언젠가가 아니면 안된다
GSSException - 메이저 에러 코드 GSSException.BAD_MECH,
GSSException.BAD_NAMETYPE,
GSSException.BAD_NAME,
GSSException.CREDENTIALS_EXPIRED,
GSSException.NO_CRED,
GSSException.FAILURE를
포함한GSSCredential
public abstract GSSContext createContext(GSSName peer,
Oid mech,
GSSCredential myCred,
int lifetime)
throws GSSException
SecurityException을 발생시킵니다.
디폴트 이외의 lifetime 치는 부하의 도구
로 받아들일 수 없는 경우가 있습니다. 그 경우, 어플리케이션은 리턴된 컨텍스트에 대해서 getLifetime를
호출할 필요가 있습니다.
peer - 타겟 피어의 이름mech - 목적의 도구
의 OID. 디폴트의 도구를 요구하는 경우는 null을
사용하는myCred - 시작측의 자격. 디폴트의 시작측 주체로서 기능시키는 경우는 null을
사용하는lifetime - 컨텍스트에 요구하는 수명 (초단위). 컨텍스트
의 수명을 설정 가능한 최대 기간으로 하는 것을 요구하는 경우는 GSSContext.INDEFINITE_LIFETIME를
사용한다. 디폴트의 수명을 요구하는 경우는 GSSContext.DEFAULT_LIFETIME를
사용한다
GSSException - 메이저 에러 코드 GSSException.NO_CRED,
GSSException.CREDENTIALS_EXPIRED,
GSSException.BAD_NAMETYPE,
GSSException.BAD_MECH,
GSSException.FAILURE를
포함한GSSContext
public abstract GSSContext createContext(GSSCredential myCred)
throws GSSException
SecurityException을 발생시킵니다.
myCred - 받아 들이는 쪽의 자격. 디폴트의 받아 들이는 쪽 주체로서 기능시키는 경우는 null을
사용한다
GSSException - 메이저 에러 코드 GSSException.NO_CRED,
GSSException.CREDENTIALS_EXPIRED,
GSSException.BAD_MECH,
GSSException.FAILURE를
포함한GSSContext
public abstract GSSContext createContext(byte[] interProcessToken)
throws GSSException
시큐러티 컨텍스트
의 프로세스간 전송을 구현이 지원하는 것은 필수가 아닙니다. 컨텍스트를 export 하기 전에 GSSContext.isTransferable를
호출하면, 컨텍스트를 전송 가능한가 어떤가를 알 수 있습니다. 컨텍스트
의 전송을 지원
하고 있지 않는 구현으로 이 메서드를 호출하면, 에러 코드 GSSException.UNAVAILABLE 가 설정된 GSSException가 발생 됩니다.
일부의 도구
프로바이더에서는 시큐러티 컨텍스트를 시작 또는 받아들이는 접근 권한이 호출해 측에 부여되고 있을 필요가 있습니다. 접근 권한의 확인에 실패했을 경우, 이 메서드로부터 SecurityException을 발생시킵니다.
interProcessToken - 이전에 export 메서드로부터 생성된 토큰
GSSException - 메이저 에러 코드 GSSException.NO_CONTEXT,
GSSException.DEFECTIVE_TOKEN,
GSSException.UNAVAILABLE,
GSSException.UNAUTHORIZED,
GSSException.FAILURE를
포함한GSSContext
public abstract void addProviderAtFront(Provider p,
Oid mech)
throws GSSException
Oid는 아니고 null 치를 사용했을 때는 사용하는 도구에 관계없이, 지정된 프로바이더가 우선해 사용됩니다. 지정된 프로바이더가 필요한 도구를 지원
하고 있지 않는 경우에만, 다른 프로바이더가 사용됩니다. 이 메서드를 반복해 호출해도, 이전의 설정은 보관 유지됩니다. 다만, 그러한 우선 순위가 낮아져, 작성된 프로바이더와 Oid
페어의 순서 첨부 리스트가 최우선 됩니다.
Oid에 null을
지정해 addProviderAtFront를 호출하면, GSSManager 인스턴스로 이 프로바이더로 설정된 이전의 우선 순위가 모두 삭제됩니다. Oid에 null 이외의 값을 지정해 addProviderAtFront을 호출하면, 이 도구와 이 프로바이더를 사용해 설정된 이전의 우선 순위가 모두 삭제됩니다.
GSSManager 구현이 플러그 인 가능한 프로바이더 아키텍쳐를 갖춘 SPI를 지원 하고 있지 않는 경우는 상태 코드 GSSException.UNAVAILABLE가 설정된 GSSException가 Throw 되어 이 조작을 이용할 수 없는 것이 나타납니다.
예를 들어 도구가 필요한 때는 프로바이더 A를 최초로 확인하도록 설정하려면, 다음의 호출을 실시합니다.
GSSManager mgr = GSSManager.getInstance();
// mgr may at this point have its own pre-configured list
// of provider preferences. The following will prepend to
// any such list:
mgr.addProviderAtFront(A, null);
이전으로 설정된 A를 확인하기 전에
OID가 m1 인 도구를 프로바이더 B 로부터 얻는인 경우는 다음의 호출을 실시합니다.
mgr.addProviderAtFront(B, m1);
GSSManager는
m1가 필요한 경우, 우선 B를 확인합니다. B가 m1를 지원
하고 있지 않는 경우는 다음에 A를 확인합니다. 도구
m2가 필요해, m2가 m1와
다른 경우는 B를 생략의해 직접 A를 확인합니다. 예를 들어 같은 GSSManager 인스턴스에 대해서 다음의 호출을 실시한다고 합니다.
mgr.addProviderAtFront(B, null)
페어 (B, m1)의 이전의 설정이 이 설정에 포함 되어, 삭제됩니다. 이 결과, 우선 순위의 리스트는 {(B, null), (A, null), ... //이전으로 설정된 리스트}가 됩니다. 다만, 다음의 호출에는 주의해 주세요.
mgr.addProviderAtFront(A, m3)
이 호출을 실행해도, 이전의 설정 (A, null)을 포함 하지 않고, 리스트는 {(A, m3), (B, null), (A, null), ...} (이)가 됩니다.
p - mech 로 지정한 도구
의 지원가 필요한 때에
사용하는 프로바이더의 인스턴스mech - 이 프로바이더가 설정되어 있는 도구
GSSException - 메이저 에러 코드 GSSException.UNAVAILABLE,
GSSException.FAILURE를
포함한다
public abstract void addProviderAtEnd(Provider p,
Oid mech)
throws GSSException
Oid는 아니고 null 값이 사용했을 때는 지정된 프로바이더가 모든 도구에 사용됩니다. 이 메서드를 반복해 호출해도, 이전의 설정은 보관 유지됩니다. 다만, 그러한 우선 순위는 새로운 설정보다 높아져, 작성된 프로바이더와 Oid
페어의 순서 첨부 리스트의 우선 순위가 가장 낮아집니다. 즉, 이 리스트가 사용되기 전에
우선 이전의 프로바이더 설정이 사용됩니다.
이전으로 설정한 기존의 우선 순위안에 여기서 설정하는 우선 순위와 경합 하는 것이 있는 경우, 이 요구는 무시됩니다.
GSSManager 구현이 플러그 인 가능한 프로바이더 아키텍쳐를 갖춘 SPI를 지원 하고 있지 않는 경우는 상태 코드 GSSException.UNAVAILABLE가 설정된 GSSException가 Throw 되어 이 조작을 이용할 수 없는 것이 나타납니다.
예를 들어 OID가 m1 인 도구가 필요한 때는 시스템의 디폴트 프로바이더를 최초로 확인해, m1가 지원 되어 있지 않을 때에만 프로바이더 A를 확인하는 경우는 다음의 호출을 실시합니다.
GSSManager mgr = GSSManager.getInstance();
mgr.addProviderAtEnd(A, m1);
설정한 프로바이더를 모두 확인하고 나서, 모든 도구에 대해 프로바이더 B를 확인하는 경우는 다음의 호출을 실시합니다.
mgr.addProviderAtEnd(B, null);
우선 순위의 리스트가{..., (A, m1), (B, null)}가 됩니다. 예를 들어 같은 GSSManager 인스턴스에 대해서 다음의 호출을 실시한다고 합니다.
mgr.addProviderAtEnd(B, m2)
페어 (B, null)의 이전의 설정이 이 설정을 포함 해, 이 요구는 무시됩니다. 기존의 페어 (A, m1) 또는 (B, null)에 대해서 요구했을 경우도 같은 결과가 됩니다. 다만, 다음의 호출에는 주의해 주세요.
mgr.addProviderAtEnd(A, null)
이 호출을 실행해도, 이전의 설정 (A, m1)에 의해 포함 되지 않고, 리스트는 {..., (A, m1), (B, null), (A, null)}가 됩니다.
p - mech 로 지정한 도구
의 지원가 필요한 때에
사용하는 프로바이더의 인스턴스mech - 이 프로바이더가 설정되어 있는 도구
GSSException - 메이저 에러 코드 GSSException.UNAVAILABLE,
GSSException.FAILURE를
포함한다
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.