org.ietf.jgss
인터페이스 GSSName

public interface GSSName

이 인터페이스에서는 단일의 GSS-API 주체 엔티티를 캡슐화합니다. 어플리케이션에서는 GSSManager 클래스에 포함되는 createName 메소드의 어느쪽이든을 사용해, 이 인터페이스의 구현을 취득합니다. GSSName 는 그 엔티티의 복수의 표현, 즉 복수의 기본 이름 요소 (서포트되고 있는 부하의 기구 마다 1 kr씩)로 구성됩니다. GSS 에서는 특정의 기구의 요소를 포함한 GSSName 를 기구명 (MN)이라고 부릅니다.

주체의 식별로 사용되는 네임 스페이스는 인증 기구 마다 다릅니다. 이 때문에, 복수 기구 환경에서는 GSS-API 의 네이밍 서포트가 복잡하게 됩니다. 또, 단일 기구 환경의 경우에서도, 부하의 기구가 복수의 네임 스페이스를 서포트하고 있을 때는 똑같이 복잡하게 됩니다. 이름의 형식과 그 정의는 Oid's 에 의해 식별됩니다. 일부의 표준형은 이 인터페이스에 정의되고 있습니다. 이름의 형식은 그 이름형의 일의의 Oid 에 근거해 파생합니다.

다음의 코드예에서는 GSSName 인터페이스를 사용하고 있습니다. 우선,GSSName 를 작성해, 그것을 MN 로 변환합니다. 다음에, 이름을 비교해, 그 이름의 프린트 가능한 표현을 취득합니다. 마지막으로, 그 이름을 byte 배열에 export 하고 나서 재임포트 해, 새로운 GSSName 를 취득합니다.

GSSManager manager = GSSManager.getInstance();
// create a host based service name
GSSName name = manager.createName("service@host",
GSSName.NT_HOSTBASED_SERVICE);
Oid krb5 = new Oid("1.2. 840.113554. 1.2. 2");
GSSName mechName = name.canonicalize(krb5);
   
// the above two steps are equivalent to the following
GSSName mechName = manager.createName("service@host",
GSSName.NT_HOSTBASED_SERVICE, krb5);
   
// perform name comparison
if (name.equals(mechName))
print("Names are equals. ");
   
// obtain textual representation of name and its printable
// name type
print(mechName.toString() +
mechName.getStringNameType(). toString());
   
// export and re-import the name
byte [] exportName = mechName.export();
   
// create a new name object from the exported buffer
GSSName newName = manager.createName(exportName,
GSSName.NT_EXPORT_NAME);
   

도입된 버젼:

1.4

관련 항목:

export() , equals(GSSName) , GSSManager.createName(String, Oid) , GSSManager.createName(String, Oid, Oid) , GSSManager.createName(byte[], Oid)

필드의 개요

static Oid	NT_ANONYMOUS 익명의 엔티티를 나타내는 이름형입니다.
static Oid	NT_EXPORT_NAME export 된 이름을 나타내는 이름형입니다.
static Oid	NT_HOSTBASED_SERVICE 호스트 베이스의 서비스의 이름형을 나타내는 OID 입니다.
static Oid	NT_MACHINE_UID_NAME 로컬 시스템상의 유저에게 대응하는 수치 유저 ID 를 나타내는 이름형입니다 (Uid 등).
static Oid	NT_STRING_UID_NAME 로컬 시스템상의 유저의 수치 유저 ID 를 나타내는 숫자의 캐릭터 라인을 나타내는 이름형입니다.
static Oid	NT_USER_NAME 로컬 시스템상의 특정의 유저를 나타내는 이름형입니다.

메소드의 개요

GSSName	canonicalize (Oid mech) 특정의 기구에 대해서 표준화 되는 이름을 작성합니다.
boolean	equals (GSSName another) 2 개의 GSSName 오브젝트를 비교해, 그것들이 같은 엔티티를 참조하고 있을지 어떨지를 검사합니다.
boolean	equals (Object another) 이 GSSName 오브젝트를 다른 오브젝트와 비교합니다.
byte[]	export () 표준화 된 기구명 (MN)을 연속하는 바이트 표현으로서 돌려줍니다.
Oid	getStringNameType () 이 이름의 프린트 가능한 표현의 이름형을 돌려줍니다.
int	hashCode () 이 GSSName 의 해시 코드치를 돌려줍니다.
boolean	isAnonymous () 이 이름 오브젝트가 익명의 엔티티를 나타내고 있는지 어떤지 테스트합니다.
boolean	isMN () 이 이름 오브젝트가 기구명 (MN)을 나타내고 있는지 어떤지 테스트합니다.
String	toString () GSSName 오브젝트의 텍스트 표현을 돌려줍니다.

필드의 상세

NT_HOSTBASED_SERVICE

public static final Oid  NT_HOSTBASED_SERVICE

호스트 베이스의 서비스의 이름형을 나타내는 OID 입니다. 이 이름형은 호스트 컴퓨터에 관련지을 수 있었던 서비스를 나타내기 위해서(때문에) 사용합니다. 이 이름형은 "service" 와 "hostname" 라고 하는 2 개의 요소로 작성해, service@hostname 의 형식이 됩니다.

이 이름형은 다음의 OID 치를 나타냅니다.
{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 2(gss-host-based-services) }

NT_USER_NAME

public static final Oid  NT_USER_NAME

로컬 시스템상의 특정의 유저를 나타내는 이름형입니다.

이 이름형은 다음의 OID 치를 나타냅니다.
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) user_name(1) }

NT_MACHINE_UID_NAME

public static final Oid  NT_MACHINE_UID_NAME

로컬 시스템상의 유저에게 대응하는 수치 유저 ID 를 나타내는 이름형입니다 (Uid 등).

