org.ietf.jgss
クラス MessageProp

java.lang.Object
  |
  +--org.ietf.jgss.MessageProp

public class MessageProp

extends Object

このユーティリティクラスは、メッセージごとの GSSContext メソッド内で使用して、メッセージごとのプロパティを設定します。

GSSContext インタフェースの wrap および getMIC メソッドと組み合わせてこのクラスのインスタンスを使用すれば、特定の保護品質 (QOP) を指定したり、機密性サービスを呼び出し側から渡されたデータに適用するかどうかを要求したり (wrap のみ) できます。デフォルトの QOP を要求する場合は、QOP の値を 0 にする必要があります。

GSSContext インタフェースの unwrap および verifyMIC メソッドと組み合わせてこのクラスのインスタンスを使用すれば、渡されたメッセージ全体に QOP と機密性サービスが適用されます。verifyMIC の場合、機密性状態は常に false となります。これらのメソッドから復帰するときに、このオブジェクトには処理されたトークンの補足状態値も格納されます。補足状態値は、古いトークン、順序が正しくないトークン、ギャップトークン、または重複トークンを示します。

導入されたバージョン:

1.4

関連項目:

GSSContext.wrap(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.unwrap(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.getMIC(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.verifyMIC(byte[], int, int, byte[], int, int, org.ietf.jgss.MessageProp)

コンストラクタの概要

MessageProp(boolean privState)
特定のプライバシ状態を設定するコンストラクタです。

MessageProp(int qop, boolean privState)
QOP とプライバシ状態の値を設定するコンストラクタです。

メソッドの概要

int	getMinorStatus() 配下の機構がこのメッセージごとの操作に設定したマイナー状態コードを取り出します。
String	getMinorString() マイナー状態コードについて説明する文字列を取り出します。
boolean	getPrivacy() プライバシ状態を取り出します。
int	getQOP() QOP 値を取り出します。
boolean	isDuplicateToken() このトークンが以前のトークンの複製かどうかをテストします。
boolean	isGapToken() 予期したトークンが着信しているかどうか、つまり先行するトークンが正常に処理されているかどうかをテストします。
boolean	isOldToken() トークンの有効期限が切れているかどうか、つまりトークンが古いため重複を確認できないかどうかをテストします。
boolean	isUnseqToken() 後続のトークンがすでに処理されているかどうかをテストします。
void	setPrivacy(boolean privState) プライバシ状態を設定します。
void	setQOP(int qop) QOP 値を設定します。
void	setSupplementaryStates(boolean duplicate, boolean old, boolean unseq, boolean gap, int minorStatus, String minorString) このメソッドは、補足情報フラグの状態とマイナー状態を MessageProp に設定します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

MessageProp

public MessageProp(boolean privState)

特定のプライバシ状態を設定するコンストラクタです。使用される QOP 値は 0 です。

パラメータ:

privState - プライバシ (機密性) 状態

MessageProp

public MessageProp(int qop,
                   boolean privState)

QOP とプライバシ状態の値を設定するコンストラクタです。

パラメータ:

qop - QOP 値

privState - プライバシ (機密性) 状態

メソッドの詳細

getQOP

public int getQOP()

QOP 値を取り出します。

戻り値:

QOP 値を表す int

関連項目:

setQOP(int)

getPrivacy

public boolean getPrivacy()

プライバシ状態を取り出します。

戻り値:

プライバシ (機密性) 状態が真の場合は true、そうでない場合は false

関連項目:

setPrivacy(boolean)

setQOP

public void setQOP(int qop)

QOP 値を設定します。

パラメータ:

qop - QOP 値が設定される int 値

関連項目:

getQOP()

setPrivacy

public void setPrivacy(boolean privState)

プライバシ状態を設定します。

パラメータ:

privState - プライバシ (機密性) 状態が真の場合は true、そうでない場合は false

関連項目:

getPrivacy()

isDuplicateToken

public boolean isDuplicateToken()

このトークンが以前のトークンの複製かどうかをテストします。

戻り値:

複製である場合は true、そうでない場合は false

isOldToken

public boolean isOldToken()

トークンの有効期限が切れているかどうか、つまりトークンが古いため重複を確認できないかどうかをテストします。

戻り値:

トークンの有効期限が切れている場合は true、そうでない場合は false

isUnseqToken

public boolean isUnseqToken()

後続のトークンがすでに処理されているかどうかをテストします。

戻り値:

後続のトークンがすでに処理されている場合は true、そうでない場合は false

isGapToken

public boolean isGapToken()

予期したトークンが着信しているかどうか、つまり先行するトークンが正常に処理されているかどうかをテストします。

戻り値:

予期したメッセージごとのトークンが着信しなかった場合は true、そうでない場合は false

getMinorStatus

public int getMinorStatus()

配下の機構がこのメッセージごとの操作に設定したマイナー状態コードを取り出します。

戻り値:

マイナー状態を表す int

getMinorString

public String getMinorString()

マイナー状態コードについて説明する文字列を取り出します。

戻り値:

マイナー状態コードに対応する String。マイナー状態コードが設定されていない場合は、null が返される

setSupplementaryStates

public void setSupplementaryStates(boolean duplicate,
                                   boolean old,
                                   boolean unseq,
                                   boolean gap,
                                   int minorStatus,
                                   String minorString)

このメソッドは、補足情報フラグの状態とマイナー状態を MessageProp に設定します。このメソッドは、アプリケーションではなく GSS 実装で使用し、メッセージごとの context メソッドの呼び出し側にこの情報を返します。

パラメータ:

duplicate - このトークンが以前のトークンの複製であった場合は true、そうでない場合は false

old - このトークンの有効期限が切れている場合は true、そうでない場合は false

unseq - 後続のトークンがすでに処理されている場合は true、そうでない場合は false

gap - 先行するトークンが正常に処理されていない場合は true、そうでない場合は false

minorStatus - メッセージごとの操作のマイナー状態コードを表す int

minorString - minorStatus 値のテキスト表現