org.ietf.jgss
인터페이스 GSSName

public interface GSSName

이 인터페이스는 단일의 GSS-API 주체 엔티티를 캡슐화합니다. 어플리케이션에서는 GSSManager 클래스에 포함되는 createName 메서드의 어느쪽이든을 사용해 이 인터페이스의 구현을 취득합니다. GSSName는 엔티티의 복수의 표현, 즉 복수의 원시적 이름 요소 (지원 되고 있는 부하의 도구 마다 1개 씩)로 구성됩니다. GSS 에서는 1개 만의 도구 의 요소를 포함한 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 객체를, GSSName 일지도 모르는 다른 객체와 비교합니다.
byte[]	export () 표준화 된 도구 명 (MN)을 연속하는 바이트 표현으로서 리턴합니다.
Oid	getStringNameType () 이 이름의 프린트 가능한 표현의 이름형을 리턴합니다.
int	hashCode () 이 GSSName 해시 코드값을 리턴합니다.
boolean	isAnonymous () 이 이름 객체가 익명의 엔티티를 나타내고 있는지 어떤지 테스트합니다.
boolean	isMN () 이 이름 객체가 도구 명 (MN)을 나타내고 있는지 어떤지 테스트합니다.
String	toString () GSSName 객체의 텍스트 표현을 리턴합니다.

필드의 상세

NT_HOSTBASED_SERVICE

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

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

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

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

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

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

boolean equals(GSSName  another)
               throws GSSException 

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

파라미터:

another - 이 이름과 비교하는 GSSName

반환값:

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

예외:

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

equals

boolean equals(Object  another)

이 GSSName 객체를, GSSName 일지도 모르는 다른 객체와 비교합니다. 이 메서드의 동작은 GSSException을 Throw 하지 않는 점을 제외해, equals 와 같습니다. 에러가 발생했을 경우는 false를 리턴합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

another - 이 이름과 비교하는 객체

반환값:

비교하는 객체가 GSSName로 2개의 이름이 같은 엔티티를 참조하고 있는 경우는 true

관련 항목:

equals(GSSName)

hashCode

int hashCode()

이 GSSName 해시 코드값을 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

hashCode 치

관련 항목:

Object.equals(java.lang.Object), Hashtable

canonicalize

GSSName  canonicalize(Oid  mech)
                     throws GSSException 

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

파라미터:

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

반환값:

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

예외:

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

export

byte[] export()
              throws GSSException 

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

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

export 된 이름을 재임포트 하려면, byte 배열의 팩토리 메서드 GSSManager.createName를 사용해, 이름형의 객체 식별자로서 NT_EXPORT_NAME를 지정합니다. 그 결과적으로 리턴된 GSSName 명도 MN 입니다.

반환값:

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

예외:

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

toString

String  toString()

GSSName 객체의 텍스트 표현을 리턴합니다. 프린트 된 이름의 형식 (리턴된 캐릭터 라인의 구문을 결정한다)을 꺼내는 경우는 getStringNameType 메서드를 사용합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

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

getStringNameType

Oid  getStringNameType()
                      throws GSSException 

이 이름의 프린트 가능한 표현의 이름형을 리턴합니다. _toString 메서드로부터는 이 이름형으로 리턴됩니다 .

반환값:

toString 메서드로부터 리턴된 이름의 이름 공간을 나타내는 OID

예외:

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

isAnonymous

boolean isAnonymous()

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

반환값:

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

isMN

boolean isMN()

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

반환값:

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