モジュール java.security.jgss

パッケージ javax.security.auth.kerberos

クラスEncryptionKey

java.lang.Object

javax.security.auth.kerberos.EncryptionKey

すべての実装されたインタフェース:

Serializable, Key, SecretKey, Destroyable

public final class EncryptionKey extends Object implements SecretKey

このクラスは、Kerberosで使用されるEncryptionKeyをカプセル化します。

EncryptionKeyは、Kerberosプロトコル仕様(RFC 4120)のセクション4.2.9で次のように定義されます:

     EncryptionKey   ::= SEQUENCE {
             keytype         [0] Int32 -- actually encryption type --,
             keyvalue        [1] OCTET STRING
     }
 

EncryptionKeyのキー・マテリアルは、前述のkeyValueの値として定義されます。

導入されたバージョン:

9

関連項目:

• 直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
EncryptionKey(byte[] keyBytes, int keyType)	指定されたバイトおよびキー・タイプからEncryptionKeyを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	destroy()	このキーのキー・マテリアルをクリアして、このキーを破棄します。
boolean	equals(Object other)	指定されたオブジェクトをこのキーと比較し、等価にします。
String	getAlgorithm()	このキーに対する標準アルゴリズムを返します。
byte[]	getEncoded()	このキーのキー・マテリアルを返します。
String	getFormat()	このキーのエンコーディング形式の名前を返します。
int	getKeyType()	このキーのキー・タイプを返します。
int	hashCode()	このEncryptionKeyのハッシュ・コードを返します。
String	toString()	このEncryptionKeyの有益なテキスト表現を返します。

クラスjava.lang.Objectで宣言されたメソッド

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

インタフェースjavax.security.auth.Destroyableで宣言されたメソッド

isDestroyed

コンストラクタの詳細

EncryptionKey

public EncryptionKey(byte[] keyBytes, int keyType)

指定されたバイトおよびキー・タイプからEncryptionKeyを構築します。

バイト配列の内容がコピーされます。その後バイト配列を変更しても、新しく作成されたキーには影響しません。

パラメータ:

keyBytes - キーのキー・マテリアル

keyType - Kerberosプロトコル仕様で定義されているキーのキー・タイプ。

例外:

NullPointerException - keyBytesがnullの場合

メソッドの詳細

getKeyType

public int getKeyType()

このキーのキー・タイプを返します。

戻り値:

キー・タイプ。

例外:

IllegalStateException - キーが破棄された場合

getAlgorithm

public String getAlgorithm()

このキーに対する標準アルゴリズムを返します。 アルゴリズム名は、IANAの「Kerberos暗号化型番号」ページで定義された暗号化タイプの文字列です。

このメソッドは、IANAページで定義されていない次の値を返すことができます:

1. none: etypeが0の場合
2. 不明: etypeが0より大きいが、実装によってサポートされていない
3. プライベート: 0より小さいetype

定義:

getAlgorithm、インタフェースKey

戻り値:

このキーに関連したアルゴリズムの名前。

例外:

IllegalStateException - キーが破棄された場合

getFormat

public String getFormat()

このキーのエンコーディング形式の名前を返します。

定義:

getFormat、インタフェースKey

戻り値:

String "RAW"

例外:

IllegalStateException - キーが破棄された場合

getEncoded

public byte[] getEncoded()

このキーのキー・マテリアルを返します。

定義:

getEncoded、インタフェースKey

戻り値:

鍵素材を含む新しく割り当てられたバイト配列

例外:

IllegalStateException - キーが破棄された場合

destroy

public void destroy() throws DestroyFailedException

このキーのキー・マテリアルをクリアして、このキーを破棄します。

定義:

destroy、インタフェースDestroyable

例外:

DestroyFailedException - このキーの破棄中にエラーが発生した場合。

toString

public String toString()

このEncryptionKeyの有益なテキスト表現を返します。

オーバーライド:

toString、クラスObject

戻り値:

このEncryptionKeyの有益なテキスト表現です。

hashCode

public int hashCode()

このEncryptionKeyのハッシュ・コードを返します。

オーバーライド:

hashCode、クラスObject

戻り値:

このEncryptionKeyのハッシュ・コード

関連項目:

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

equals

public boolean equals(Object other)

指定されたオブジェクトをこのキーと比較し、等価にします。 指定されたオブジェクトがEncryptionKeyでもあり、2つのEncryptionKeyインスタンスが同等である場合、trueを返します。 より正式な2つのEncryptionKeyインスタンスは、同じキー・タイプとキー・マテリアルを持つ場合に等しくなります。 破棄されたEncryptionKeyオブジェクトは、それ自体と等しいだけです。

オーバーライド:

equals、クラスObject

パラメータ:

other - 比較するオブジェクト

戻り値:

指定されたオブジェクトがこのEncryptionKeyと等しい場合はtrue、それ以外の場合はfalse。

関連項目:

• Object.hashCode()
• HashMap