KerberosKey (Java Platform SE 8 )

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

Class KerberosKey

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

KerberosKey

KerberosKey

方法详细信息

getPrincipal

getVersionNumber

getKeyType

getAlgorithm

getFormat

getEncoded

destroy

isDestroyed

toString

hashCode

equals