이 이름형은 다음의 OID 치를 나타냅니다.
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) machine_uid_name(2) }

NT_STRING_UID_NAME

public static final Oid  NT_STRING_UID_NAME

로컬 시스템상의 유저의 수치 유저 ID 를 나타내는 숫자의 캐릭터 라인을 나타내는 이름형입니다.

이 이름형은 다음의 OID 치를 나타냅니다.
{ iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) string_uid_name(3) }

NT_ANONYMOUS

public static final Oid  NT_ANONYMOUS

익명의 엔티티를 나타내는 이름형입니다.

이 이름형은 다음의 OID 치를 나타냅니다.
{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 3(gss-anonymous-name) }

NT_EXPORT_NAME

public static final Oid  NT_EXPORT_NAME

export 된 이름을 나타내는 이름형입니다. export 메소드에 의해 생성됩니다.

이 이름형은 다음의 OID 치를 나타냅니다.
{ 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 4(gss-api-exported-name) }

메소드의 상세

equals

public boolean equals(GSSName  another)
               throws GSSException 

2 개의 GSSName 오브젝트를 비교해, 그것들이 같은 엔티티를 참조하고 있을지 어떨지를 검사합니다.

파라미터:

another - 이 이름과 비교하는 GSSName

반환값:

2 개의 이름에 같은 기본 요소가 1 개 이상 포함되어 있는 경우는 true. 어느 쪽인가의 이름이 익명의 엔티티를 나타내고 있는 경우는 false

예외:

GSSException - 이름을 비교할 수 없는 경우, 메이저 에러 코드 GSSException.BAD_NAMETYPE ,GSSException.FAILURE 를 포함한다

equals

public boolean equals(Object  another)

이 GSSName 오브젝트를 다른 오브젝트와 비교합니다. 비교하는 오브젝트는 GSSName 가 아니어도 괜찮습니다. 이 메소드는 GSSException 를 슬로우 하지 않는 점을 제외해,equals 와 같습니다. 에러가 발생했을 경우는 false 를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

another - 이 이름과 비교하는 오브젝트

반환값:

비교하는 오브젝트가 GSSName 로, 2 개의 이름이 같은 엔티티를 참조하고 있는 경우는 true

관련 항목:

equals(GSSName)

hashCode

public int hashCode()

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

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

hashCode 치

canonicalize

public GSSName  canonicalize(Oid  mech)
                     throws GSSException 

특정의 기구에 대해서 표준화 되는 이름을 작성합니다.

파라미터:

mech - 이 이름을 표준화 할 때의 기준으로 하는 기구의 OID

반환값:

특정의 기구에 표준화 된 이름을 나타내는 기본 요소만으로 구성되는 GSSName

예외:

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

export

public byte[] export()
              throws GSSException 

표준화 된 기구명 (MN)을 연속하는 바이트 표현으로서 돌려줍니다. 이 표현은 승인 기능이 이름을 바이트 단위에 직접 비교할 경우에 적합합니다. MN 가 아닌 이름의 경우는 NAME_NOT_MN 상태 코드가 설정된 GSSException 가 슬로우 되는 일이 있습니다. 예외가 슬로우 되지 않게 하려면 , 시스템 고유의 디폴트의 기구를 사용해 이름을 표준화 하고 나서, export 할 필요가 있습니다. export 된 이름 오브젝트는 헤더와 부속차로부터 구성됩니다. 헤더에는 이름을 인증한 기구를 식별하는 OID 가 포함됩니다. 부속차에는 이름 자체가 포함됩니다. 부속차의 구문은 각 기구의 사양에 의해 정의됩니다. 출력 버퍼의 헤더의 형식은 RFC 2743 으로 지정되고 있습니다.

export 된 이름은 큰 액세스 제어 리스트로 사용합니다. 액세스 제어 리스트가 큰 경우는 각 이름에 대해서 GSSName 오브젝트를 작성해, ACL 로부터 equals 메소드를 호출할 때의 오버헤드가 커지는 일이 있습니다.

export 된 이름을 재임포트 하려면 , byte 배열의 팩토리 메소드 GSSManager.createName 를 사용해, 이름형의 오브젝트 식별자로서 NT_EXPORT_NAME 를 지정합니다.

반환값:

export 된 이름을 포함한 byte[]. RFC 2743 에는 이 byte 배열에 사용하는 기구에 의존하지 않는 export 된 이름 오브젝트의 형식이 정의되고 있다

예외:

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

toString

public String  toString()

GSSName 오브젝트의 텍스트 표현을 돌려줍니다. 프린트 된 이름의 형식 (돌려주어지는 캐릭터 라인의 구문을 결정한다)을 꺼내는 경우는 getStringNameType 메소드를 사용합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

프린트 가능한 형식에서 이 이름을 표현하는 String

getStringNameType

public Oid  getStringNameType()
                      throws GSSException 

이 이름의 프린트 가능한 표현의 이름형을 돌려줍니다. toString 메소드로부터는 이 이름형으로 돌려주어집니다.

반환값:

toString 메소드로부터 돌려주어지는 이름의 네임 스페이스를 나타내는 OID

예외:

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

isAnonymous

public boolean isAnonymous()

이 이름 오브젝트가 익명의 엔티티를 나타내고 있는지 어떤지 테스트합니다.

반환값:

익명의 이름인 경우는 true, 그렇지 않은 경우는 false

isMN

public boolean isMN()

이 이름 오브젝트가 기구명 (MN)을 나타내고 있는지 어떤지 테스트합니다. MN 는 특정의 기구의 기본 이름 요소를 포함한 GSSName 입니다.

반환값:

MN 인 경우는 true, 그렇지 않은 경우는 false