org.ietf.jgss
인터페이스 GSSCredential

모든 슈퍼 인터페이스:

Cloneable

public interface GSSCredential

extends Cloneable

이 인터페이스에서는 엔티티의 GSS-API 자격을 캡슐화합니다. 자격에는 문맥의 작성에 필요한 모든 암호화 정보가 포함되어 있습니다. 이 인터페이스는 자격을 사용해, 자신이 표현하는 엔티티에 대신해, 문맥을 작성할 수 있습니다. 또, GSS-API 기구 고유의 다양한 자격 요소가 포함되어 있는 경우도 있습니다. 그러한 자격 요소에는 특정의 시큐러티 기구의 정보가 포함되어 있습니다만, 어느 요소도 같은 엔티티를 참조합니다. 자격은 문맥의 기동측 또는 받아 들이는 쪽, 혹은 그 양쪽 모두가 사용합니다.

자격은 GSSManager 클래스의 createCredential 메소드의 어느쪽이든을 사용해 인스턴스화 됩니다. GSS-API 의 자격을 작성했을 경우는 네트워크에 로그인했을 경우와 달리, 기존의 자격의 핸들을 취득하거나 새로운 자격이 작성 되거나 할 것은 없습니다. Java 2 플랫폼에서 기존의 자격을 취득하는 방법에 대해서는 각 패키지의자격의 취득에 관한 마디를 참조해 주세요. GSS-API 의 구현에서는 호출 측에 로컬 액세스 제어 폴리시를 적용해, 승인되어 있지 않은 호출측이 허가되어 있지 않은 자격을 취득할 수 없게 할 필요가 있습니다.

어플리케이션은 필요한 파라미터를 건네주는 자격 오브젝트를 작성합니다. 어플리케이션은 그 쿠에리 메소드를 사용해, 인스턴스화 된 자격 오브젝트 고유의 정보를 취득할 수 있습니다. 그 자격이 필요없게 되었을 때는 dispose 메소드를 호출해, 그 자격 오브젝트가 보관 유지하고 있는 리소스를 모두 해방해, 암호로 보호된 기밀 정보를 모두 파기할 필요가 있습니다.

다음의 코드예에서는 특정의 엔티티의 GSSCredential 구현을 작성해, 그 필드를 조회해, 불필요하게 되었을 때에 해방하고 있습니다.

GSSManager manager = GSSManager.getInstance();
// start by creating a name object for the entity
GSSName name = manager.createName("myusername", GSSName.NT_USER_NAME);
// now acquire credentials for the entity
GSSCredential cred = manager.createCredential(name,
GSSCredential.ACCEPT_ONLY);
// display credential information - name, remaining lifetime,
// and the mechanisms it has been acquired over
System.out.println(cred.getName(). toString());
System.out.println(cred.getRemainingLifetime());
Oid [] mechs = cred.getMechs();
if (mechs ! = null) {
for (int i = 0; i < mechs.length; i++)
System.out.println(mechs[i]. toString());
    }
// release system resources held by the credential
cred.dispose();

도입된 버젼:

1.4

관련 항목:

GSSManager.createCredential(int) , GSSManager.createCredential(GSSName, int, Oid, int) , GSSManager.createCredential(GSSName, int, Oid[], int) , dispose()

필드의 개요

static int	ACCEPT_ONLY 자격 사용 플래그.
static int	DEFAULT_LIFETIME 자격의 디폴트의 수명을 나타내는 수명 정수입니다.
static int	INDEFINITE_LIFETIME 자격의 수명이 무기한인 것을 나타내는 수명 정수입니다.
static int	INITIATE_AND_ACCEPT 자격 사용 플래그.
static int	INITIATE_ONLY 자격 사용 플래그.

메소드의 개요

