javax.microedition.io
インタフェース SecurityInfo

public interface SecurityInfo

このインタフェースはセキュアなネットワーク接続に関する情報にアクセスするためのメソッドを定義します。 セキュアな接続を実装するプロトコルは、接続に関連するセキュリティ・パラメータを報告するためにこのインタフェースを活用することができます。

定義するのは証明書、プロトコル、バージョンおよび使用中の暗号スイート（CipherSuite などのセキュリティ特性）などです。

導入されたバージョン:

MIDP 2.0

関連項目:

CertificateException, SecureConnection, HttpsConnection

getServerCertificate

Certificate getServerCertificate()

サーバーとの間でセキュアな関係を証明するために使用した Certificate オブジェクトを返します。

戻り値:

サーバーとの間でセキュアな接続を確立するために使用した Certificate オブジェクトを返します。

getProtocolVersion

String getProtocolVersion()

プロトコルのバージョンを返します。 もしもプロトコルにとって適切であるならば、"."（Unicode U+002E）で区切ったメジャーバージョンとマイナーバージョンを含むべきです。

以下に事例を示します。

• SSL V3 の場合は"3.0"でなければならない。
• TLS 1.0 の場合は"3.1"でなければならない。
• WTLS(WAP-199) の場合は"1"でなければならない。
• WAP TLS Profile および Tunneling Specification の場合は"3.1"でなければならない。

戻り値:

文字列表記によるプロトコルのバージョンを返します。 この戻り値は null にしてはなりません。

getProtocolName

String getProtocolName()

セキュア・プロトコルの名前を返します。

戻り値:

文字列表記によるセキュア・プロトコルの識別子を返します。以下に返すプロトコル名を例示します。

• TLS(RFC2246) または WAP TLS Profile と Tunneling(WAP-219-TLS) を使用している接続の場合は"TLS"を返します。
• SSL V3(The SSL Protocol Version 3.0) を使用している接続の場合は"SSL"を返します。
• WTLS(WAP 199) を使用している接続の場合は"WTLS"を返します。

getCipherSuite

String getCipherSuite()

接続に使用している暗号スイート（CipherSuite）の名前を返します。 返される名前は The TLS Protocol Version 1.0(RFC2246) の Appendix C の表 CipherSuite definitions（暗号スイート定義）の CipherSuite カラムに由来します。 暗号スイートが Appendix C に存在しないのであれば、返される名前は null ではありませんが、その内容は規定されていません。 The TLS Protocol Version 1.0 によらない実装では、セキュアな接続が SSL V3 または TLS1.0 または WTLS または WAP TLS Profile と Tunneling を使用するか否かに関らず、同等な暗号スイートには同じ名前があるように、接続を証明する際に使用する実際の鍵交換、暗号方式およびハッシュの組み合わせから、暗号スイート名を選択すべきです。

戻り値:

文字列表記による使用している暗号スイートの名前を返します。