compact3

javax.security.auth.kerberos

Class KerberosKey

java.lang.Object

javax.security.auth.kerberos.KerberosKey

All Implemented Interfaces:

Serializable ， Key ， SecretKey ， Destroyable

public class KerberosKey
extends Object
implements SecretKey, Destroyable

该类封装了Kerberos主体的长期密钥。

获取主体密码并从中生成密钥的所有Kerberos JAAS登录模块都应该使用此类。 有时，例如在没有用户到用户认证的情况下认证服务器时，登录模块将在认证过程的提交阶段期间将该类的实例存储在Subject的私有证书集中。

使用密钥表读取密钥的Kerberos服务应使用KeyTab类，在需要时可以读取最新的密钥。

如果应用程序需要从主题访问KerberosKey实例，可能需要授予应用程序PrivateCredentialPermission 。 当应用程序依赖于默认的JGSS Kerberos机制来访问KerberosKey时，不需要此权限。 然而，在这种情况下，应用程序将需要适当的ServicePermission 。

从以下版本开始：

1.4

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
KerberosKey(KerberosPrincipal principal, byte[] keyBytes, int keyType, int versionNum) 当密钥类型和密钥版本号已知时，从给定字节构造KerberosKey。
KerberosKey(KerberosPrincipal principal, char[] password, String algorithm) 从主体的密码构造一个KerberosKey。

方法摘要

Modifier and Type	Method and Description
void	destroy() 破坏这个关键
boolean	equals(Object other) 将指定的对象与此KerberosKey进行比较以获得相等性。
String	getAlgorithm() 返回此键的标准算法名称。
byte[]	getEncoded() 返回此密钥的密钥材料。
String	getFormat() 返回此密钥的编码格式的名称。
int	getKeyType() 返回此长期密钥的密钥类型。
KerberosPrincipal	getPrincipal() 返回此密钥所属的主体。
int	getVersionNumber() 返回密钥版本号。
int	hashCode() 返回此KerberosKey的哈希码。
boolean	isDestroyed() 确定此密钥是否已被销毁。
String	toString() 返回对象的字符串表示形式。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

KerberosKey

public KerberosKey(KerberosPrincipal principal,
                   byte[] keyBytes,
                   int keyType,
                   int versionNum)

当密钥类型和密钥版本号已知时，从给定字节构造KerberosKey。 当从Kerberos“keytab”读取密钥信息时，可以使用它。

参数

principal - 该密钥属于的主体

keyBytes - 秘密密钥的原始字节

keyType - 由Kerberos协议规范定义的密钥的密钥类型。

versionNum - 此秘密密钥的版本号

KerberosKey

public KerberosKey(KerberosPrincipal principal,
                   char[] password,
                   String algorithm)

从主体的密码构造一个KerberosKey。

参数

principal - 该密码所属的主体

password - 用于计算密钥的密码

algorithm - 此密钥将被用于的算法的名称。 该参数可能为null，在这种情况下，将假定默认算法“DES”。

异常

IllegalArgumentException - 如果传递的算法的名称不受支持。

方法详细信息

getPrincipal

public final KerberosPrincipal getPrincipal()

返回此密钥所属的主体。

结果

这个钥匙所属的校长。

getVersionNumber

public final int getVersionNumber()

返回密钥版本号。

结果

关键版本号。

getKeyType

public final int getKeyType()

返回此长期密钥的密钥类型。

结果

关键类型。

getAlgorithm

public final String getAlgorithm()

返回此键的标准算法名称。 例如，“DES”将表示该密钥是DES密钥。 有关标准算法名称的信息，请参阅Java Cryptography Architecture API Specification & Reference中的附录A.

Specified by:

getAlgorithm在界面 Key

结果

与该密钥相关联的算法的名称。

getFormat

public final String getFormat()

返回此密钥的编码格式的名称。

Specified by:

getFormat在界面 Key

结果

字符串“RAW”

getEncoded

public final byte[] getEncoded()

返回此密钥的密钥材料。

Specified by:

getEncoded在界面 Key

结果

关键材料

destroy

public void destroy()
             throws DestroyFailedException

破坏这个关键 在此之后调用其他任何方法将导致抛出IllegalStateException。

Specified by:

destroy在界面 Destroyable

异常

DestroyFailedException - 如果在破坏此密钥时出现某些错误。

isDestroyed

public boolean isDestroyed()

确定此密钥是否已被销毁。

Specified by:

isDestroyed在界面 Destroyable

结果

如果这个 Object被销毁，则为true，否则为false。

toString

public String toString()

描述从类别： Object复制

返回对象的字符串表示形式。 一般来说， toString方法返回一个“textually代表”这个对象的字符串。 结果应该是一个简明扼要的表达，容易让人阅读。 建议所有子类覆盖此方法。

该toString类方法Object返回一个由其中的对象是一个实例，该符号字符`的类的名称的字符串@ ”和对象的哈希码的无符号的十六进制表示。 换句话说，这个方法返回一个等于下列值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

重写：

toString在类别 Object

结果

对象的字符串表示形式。

hashCode

public int hashCode()

返回此KerberosKey的哈希码。

重写：

hashCode在类别 Object

结果

一个hashCode（）为 KerberosKey

从以下版本开始：

1.6

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object other)

将指定的对象与此KerberosKey进行比较以获得相等性。 如果给定的对象也是KerberosKey ，并且两个KerberosKey实例是等价的，则返回true。

重写：

equals在类别 Object

参数

other - 要比较的对象

结果

如果指定的对象等于此KerberosKey，则为true，否则为false。 注意：如果任一KerberosKey对象已被销毁，则返回false。

从以下版本开始：

1.6

另请参见：

Object.hashCode() ， HashMap