void	add (GSSName name, int initLifetime, int acceptLifetime, Oid mech, int usage) GSS-API 기구 고유의 자격 요소를 기존의 자격에 추가합니다.
void	dispose () GSSCredential 오브젝트가 보유하고 있는 기밀 정보를 모두 해방합니다.
boolean	equals (Object another) 이 GSSCredential 가 지정된 오브젝트와 같은 엔티티를 표명할지 어떨지를 테스트합니다.
Oid []	getMechs () 이 자격이 서포트하고 있는 GSS-API 기구의 리스트를 돌려줍니다.
GSSName	getName () 자격이 표명하는 엔티티의 이름을 꺼냅니다.
GSSName	getName (Oid mech) 자격이 표명하는 엔티티의 GSS-API 기구명을 꺼냅니다.
int	getRemainingAcceptLifetime (Oid mech) 자격의 나머지의 수명 (초단위)으로 돌려줍니다.
int	getRemainingInitLifetime (Oid mech) 자격의 나머지의 수명 (초단위)으로 돌려줍니다.
int	getRemainingLifetime () 자격의 나머지의 수명 (초단위)으로 돌려줍니다.
int	getUsage () 자격 사용 모드를 돌려줍니다.
int	getUsage (Oid mech) 특정의 GSS-API 기구의 자격 사용 모드를 돌려줍니다.
int	hashCode () 이 GSSCredential 의 해시 코드치를 돌려줍니다.

필드의 상세

INITIATE_AND_ACCEPT

public static final int INITIATE_AND_ACCEPT

자격 사용 플래그. 문맥의 기동측 및 받아 들이는 쪽을 사용할 수 있게 요구합니다.

관련 항목:

정수 필드치

INITIATE_ONLY

public static final int INITIATE_ONLY

자격 사용 플래그. 문맥의 기동측만을 사용할 수 있게 요구합니다.

관련 항목:

정수 필드치

ACCEPT_ONLY

public static final int ACCEPT_ONLY

자격 사용 플래그. 문맥의 받아 들이는 쪽만을 사용할 수 있게 요구합니다.

관련 항목:

정수 필드치

DEFAULT_LIFETIME

public static final int DEFAULT_LIFETIME

자격의 디폴트의 수명을 나타내는 수명 정수입니다. 이 값은 0 으로 설정됩니다.

관련 항목:

정수 필드치

INDEFINITE_LIFETIME

public static final int INDEFINITE_LIFETIME

자격의 수명이 무기한인 것을 나타내는 수명 정수입니다. 이 값은 Java 의 최대 정수치 Integer.MAX_VALUE 로 설정할 필요가 있습니다.

관련 항목:

정수 필드치

메소드의 상세

dispose

public void dispose()
             throws GSSException 

GSSCredential 오브젝트가 보유하고 있는 기밀 정보를 모두 해방합니다. 어플리케이션에서는 자격이 불필요하게 되자 마자 이 메소드를 호출해, 기밀 정보가 보관 유지되고 있는 시간을 최소한으로 억제할 필요가 있습니다.

예외:

GSSException - 메이저 에러 코드 GSSException.FAILURE 를 포함한다

getName

public GSSName  getName()
                throws GSSException 

자격이 표명하는 엔티티의 이름을 꺼냅니다.

반환값:

엔티티를 나타내는 GSSName

예외:

GSSException - 메이저 에러 코드 GSSException.FAILURE 를 포함한다

getName

public GSSName  getName(Oid  mech)
                throws GSSException 

자격이 표명하는 엔티티의 GSS-API 기구명을 꺼냅니다. 이 메소드 호출은 다른 형식의 getName 에 의해 돌려주어진 값에 대해서,canonicalize 를 호출했을 경우와 등가입니다.

파라미터:

mech - 기구명을 요구하는 GSS-API 기구의 OID

반환값:

GSSName. 요구된 GSS-API 기구에 표준화 된 엔티티를 나타낸다

예외:

GSSException - 메이저 에러 코드 GSSException.BAD_MECH ,GSSException.FAILURE 를 포함한다

getRemainingLifetime

public int getRemainingLifetime()
                         throws GSSException 

자격의 나머지의 수명 (초단위)으로 돌려줍니다. 나머지의 수명은 부하의 GSS-API 기구에 고유의 모든 자격 요소간의 최소 수명이 됩니다.

