Java org.ietf.jgss 接口 GSSName（JDK5）

所有类

org.ietf.jgss
接口 GSSName

public interface GSSName

此接口将封装单一的 GSS-API 主体实体。应用程序将通过存在于GSSManager 类中的 createName 方法之一来获取此接口的实现。从概念上讲，GSSName 包含实体，或许多基本名称元素的表示形式，每个受支持的基础机制包含一个这样的表示形式。在 GSS 术语中，仅包含来自一种机制中的元素的 GSSName 称为机制名称 (MN)

由于不同的身份验证会使用不同的名称空间标识其主体，所以在多机制环境中 GSS-API 的命名支持有必要复杂一些（或者说，即使在某些基础机制要支持多名称空间的单一机制环境中也是如此）。不同的名称格式及其定义将使用 Oid's 来标识，而一些标准类型将在此接口中定义。名称的格式可以基于其名称类型惟一的 Oid 派生出来。

下面的代码中包含一些利用 GSSName 接口的代码示例。以下代码创建了一个 GSSName，然后将其转换为 MN，通过比较，获取该名称的可打印表示形式，将其导出到字节数组，然后再重新导入以获取一个新的 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)

NT_HOSTBASED_SERVICE

static final Oid NT_HOSTBASED_SERVICE

表示基于主机的服务名称格式的 Oid。用来表示与主计算机相关的服务。此名称格式由两种元素构成，即“服务”和“主机名称”，如下所示：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

名称类型，表示与本地系统上的用户对应的数值型用户标识符。（例如，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

名称类型，指示一个由数字组成的字符串，表示本地系统上用户的数值型用户标识符。

它表示以下 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

用来表示通过导出方法产生的导出名称的名称类型。

它表示以下 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

比较两个 GSSName 对象，以确定它们是否指的是同一个实体。

参数：

another - 将此名称与之比较的 GSSName

返回：

如果这两个名称至少包含一个共同的基本元素，则返回 true。如果这两个名称中的任一名称都表示匿名的实体，则该方法将返回 false。

抛出：

GSSException，当两个名称无法进行比较，包含以下主要错误代码时：{@link - GSSException#BAD_NAMETYPE GSSException.BAD_NAMETYPE}, GSSException.FAILURE

GSSException

equals

boolean equals(Object another)

将此 GSSName 对象与可能是 GSSName 的另一个对象进行比较。此行为与 equals 中的行为完全相同,除了没有 GSSException 抛出；而在出现错误时将返回 false。

覆盖：

类 Object 中的 equals

参数：

another - 将此名称与之进行比较的对象

返回：

如果将与之进行比较的对象也是 GSSName 并且两个名称都指的是同一个实体，则返回 true。

另请参见：

equals(GSSName)