반환값:

이 자격의 나머지의 수명의 최소치 (초단위). 반환값 INDEFINITE_LIFETIME 는 자격의 수명이 남아 있는 것을 나타내, 반환값 0 은 자격이 기한 마감이 되어 있는 것을 나타낸다

예외:

GSSException - 메이저 에러 코드 GSSException.FAILURE 를 포함한

관련 항목:

getRemainingInitLifetime(Oid) , getRemainingAcceptLifetime(Oid)

getRemainingInitLifetime

public int getRemainingInitLifetime(Oid  mech)
                             throws GSSException 

자격의 나머지의 수명 (초단위)으로 돌려줍니다. 이 기간은 지정된 GSS-API 기구를 사용해, 시큐러티 문맥을 기동할 수 있습니다. 이 메소드는 지정된 GSS-API 기구에 속하고 있는 기동측 자격 요소를 조회합니다.

파라미터:

mech - 조회하는 기동측 자격 요소가 속하고 있는 GSS-API 기구의 OID

반환값:

이 자격 요소의 나머지의 수명 (초단위). 반환값 INDEFINITE_LIFETIME 는 자격 요소의 수명이 남아 있는 것을 나타내, 반환값 0 은 자격 요소가 기한 마감이 되어 있는 것을 나타낸다

예외:

GSSException - 메이저 에러 코드 GSSException.BAD_MECH ,GSSException.FAILURE 를 포함한다

getRemainingAcceptLifetime

public int getRemainingAcceptLifetime(Oid  mech)
                               throws GSSException 

자격의 나머지의 수명 (초단위)으로 돌려줍니다. 이 기간은 지정된 GSS-API 기구를 사용해, 시큐러티 문맥을 받아들일 수가 있습니다. 이 메소드는 지정된 GSS-API 기구에 속하고 있는 받아 들이는 쪽 자격 요소를 조회합니다.

파라미터:

mech - 조회하는 받아 들이는 쪽 자격 요소가 속하고 있는 GSS-API 기구의 OID

반환값:

이 자격 요소의 나머지의 수명 (초단위). 반환값 INDEFINITE_LIFETIME 는 자격 요소의 수명이 남아 있는 것을 나타내, 반환값 0 은 자격 요소가 기한 마감이 되어 있는 것을 나타낸다

예외:

GSSException - 메이저 에러 코드 GSSException.BAD_MECH ,GSSException.FAILURE 를 포함한다

getUsage

public int getUsage()
             throws GSSException 

자격 사용 모드를 돌려줍니다. 즉, 시큐러티 문맥을, 이 자격을 사용해 기동하는지 받아들이는지를 돌려줍니다. 다만, 문맥의 기동 또는 받아들여에 사용하는 GSS-API 기구는 돌려주지 않습니다. 이 메소드를 호출한 후에, 디폴트의 GSS-API 기구가 선택되는 것을 전제로 하고 있습니다.

반환값:

반환값은 INITIATE_ONLY ,ACCEPT_ONLY ,INITIATE_AND_ACCEPT 의 언젠가

예외:

GSSException - 메이저 에러 코드 GSSException.FAILURE 를 포함한다

getUsage

public int getUsage(Oid  mech)
             throws GSSException 

특정의 GSS-API 기구의 자격 사용 모드를 돌려줍니다. 즉, 지정된 부하의 GSS-API 기구를 사용하는 시큐러티 문맥을, 이 자격을 사용해 기동하는지 받아들이는지를 돌려줍니다.

파라미터:

mech - 자격 사용 모드를 검사하는 GSS-API 기구의 OID

반환값:

반환값은 INITIATE_ONLY ,ACCEPT_ONLY ,INITIATE_AND_ACCEPT 의 언젠가

예외:

GSSException - 메이저 에러 코드 GSSException.BAD_MECH ,GSSException.FAILURE 를 포함한다

getMechs

public Oid [] getMechs()
               throws GSSException 

이 자격이 서포트하고 있는 GSS-API 기구의 리스트를 돌려줍니다. 다만, 문맥의 기동에 사용하는 자격과 받아들여에 사용하는 자격은 식별하지 않습니다. 사용 모드를 확인하려면 , 돌려주어진 OID 를 사용해, 어플리케이션으로부터 getUsage 메소드를 호출할 필요가 있습니다.

반환값:

서포트되고 있는 GSS-API 기구에 대응하는 OID 의 배열

예외:

GSSException - 메이저 에러 코드 GSSException.FAILURE 를 포함한다

add

public void add(GSSName  name,
                int initLifetime,
                int acceptLifetime,
                Oid  mech,
                int usage)
         throws GSSException 

GSS-API 기구 고유의 자격 요소를 기존의 자격에 추가합니다. 1 회의 호출로, 1 개의 GSS-API 기구의 자격을 작성할 수 있습니다.

이 routine는 문맥의 받아 들이는 쪽이, 다양한 시큐러티 기구와 클라이언트의 편성으로 받아 들이는 쪽 자격을 작성할 경우에 사용합니다.

이 routine를 사용하면(자), 새로운 자격 요소가 적절히 추가됩니다. 새로운 자격에 그 자격 요소를 추가하려면 , 우선 clone 를 호출해 이 자격의 카피를 취득해, 다음에 그 add 메소드를 호출합니다.

GSS-API 의 구현에서는 호출 측에 액세스 제어 폴리시를 적용해, 승인되어 있지 않은 호출측이 허가되어 있지 않은 자격을 취득할 수 없게 할 필요가 있습니다. 디폴트 이외의 initLifetime 치와 acceptLifetime 치는 부하의 GSS-API 기구에서는 받아들일 수 없습니다. 이 경우, 호출측은 이 자격에 대해서 getRemainingInitLifetime 및 getRemainingAcceptLifetime 를 호출할 필요가 있습니다.

파라미터:

name - 이 자격을 취득하는 주체의 이름. 디폴트의 주체를 지정하는 경우는 null 를 사용하는

initLifetime - 시큐러티 문맥의 기동측 자격 요소의 나머지의 수명 (초단위). 자격의 수명을 무기한으로 하는 것을 요구하는 경우는 GSSCredential.INDEFINITE_LIFETIME 를 사용한다. 디폴트의 수명을 요구하는 경우는 GSSCredential.DEFAULT_LIFETIME 를 사용하는

acceptLifetime - 시큐러티 문맥의 받아 들이는 쪽 자격 요소의 나머지의 수명 (초단위). 자격의 수명을 무기한으로 하는 것을 요구하는 경우는 GSSCredential.INDEFINITE_LIFETIME 를 사용한다. 디폴트의 수명을 요구하는 경우는 GSSCredential.DEFAULT_LIFETIME 를 사용하는

mech - 자격을 취득하는 GSS-API 기구

usage - 자격에 추가하는 자격 요소의 사용 모드. 이 파라미터의 값은 INITIATE_AND_ACCEPT ,ACCEPT_ONLY , 또는 INITIATE_ONLY 가 아니면 안된다

예외:

GSSException - 메이저 에러 코드 GSSException.DUPLICATE_ELEMENT ,GSSException.BAD_MECH ,GSSException.BAD_NAMETYPE ,GSSException.NO_CRED ,GSSException.CREDENTIALS_EXPIRED ,GSSException.FAILURE 를 포함한다

equals

public boolean equals(Object  another)

이 GSSCredential 가 지정된 오브젝트와 같은 엔티티를 표명할지 어떨지를 테스트합니다. 이것들 2 개의 자격은 같은 GSS-API 기구를 사용해 취득해, 같은 주체를 참조할 필요가 있습니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

another - 이 GSSCredential 와 비교하는 GSSCredential

반환값:

2 개의 GSSCredential 가 같은 엔티티를 표명하는 경우는 true, 그렇지 않은 경우는 false

hashCode

public int hashCode()

이 GSSCredential 의 해시 코드치를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

hashCode 치