JavaTM 暗号化アーキテクチャ

API 仕様 & 参照


最終更新日: 1997 年 3 月 17 日

謝辞

はじめに
設計方針
アーキテクチャ
概念

コアクラスとインタフェース
Provider クラス
プロバイダ実装の要求および獲得方法
プロバイダのインストール
Security クラス
MessageDigest クラス
Signature クラス
Key インタフェース
KeyPair クラス
KeyPairGenerator クラス
Key Management クラス
Identity クラス
IdentityScope クラス
Signer クラス
SecureRandom クラス

コード例
MessageDigest オブジェクトの計算
鍵のペアの生成
Signature の生成
Signature の検証


付録 A: 標準名

付録 B: アルゴリズム

謝辞

Java 暗号化アーキテクチャの設計では、JavaSoft や広範な Java 共同体の貢献者の方々のコメントを大いに参考にさせてもらいました。JDK 1.1 java.security API は、主に Benjamin Renaud の設計と実装によるものです。彼は API に顕著な影響を与えたフィードバックをしてくれた方々に特に感謝の意を表しています。その方々は次のとおりです(英字の順で): Josh Bloch, Dave Brown、Mary Dageforde、Satish Dharmaraj、Rachel Gollub, Li Gong、James Gosling、Surya Koneru、Jong Lee、Roger Riggs および Theron Tock。他にも数限りない方々に考え方やフィードバックで貢献して頂きましたが、ここに書ききれないため割愛させてもらいます。これらの方々には、ここで感謝の意を表します。

はじめに

Java セキュリティ API は Java の新しいコア API で、java.security パッケージ (およびそのサブパッケージ) に組み込まれています。この API は、開発者が低レベルと高レベルの両方のセキュリティ機能を Java アプリケーションに組み込めるように設計されています。JDK 1.1 の最初のリリースの Java セキュリティには、デジタル署名とメッセージダイジェストの API を含む、セキュリティ機能のサブセットが入っています。さらに、鍵管理、認証管理、およびアクセス制御に関する abstract (抽象) インタフェースもあります。X.509 v3 認証およびその他の認証形式をサポートする特定 API、およびアクセス制御に関するより豊富な機能が、今後の JDK リリースで実現される予定です。

「Java 暗号化アーキテクチャ」(JCA) は、Java プラットフォームの暗号機能の開発とアクセスに関するフレームワークです。JCA は、暗号に関連した JDK 1.1 Java セキュリティ API の一部 (現在のところほとんどすべての API)、ならびにこのドキュメントに記載の規則および仕様セットを含む、多重かつ互いに操作可能な暗号の実装を可能にする 「プロバイダ」 アーキテクチャを導入します。

Java 暗号化拡張 (Cryptography Extension (JCE)) は、暗号化と鍵交換を組み込むように JCA API を拡張したものです。JCE と JCA により、完全なプラットフォーム独立型の暗号化 API が提供されます。JCE は現時点では米国外に輸出できないため、別のリリースで提供する予定です。

このドキュメントには、Java Development Kit (JDK) 1.1 に同梱の JCA API ならびにそのデフォルトのプロバイダについて、レベルの高い説明と仕様が記載されています。JCE API に関するドキュメントは、JCE のリリース時に別途提供します。

注意: この仕様の最新バージョンは、弊社の公開 Web サイトhttp://java.sun.com/products/JDK/1.1/docs/guide/security/CryptoSpec.html にあります。

設計方針

Java 暗号化アーキテクチャ (JCA) は、以下の方針に基づいて設計されました:

実装の独立性とアルゴリズムの独立性は相補関係にあります。つまりこの 2 つの目的は、デジタル署名やメッセージダイジェストなどの暗号化概念について、 API ユーザが実装やこれらの概念を実装するアルゴリズムを意識しないで使えるようにすることです。完全なアルゴリズムの独立性が不可能なときは、JCA は標準化アルゴリズムの固有の API を開発者に提供します。実装の独立性が不要なときは、JCA は開発者に必要な特定の実装を示します。

実装の独立性は、「プロバイダ」ベースのアーキテクチャを使って実現されます。暗号化パッケージプロバイダ (略して「プロバイダ」) とは、デジタル署名アルゴリズム (DSA) や RSA 暗号化システム (RSA) などの特定アルゴリズムを実行するパッケージやパッケージセットを意味します。プログラムは単に、特定アルゴリズム (例えば DSA) を実行する特定型のオブジェクト (たとえば Signature オブジェクト) を要求するだけで、インストールされているプロバイダの 1 つから実装を獲得できます。必要に応じて、プログラムは特定プロバイダから実装を要求することもできます。例えば、より高速で安全性の高いバージョンが利用できるときは、プロバイダをアプリケーションに対して透過的に更新することができます。

アルゴリズムの独立性は、暗号化「エンジン」 (アルゴリズム) の型を定義し、これらの暗号化エンジンに機能を提供するクラスを定義して実現します。これらのクラスはエンジンクラスと呼ばれ、この例は MessageDigest クラスおよび Signature クラスです。

実装の相互操作性とは、様々な実装が互いに機能でき、互いの鍵を使ったり、互いの署名を検証できることを意味します。つまり、1 つのプロバイダが生成した同じアルゴリズムや鍵を別のプロバイダが使ったり、あるプロバイダが生成した署名を別のプロバイダが検証するということです。

アルゴリズムの拡張性とは、サポートされるエンジンクラスの 1 つに当てはまる新規アルゴリズムを容易に追加できることを意味します。

アーキテクチャ

暗号化パッケージプロバイダ

Java 暗号化アーキテクチャに、 暗号化パッケージプロバイダ (略して「プロバイダ」) の概念が導入されました。これは、Java セキュリティ API の暗号化に関するサブセットの具体的な実装を提供するパッケージ (またはパッケージセット) です。例えば、プロバイダにデジタル署名 (DSA) または RSA 暗号化システム (RSA) (あるいはその両方) の実装を含めることができます。

プログラムは単に、特定アルゴリズム (例えば DSA) を実行する特定型のオブジェクト (たとえば Signature オブジェクト) を要求するだけで、インストールされているプロバイダの 1 つから実装を獲得できます。あるいは、特定プロバイダを要求することもできます。(各プロバイダは、それぞれの参照名を持ちます)。

JDK 1.1 には、"SUN" という名前のデフォルトのプロバイダが標準で搭載されています。"SUN" プロバイダパッケージには、以下のものが含まれています:

JDK では 1 つ以上のプロバイダパッケージがインストールされます。新規プロバイダは静的または動的に追加できます (Provider クラスと Security クラスを参照してください)。Java 暗号化アーキテクチャには、インストールされているプロバイダについてユーザが問い合わせることができる API セットがあります。

クライアントは異なるプロバイダを用いて実行環境を構成し、各プロバイダの優先順位を指定できます。優先順位とは、特定プロバイダの指定がない場合に、要求アルゴリズムに関して検索されるプロバイダの順位です。

鍵管理

Java 仮想マシンごとに「システム識別スコープ」 IdentityScope) があります。これは鍵、認証、および信頼レベルのレポジトリを管理します。このリポジトリは、認証や署名のためにそれを必要とするアプリケーションが使用できます。恒久データベースのデフォルトの IdentityScope は、"SUN" というデフォルトの暗号化パッケージプロバイダから入手できます。異なる IdentityScope は、必要に応じてシステムスコープとして使うことができます。

概念

このセクションでは、API に導入された重要概念について説明します。

エンジンクラスとアルゴリズム

エンジンクラスとは暗号アルゴリズムの機能型を提供するクラスです。JCA は、各エンジンクラスごとに Java クラスを定義します。例えば、MessageDigest クラス、Signature クラス、および KeyPairGenerator クラスがあります。API のユーザは、これらのエンジンクラスを要求および利用して対応する処理を実行します。Signature インスタンスは、デジタル署名の実行および検証に、MessageDigest インスタンスは指定データのメッセージダイジェストの計算に、および KeyPairGenerator は指定のアルゴリズムに適した 公開鍵および秘密鍵のペアの生成に使います。

エンジンクラスは、特定な型のアルゴリズムの機能へのインタフェースを提供しますが、その実際の実装 (1 つ以上のプロバイダから) は特定アルゴリズムのためのものです。例えば Signature エンジンクラスは、デジタル署名アルゴリズムの機能へのアクセスを提供します。Signature サブクラスに実際に提供される実装は、DSA を使う SHA-1、RSA を使う SHA-1、または RSA を使う MD5 などの任意の種類の署名アルゴリズムとなり得ます。

別の例として、MessageDigest はメッセージダイジェストアルゴリズムへのアクセスを提供します。この実装は、SHA-1、MD5、または MD2 などの各種メッセージダイジェストアルゴリズムにできます。

実装とプロバイダ

各種エンジンクラスの実装は、JCA 暗号化パッケージプロバイダが提供します。プロバイダとは、特定アルゴリズムの 1 つまたは複数のエンジンクラスを実装する基本パッケージです。例えば、"SUN" という Java Development Kit のデフォルトのプロバイダは、DSN 署名アルゴリズムおよび MD5 と SHA-1 メッセージダイジェストアルゴリズムの実装を提供します。その他のプロバイダは、上記のアルゴリズムまたはその他のアルゴリズム (RSA ベースの署名アルゴリズムや MD2 メッセージダイジェストアルゴリズムなど) について、独自の実装を定義できます。

実装インスタンスを獲得するためのファクトリメソッド

API の各エンジンクラスについては、エンジンクラス特有のファクトリメソッドを呼び出すことによって特定の実装が要求され、インスタンスが生成されます。ファクトリメソッドは、クラスのインスタンスを返す static (スタティック) メソッドです。

例えば、該当の Signature オブジェクト獲得メカニズムは以下のとおりです: ユーザは Signature クラスの getInstance メソッドを呼び出してオブジェクトを要求します。署名アルゴリズム名 (DSA など) を指定し、オプションで必要な実装を持つプロバイダ名も指定します。 getInstance メソッドが、指定のアルゴリズムおよびプロバイダのパラメータを満たす Signature サブクラスを検索します。プロバイダの指定がない場合、getInstance は優先順位に従って登録プロバイダを検索し、指定のアルゴリズムを実装する Signature サブクラスを持つものを見つけ出します。プロバイダの登録の詳細は、Provider クラス を参照してください。

コアクラスとインタフェース

このセクションでは、Java 暗号化アーキテクチャの一般リリースで提供するコアクラスとインタフェースについて説明します:

このセクションでは、各クラスおよびインタフェースのメインメソッドのシグネチャを示します。該当する 例 のセクションには、クラス (MessageDigest、Signature、および KeyPairGenerator) の使用例があります。 セキュリティ API パッケージの完全な参考文献は、以下にあります:

Provider クラス

「暗号化パッケージプロバイダ」 (短縮して「プロバイダ」) とは、特定の暗号化アルゴリズムを実装するパッケージまたはパッケージセットです。Provider クラスは、このようなパッケージやパッケージセットへのインタフェースです。プロバイダ名、バージョン番号、その他の情報にアクセスするためのメソッドを備えています。

実際に暗号化アルゴリズムの実装を提供するには、エンティティ (例えば開発グループ) は実装コードを作成し、Provider クラスのサブクラスを生成します。サブクラスの構築子は、プロバイダが実装したアルゴリズムやその他の機能を検索するために Java セキュリティ API に必要な各種プロパティの値を設定します。つまり、アルゴリズムを実装するクラス名を指定します。 注意: Provider サブクラスは、必要なときにどこからでも情報を得ることができます。つまり、実行時にファイルに情報をハードワイヤしたり、ファイルから検索したりできます。

プロバイダパッケージが実装できるアルゴリズム型は、デジタル署名アルゴリズム (DSA や RAS を使う MD5)、メッセージダイジェストアルゴリズム (SHA-1 やMD5)、JCE がインストールされたもの、暗号化アルゴリズム (DES や RSA)、および埋込みスキーム (例えば PKCS#5) など様々です。

実装が異なると、文字も異なる場合があります。ソフトウェアベースのものもあれば、ハードウェアベースのものもあります。プラットフォーム独立のものもあれば、プラットフォーム固有のものもあります。また、レビューや評価用に使えるプロバイダコードもあれば、使えないものもあります。

Java 暗号化アーキテクチャ (JCA) では、エンドユーザと開発者の双方が独自のニーズを決定できます。このセクションでは、エンドユーザのための暗号実装のインストール方法とニーズへの合わせかた、および開発者のための必要な実装の要求方法を説明します。

プロバイダ実装の要求および獲得方法

この API の各 エンジンクラスについては、特定の実装が要求されそのエンジンクラスの getInstance メソッドを呼び出してインスタンスを生成します。このときに、希望するアルゴリズムの名前およびオプションで実装したいプロバイダの名前を指定します。

プロバイダを指定しない場合、getInstance は名前付きアルゴリズムの実装の登録プロバイダを検索します。どの Java 仮想マシン (JVM) でも、プロバイダは指定の優先順位でインストールされます。これは特定のプロバイダが要求されないときのプロバイダの検索順序です。例えば、JVM にプロバイダが 2 つインストールされているとします。1つは「PROVIDER_1」であり、もう1つは「PROVIDER_2」です。さらに、次のことを想定します。

「PROVIDER_1」 の優先順位が 1 (最高の優先順位) で、「PROVIDER_2」 の優先順位が 2 の場合、以下の動作が行われます。

プロバイダ引数を持つ getInstance メソッドは、必要なアルゴリズムを持つプロバイダを指定する開発者のためのものです。例えば、連邦認証を受け取ったプロバイダ実装を連邦局が使いたいとします。PROVIDER_1 の DSA 実装はこの認証を受け取っていないのに対し、PROVIDER_2 の DSA 実装がこれを受け取っていると仮定します。

連邦プログラムは以下の呼び出しを実行します。PROVIDER_2 が認証された実装を持つため、これを指定します: 

	Signature dsa = Signature.getInstance("DSA", "PROVIDER_2");

この場合、「PROVIDER_2」がインストールされていないと、インストールされている別のプロバイダが要求アルゴリズムを実装している場合であっても、NoSuchProviderException が出されます。

プログラムは、( Security クラスの getProviders メソッドを使って) インストールされているプロバイダの一覧を獲得し、一覧から選択することもできます。

プロバイダのインストール

プロバイダのインストールは 2 つの部分に分かれます。つまり、プロバイダパッケージクラスのインストールとプロバイダの構成です。

プロバイダクラスのインストール

JDK インストレーションディレクトリ内に classes ディレクトリを生成し、このディレクトリにプロバイダクラス (.class ファイル) をインストールします。例えば、JDK が jdk1.1.1 というディレクトリにインストールされていて、プロバイダを実装するクラスが COM.acme.provider パッケージに入っている場合、クラスをディレクトリ jdk1.1.1/classes/COM/acme/provider にインストールします。

あるいは、クラスが入っている zip または JAR (Java ARchive) ファイルを、CLASSPATH の任意の場所に置くことができます。

プロバイダの構成

次のステップは、認可プロバイダのリストにこのプロバイダを追加することです。この処理は、JDK の lib/security ディレクトリにある java.security ファイルを編集して静的に行います。つまり、JDK が jdk1.1.1 というディレクトリにインストールされている場合は、ファイルは jdk1.1.1/lib/security/java.security です。 java.security に設定できるプロパティ型の 1 つは、以下の形式を取ります: 

    security.provider.n=masterClassName

これはプロバイダを宣言し、その優先順位 n を指定します。優先順位とは、特定プロバイダの指定がないときに、要求アルゴリズムについてプロバイダを検索する順序です。順位は 1 から始まり、1 が最優先で次に 2、3 ...と続きます。

masterClassName は、プロバイダの「マスター」クラスを指定する必要があります。プロバイダのドキュメンテーションでそのマスタークラスを指定します。このクラスは常に Provider クラスのサブクラスです。サブクラス構築子は、プロバイダが実装したアルゴリズムやその他の機能を検索するために Java 暗号化 API に必要な各種プロパティの値を設定します。

マスタークラスが COM.acme.provider.Acme で、優先順位が 3 位のプロバイダとして Acme を構成したいとします。こうするには、次のラインを java.security ファイルに追加します: 

    security.provider.3=COM.acme.provider.Acme
プロバイダは動的に登録することもできます。こうするには、Security クラスの addProvider またはinsertProviderAt のいずれかのメソッドを呼び出します。この登録は恒久的ではなく、「信頼される」プログラムでしか実行できません。Security クラス を参照してください。

Provider クラスのメソッド

各 Provide クラスインタフェースは、名前 (現時点では大文字小文字を区別する)、バージョン番号、およびプロバイダとそのサービスの文字列記述を持ちます。以下のメソッドを呼び出して、これらの情報について Provider インスタンスを照会できます: 

    public String getName()
    public double getVersion()
    public String getInfo()

Security クラス

Security クラスは、インストールされているプロバイダおよびセキュリティに関するプロパティを管理します。このクラスが含むのは、インスタンス実行しない static (スタティック) メソッドだけです。

注意: これらのメソッドを呼び出せるのは、信頼されるプログラムだけです。現時点での「信頼されるプログラム」は、以下のいずれかです

プロバイダの管理

セキュリティクラスを使って、インストールされているプロバイダを照会するだけでなく、実行時に新規のプロバイダをインストールすることもできます。

プロバイダの照会

	public Provider[] getProviders()

このメソッドは、インストールされているすべてのプロバイダを含む配列 (つまり、各パッケージプロバイダの Provider サブクラス) を返します。配列内のプロバイダの順序は、優先順位に従います。 

	public Provider getProvider(String providerName)

このメソッドは、providerName という名前のプロバイダを返します。このプロバイダが見つからないと null を返します。

プロバイダの追加

	public void addProvider(Provider provider)

このメソッドは、使用可能な次の優先順位にプロバイダを追加します。プロバイダが追加された優先順位を返すか、すでにインストールされているためにプロバイダが追加されなかった場合は -1 を返します。 

	public int insertProviderAt(Provider provider, int position)

このメソッドは、指定位置に新規のプロバイダを追加します。位置とは、特定プロバイダの指定がない場合に、要求アルゴリズムについてプロバイダが検索される優先順位です。位置は 1 から始まり、1 が最優先で次に 2、3 ...と続きます。プロバイダが要求位置に必ず追加されるとは限らないことに注意してください。例えば、プロバイダを追加できても、一番最後の位置だけに限られる場合もあります。このような場合は、position 引数は無視されます。また、すでにインストール済みのプロバイダは追加できません。

このメソッドは、プロバイダが追加された実際の位置を返します。すでにインストールされているためプロバイダが追加されなかったときは、-1 を返します。

プロバイダの削除

	public void removeProvider(String name)

このメソッドは、指定名のプロバイダを削除します。プロバイダがインストールされていない場合は、何も返しません。

セキュリティのプロパティ

Security クラスは、システムに関するセキュリティのプロパティリストを保持します。これらのプロパティは、以下のメソッドを使って、信頼されるプログラムからアクセスして設定できます: 

	public static String getProperty(String key)
	public static void setProperty(String key, String datum)

MessageDigest クラス

MessageDigest クラスはエンジンクラスで、安全な暗号化メッセージダイジェスト (SHA-1 や MD5 など) の機能を提供するように設計されています。安全な暗号化メッセージダイジェストは、任意サイズの入力 (バイト配列) を取り、固定サイズ出力を生成します。これをダイジェストと言います。ダイジェストのプロパティは次のとおりです:

メッセージダイジェストを使い、固有で信頼できるデータ識別子を生成します。データ識別子をデータの「デジタル指紋」と呼ぶこともあります。

MessageDigest オブジェクトの生成

ダイジェスト計算では、まず最初にメッセージダイジェストインスタンスを生成します。どのエンジンクラスの場合も同様に、MessageDigest クラスの static (スタティック) ファクトリメソッド getInstance を呼び出して、特定型のメッセージダイジェストアルゴリズムの MessageDigest オブジェクトを獲得します: 

    public static MessageDigest getInstance(String algorithm)

呼び出し側は、オプションでプロバイダ名を指定できます。こうすると、要求アルゴリズムの実装を確実に指定プロバイダから得られます: 

    public static MessageDigest getInstance(String algorithm, String provider)

getInstance を呼び出すと、初期化されたメッセージダイジェストオブジェクトが返ります。従って、この後で初期化を行う必要はありません。

メッセージダイジェストオブジェクトのアップデート

データのダイジェストを計算するための次のステップは、初期化したメッセージダイジェストオブジェクトにデータを入れることです。次の update メソッドのどれか 1 つを 1 回または複数回呼び出して実行します: 

    public void update(byte input)
    public void update(byte[] input)
    public void update(byte[] input, int offset, int len)

ダイジェストの計算

update メソッドを呼び出してデータを入れたあとで、次の digest メソッドのうちのどれか 1 つを使ってダイジェストを計算します。 

    public byte[] digest()
    public byte[] digest(byte[] input)

後者のメソッドの呼び出しは、以下の呼び出しと同じです。 

    public void update(byte[] input)
入力を指定し、その後に引数を持たない digest メソッドの呼び出しが続きます。

詳細は例 のセクションを参照してください。

Signature クラス

Signature クラスはエンジンクラスで、DSA や MD5 を使う RSA などの暗号化デジタル署名機能を提供するように設計されています。安全な暗号化署名アルゴリズムは任意サイズの入力と秘密鍵を取り、署名と呼ばれる比較的短い (固定サイズの場合もよくある) バイト文字列を生成します。このプロパティは次のとおりです:

Signature オブジェクトを使って、データに署名を付けることができます。また、指定の署名が、関連データの実際の認証署名かどうかを検証することもできます。 データの署名および検証の例は、例のセクションを参照してください。

Signature オブジェクトの状態

Signature オブジェクトはモデルオブジェクトです。つまり、Signature オブジェクトは常に指定の状態にあり、この状態で 1 つの型のオペレーションだけを実行できます。状態は、個々のクラス (例えば Signature など) で定義した final (ファイナル) 整数の定数で表されます。

Signature オブジェクトに可能な状態は、次の 3 つです:

Signature オブジェクトが初めて生成されるときは、UNINITIALIZED の状態です。Signature クラスは、状態を SIGN に変更する initSign と、状態を VERIFY に変更する initVerify の 2 つの初期化メソッドを定義します。

Signature オブジェクトの生成

署名を付ける/検証するには、最初に Signature インスタンスを生成します。どのエンジンメソッドの場合も同様に、Signature クラスの getInstance static (スタティック) ファクトリメソッドを呼び出して、特定型の署名アルゴリズムの Signature オブジェクトを獲得します: 
    public static Signature getInstance(String algorithm)

呼び出し側は、オプションでプロバイダ名を指定できます。こうすると、要求アルゴリズムの実装を確実に指定プロバイダから得られます: 

    public static Signature getInstance(String algorithm, 
                                        String provider)

Signature オブジェクトの初期化

Signature オブジェクトを使うには、最初に必ずこれを初期化します。初期化メソッドは、オブジェクトを最初に署名用に使うか検証用に使うかに応じて異なります。

署名で使う場合、オブジェクトは最初に、署名を生成するエンティティの秘密鍵を使って初期化する必要があります。この初期化は、以下のメソッドを呼び出して実行します:

public final void initSign(PrivateKey privateKey)

このメソッドでは、Signature オブジェクトは SIGN 状態になります。

Signature オブジェクトを検証で使う場合は、まず最初に、署名を検証するエンティティの公開鍵を使って初期化する必要があります。この初期化は、以下のメソッドを呼び出して実行します: 

    public final void initVerify(PublicKey publicKey)

このメソッドでは、Signature オブジェクトは VERIFY 状態になります。

署名

Signature オブジェクトを署名用に初期化した場合 (このオブジェクトが SIGN 状態の場合)、署名を付けるデータをオブジェクトに入れることができます。これは、以下の update メソッドのどれか 1 つを 1 回または複数回呼び出して実行します: 

    public final void update(byte b)
    public final void update(byte[] data)
    public final void update(byte[] data, int off, int len)

署名を付けるデータがすべて Signature オブジェクトに入るまで、update メソッドを呼び出します。

署名を生成するには、単に sign メソッドを呼び出します: 

    public final byte[] sign()

これは、署名をバイト配列に入れて返します。署名は、2 つの整数型 r および s の標準 ASN.1/DER シーケンスとしてコード化されます。Java 暗号化アーキテクチャでの ASN.1 および DER コード化の使用方法については、 付録 B を参照してください。

sign メソッドを呼び出すと、signature (署名) オブジェクトは、initSign を呼び出して最初に署名用に初期化されたときの状態にリセットされます。つまり、オブジェクトをリセットするので、必要であれば update と sign を呼び出して、同じ署名者の別の署名を生成できます。

あるいは異なる秘密鍵を指定し、(異なるエンティティの署名を生成するために Signature オブジェクトを初期化する目的で) initSign への新規呼び出しを作成したり、(署名を検証するために Signature オブジェクトを初期化する目的で) initVerify への新規呼び出しを作成できます。

検証

Signature オブジェクトを検証用に初期化した場合 (VERIFY 状態にある場合) は、指定の署名が、それに関連したデータの実際の認証署名であるかどうかを検証できます。この処理を開始するには、検証データ (署名自体ではない) をオブジェクトに入れます。これは、以下の update メソッドのどれか 1 つを 1 回または複数回呼び出して実行します: 

    public final void update(byte b)
    public final void update(byte[] data)
    public final void update(byte[] data, int off, int len)

すべてのデータが Signature オブジェクトに入るまで、update メソッドを呼び出します。

このあとで、verify メソッドを呼び出して署名を検証できます: 

    public final boolean verify(byte[] encodedSignature)

引数は、2 つの整数型 r および s の標準 ASN.1/DER シーケンスとしてコード化した署名を含むバイト配列であることが必要です。これは頻繁に使用する標準コード化です。sign メソッドが生成するものと同じです。

verify メソッドは、コード化した署名が update メソッドに入れたデータの認証署名かどうかを示す boolean を返します。

verify メソッドを呼び出すと、signature (署名) オブジェクトは、initVerify を呼び出して最初に検証用に初期化されたときの状態にリセットされます。つまり、オブジェクトをリセットするので、initVerify への呼び出しで指定した公開鍵を持つ識別の別の署名を検証できます。

あるいは異なる秘密鍵を指定し、(異なるエンティティの署名を検証するために Signature オブジェクトを初期化する目的で) initVerify への新規呼び出しを作成したり、(署名を生成するために Signature オブジェクトを初期化する目的で) initSign への新規呼び出しを作成できます。

Key インタフェース

Key インタフェースは、すべての鍵に関するトップレベルのインタフェースです。すべての鍵オブジェクトが共有する機能を定義します。すべての鍵は、次の 3 つの特性を持ちます:

鍵は一般的に、鍵生成子、認証、および鍵管理で使う各種 Identity クラスから獲得します。コード化した鍵および認証の解析機能は、このリリースには備わっていません。

PublicKey および PrivateKey インタフェース

PublicKey および PrivateKey インタフェースはメソッドを使わないインタフェースで、型の安全性および型の識別に使います。

KeyPair クラス

KeyPair クラスは鍵のペア (公開鍵と秘密鍵) の簡単なホルダーで、2 つの public メソッドがあります。1 つは秘密鍵を返し、もう 1 つは公開鍵を返します: 

    public PrivateKey getPrivate()
    public PublicKey getPublic()

KeyPairGenerator クラス

KeyPairGenerator クラスはエンジンクラスで、public および秘密鍵のペアの生成に使います。鍵生成は時として、アルゴリズムの独立性に反する領域です。例えば、鍵ファミリーのパラメータ (p, q および g) を指定して DSA 鍵のペアを生成することができるのに対し、RSA 鍵のペアは生成できません。つまり、これらのパラメータは DSA には適用できて RSA には適用できません。

従って、鍵のペアの生成方法には、アルゴリズム独立型の方法とアルゴリズム特定型の方法の 2 つがあります。この 2 つの唯一の相違点は、オブジェクトの初期化にあります。 以下のメソッドの呼び出し例は、例のセクションを参照してください。

KeyPairGenerator の生成

すべての鍵のペアは、まず最初に KeyPairGenerator を使って生成します。これは、KeyPairGenerator の以下のファクトリメソッドのいずれか 1 つを使って実行します。 

    public static KeyPairGenerator getInstance(String algorithm)
    public static KeyPairGenerator getInstance(String algorithm, 
        String provider)

KeyPairGenerator の初期化

まず最初に鍵のペアを初期化してからでなければ、鍵のペアは鍵を生成できません。ほとんどの場合、アルゴリズム独立型の初期化で十分です。ただし、所定のアルゴリズムに特有のパラメータを制御したい場合は、アルゴリズム特定型の初期化を使います。

アルゴリズム独立型の初期化

すべての鍵生成子は、「強度」およびランダム性のソースの概念を共有します。強度は、すべてのアルゴリズムが例外なく共有しますが、アルゴリズムごとに解釈が異なります。(特定アルゴリズムの強度の詳細は、付録 B: アルゴリズムを参照してください)。ランダム性のソースは、SecureRandom オブジェクトとして提供する必要があります。KeyPairGenerator クラスの initialize メソッドは、一般的に共有されるこの 2 つの型の引数を取ります。署名は次のようになります: 

    public void initialize(int strength, SecureRandom random)

このアルゴリズム独立型 initialize メソッドを呼び出すときは、その他のパラメータは指定しないため、アルゴリズムパラメータや public 指数などのその他の値はすべて、標準値にデフォルト化されます。特定アルゴリズムのデフォルト値の詳細は、付録 B: アルゴリズムを参照してください。

アルゴリズム特定型の初期化

場合によっては、アルゴリズム特定型セマンティクスを使って、鍵のペア生成子オブジェクトを初期化する必要があります。例えば、所定のパラメータセット p, q および g について DSA 鍵生成子を初期化したい場合や、所定の public 指数 e について RSA 鍵生成子を初期化したい場合などです。

これは、アルゴリズム特定型の標準インタフェースを介して実行します。アルゴリズム独立型の KeyPairGenerator の initialize メソッドを呼び出すのではなく、鍵のペア生成子をアルゴリズム特定型のインタフェースにキャストして、特殊なパラメータ初期化メソッドの 1 つを呼び出します。この例として DSAKeyPairGenerator (java.security.interfaces から) が挙げられます。これは以下の特殊パラメータ初期化メソッドを呼び出します: 

    public void initialize(DSAParams params, SecureRandom random)

詳細は例のセクションを参照してください。

鍵のペアの生成

鍵のペアの生成は、初期化 (およびアルゴリズム) に関係なく、常に同じです。必ず KeyPairGenerator から以下のメソッドを呼び出します: 

    public KeyPair generateKeyPair()

generateKeyPair を呼び出すたびに、異なる鍵のペアが作られます。

Key Management クラス

Identity クラス

Identity クラスは基本の鍵管理エンティティです。

このクラスは識別を表します。これは、公開鍵を使って認証できる識別を持つ人、会社、または組織などの実際のオブジェクトです。

Identity オブジェクトはすべて、名前と公開鍵を持ちます。名前は不変です。識別はスコープ指定も可能です (IdentityScope を参照してください)。つまり、特定スコープを持つように Identity を指定した場合、この Identity の名前と公開鍵はそのスコープ内で固有です。

Identity には認証セットもあります (すべての認証が独自の公開鍵を認証します)。 注意: X.509 v3 などの特定の認証フォーマットのサポートは JDK 1.1 では不可能ですが、次回の JDK リリースに含まれる予定です。

Identity クラスのメインメソッドは、クラス名、その公開鍵、およびスコープを返すメソッドです: 

    public String getName()

    public PublicKey getPublicKey()

    public IdentityScope getScope()

識別名とスコープは、Identity を固有に識別します。同様に (鍵と識別は 1 対 1 のマッピングなので)、鍵は Identity を固有に識別します。

IdentityScope クラス

IdentityScope クラスは Identity クラスのサブクラスです。これは、Identity オブジェクト (および Identity のサブクラスのオブジェクト) のレポジトリに関する一般的な抽象として機能します。例として、識別データベース、識別サーバ、および PGP 鍵リングなどがあります。これらのレポジトリは、セキュアクラスローダなどの各種メカニズムで使用してクラスを検証し許可を代入したり、署名ツールで使用して秘密鍵を取得しデジタル署名を生成します。一般的に、公開鍵のレポジトリと秘密鍵のレポジトリは別々に保存します。

名前と鍵のスコープの指定

IdentityScope オブジェクトそのものが Identity なので名前があります。また、スコープを持つこともできます。任意指定で公開鍵と関連認証を持つことも可能です。

鍵と識別は 1 対 1 のマッピングなので、スコープ内では鍵のコピーは 1 つだけです。つまり、同じスコープ内で 2 つの Identity オブジェクトが同じ公開鍵や同じ名前を持つことはありません。

IdentityScope は、すべての種類の Identity オブジェクトを含めることができます。これには他の IdentityScopes も含まれます。例えば、"Sun" という名前の IdentityScope に (Sun の運営する他の会社と一緒に) 別のスコープ "JavaSoft" を入れ、この JavaSoft にも別のスコープ「セキュリティグループ」を入れることができます。このスコープには、"Duke" という名前の Identity オブジェクトを含む、各種 Identity オブジェクトを入れることができます。

世界には複数の「セキュリティグループ」があることは明白です。仮想マシンごとに 1 つ以上のセキュリティグループがある場合もありますが、スコープ "Sun"/"JavaSoft" 内のセキュリティグループは 1 つだけです。同様に、世の中には "Duke" という名前の人が他にもいるでしょう。ただし "Sun"/"JavaSoft"/「セキュリティグループ」/"Duke" のスコープ内に入る Duke はただ 1 人だけです。

名前と公開鍵は 1 対 1 の対応関係 (1 つの Identity オブジェクトが持つ公開鍵は 1 つだけ) なので、公開鍵についても同様のスコープの固有性が存在します。従って、例えば Identity 名が "Duke" の公開鍵は、そのスコープ内で必ず固有です。(同様に、公開鍵に対応する秘密鍵は 1 つだけなので、このスコープの固有性は秘密鍵に対しても存在します)。

IdentityScope メソッド

すべての型の Identity オブジェクトは、同じメソッドを使ってリトリーブ、追加、および削除できます。異なる型の識別スコープを、様々な型の Identity での各種オペレーションの異なるポリシーに適用することが可能ですし、実際に当然のことと考えられています。以下はメインの IdentityScope メソッドです: 

    /* Return the identity with the specified name. */
    public Identity getIdentity(String name)

    /* Add the specified identity to this identity scope. */
    public void addIdentity(Identity identity)

    /* Remove the specified identity from this identity scope. */
    public void removeIdentity(Identity identity)

    /* Return an enumeration of all identities in this identity scope. */
    public Enumeration identities()

システム識別スコープ

Java 仮想マシンごとに、鍵、認証、および信頼レベルのレポジトリを管理する「システム識別スコープ」 (IdentityScope オブジェクト) があります。このリポジトリは、認証や署名のためにそれを必要とするアプリケーションが使用できます。恒久データベースのデフォルトの IdentityScope は、"SUN" というプロバイダから入手できます。これは sun.security.provider.IdentityDatabase (IdentityScope のサブクラス) です。このクラスのインスタンスは、Java プログラムが実行するたび、またはアプレットビューアが開始するたびに生成されます。

必要に応じて、異なる IdentityScope をシステムスコープとして使用できます。権限を持つユーザは、インストレーションディレクトリ内の lib/security ディレクトリの java.security ファイルにある system.scope プロパティを変更して、システムスコープを JVM 全体で使うように変更できます。つまり、JDK のインストール先ディレクトリが jdk1.1.1 の場合、ファイルは jdk1.1.1/lib/security/java.security になります。システムスコープに関するファイル内のデフォルトのエントリは、以下のようになります。 

    system.scope=sun.security.provider.IdentityDatabase
system.scope プロパティの値は、システムスコープとしてインスタンス実行するクラスを指定します。システムスコープを変更するには、 sun.security.provider.IdentityDatabase 以外の異なる IdentityScope を指定します。 あるいは、プログラムの現行セッション中に排他的に使用するよう、プログラムでシステムスコープを変更できます。(JVM の全ユーザを対象とした、より恒久的なスコープ変更とは対照的です)。プログラムは IdentityScope の setSystemScope メソッドを呼び出して、この変更を行います: 
    public void setSystemScope(IdentityScope scope)
以下のメソッドを呼び出して、システム識別スコープを随時獲得できます: 
    public IdentityScope getSystemScope()

一般的に、公開鍵のレポジトリと秘密鍵のレポジトリは別個に保存します。これは必ずしも容易ではありません。システムスコープは通常 public データベースであるのに対し、所定ユーザの private スコープはユーザのホームディレクトリなどの private ディレクトリ内の場合があるためです。

Signer クラス

Signer クラスは Identity のサブクラスです。データに署名を付けることができる Identity を表すために使います。このようなエンティティには「鍵のペア」が必要です。つまり、公開鍵と関連した秘密鍵のことです。(秘密鍵はデータに署名を付けるために必要で、関連した公開鍵は署名の検証に必要です)。このため Signer クラスは、鍵のペアを設定するための以下のメソッドを追加します: 
    public final void setKeyPair(KeyPair pair)
秘密鍵を返すためのメソッドも追加します (公開鍵は Identity クラスの getPublicKey メソッドから返されます) : 
    public PrivateKey getPrivateKey()

SecureRandom クラス

SecureRandom クラスは、ソフトウェアベース、プラットフォーム独立型、高品質の乱数生成子を提供するためのものです。

SecureRandom オブジェクトの生成

SecureRandom インスタンスを実行する方法は 2 つあります。1 つはデフォルトのシードメカニズムを使う方法で、もう 1 つはシードを提供する方法です。SecureRandom オブジェクトに一度シードが入れられると、これはオリジナルのシードと同じようにランダムにビットを生成します: 

    public SecureRandom()

    public SecureRandom(byte[] seed)

現在 JDK 1.1 に実装されているデフォルトのシーディングメカニズムは実験的なもので、暗号化セキュア乱数を必要とするアプリケーションは暗号化セキュアシードを使って SecureRandom インスタンスをシードする必要があります。

SecureRandom オブジェクトの使い方

ランダムバイトを得るには、呼び出し側は単純に任意の長さの配列を渡します。すると、この配列にランダムバイトが入ります: 

     public void nextBytes(byte[] bytes)

SecureRandom オブジェクトの再シード

以下のメソッドを使って、SecureRandom オブジェクトを随時再シードできます: 

    public void setSeed(byte[] seed)

これはシードをリセットします。指定のシードは、既存のシードを置換するのではなく、補足するものです。このため、繰返して呼び出してもランダム性は決して減少しません。

コード例

MessageDigest オブジェクトの計算

まず最初に、以下の例のようにしてメッセージダイジェストを生成します。 

    MessageDigest sha = MessageDigest.getInstance("SHA-1");

この呼び出しは、正しく初期化されたメッセージダイジェストオブジェクトを 変数sha に代入します。このオブジェクトは、National Institute for Standards and Technology の (NIST) FIPS 180-1 ドキュメントの定義に従って、ソースハッシュアルゴリズム (SHA-1) を実装します。付録 A を参照してください。

次に、3 つのバイト配列 i1、i2 および i3 があるとします。計算するメッセージダイジェストを持つ合計入力は、この 3 つの配列から形成されます。このダイジェスト (または「ハッシュ」) は、以下の呼び出しを使って計算できます: 

    sha.update(i1);
    sha.update(i2);
    sha.update(i3);
    byte[] hash = sha.digest();

以下の一連の呼び出しを使っても同じです: 

    sha.update(i1);
    sha.update(i2);
    byte[] hash = sha.digest(i3);

メッセージダイジェストが計算されると、メッセージダイジェストオブジェクトは自動的にリセットされ、新しいデータをレビューしてそのダイジェストを計算できる状態になります。以前の状態 (例えば update コールで入れたデータ) はすべて失われます。

ハッシュ実装によっては、クローン (コピー) を介して中間ハッシュをサポートするものもあります。以下について、別々のハッシュを計算するとしましょう:

次のように処理します: 

    /* compute the hash for i1 */
    sha.update(i1); 
    byte[] i1Hash = sha.clone().digest();

    /* compute the hash for i1 and i2 */
    sha.update(i2); 
    byte[] i12Hash = sha.clone().digest(); 

    /* compute the hash for i1, i2 and i3 */
    sha.update(i3); 
    byte[] i123hash = sha.digest();

これは、SHA-1 実装がクローン (コピー) 可能な場合にのみ機能します。メッセージダイジェストの実装の中には、クローン (コピー) 可能なものもあれば、不可能なものもあります。以下は、指定のメッセージダイジェストのインスタンスがクローン (コピー) 可能かどうかのテスト方法です: 

    boolean cloneable = sha instanceof Cloneable;

メッセージダイジェストがクローン (コピー) 不可能な場合は、別の多少紛らわしい方法を使います。つまり、複数のダイジェストを生成して中間ダイジェストを計算します。この場合、計算する中間ダイジェストの数を前もって知っておくことが必要です: 

    MessageDigest i1 = MessageDigest.getMessageDigest("SHA-1");
    MessageDigest i12 = MessageDigest.getMessageDigest("SHA-1");
    MessageDigest i123 = MessageDigest.getMessageDigest("SHA-1");

    byte[] i1Hash = i1.digest(i1);

    i12.update(i1);
    byte[] i12Hash = i12.digest(i2);

    i123.update(i1);
    i123.update(i2);
    byte[] i123Hash = i123.digest(i3);

鍵のペアの生成

この例では、「DSA」 (デジタル署名アルゴリズム) という名前のアルゴリズムについて、公開 - 秘密 の鍵のペアを生成します。userSeed というユーザ作成のシードを使って、1024 ビットモジュラスの鍵を生成します。ここでは、アルゴリズム実装を提供するプロバイダは考慮しません。

鍵のペア生成子の生成

最初のステップは、DSA アルゴリズムの鍵を生成するための鍵のペア生成子オブジェクトの獲得です: 

    KeyPairGenerator keyGen = KeyPairGenerator.getInstance("DSA");

鍵のペア生成子の初期化

次のステップは、鍵のペア生成子の初期化です。たいていの場合、アルゴリズム独立型の初期化で十分です。ただし、DSA アルゴリズムに特定のパラメータを制御したい場合は、アルゴリズム特定型の初期化を使います。
アルゴリズム独立型の初期化

すべての鍵生成子は、「強度」およびランダム性のソースの概念を共有します。一般的な KeyPairGenerator クラスの initialize メソッドには、2 つの型の引数があります。つまり鍵を生成するには、1024 の長さのモジュラスと userSeed 値を使ってシードした新規の SecureRandom オブジェクトを指定し、以下のコードを使います: 

    keyGen.initialize(1024, new SecureRandom(userSeed));
アルゴリズム特定型の初期化

アルゴリズム独立型の初期化を行うときは、アルゴリズム特定型パラメータの値については、実装のデフォルト値を使います (ただし、強度は例外)。

DSA 特定パラメータのセット p、 q、および g があり、これを使って鍵のペアを生成したいので、パラメータデフォルト値を使いたくないとしましょう。

KeyPairGenerator の initialize メソッドを呼び出すかわりに、KeyPairGenerator.getInstance から獲得した KeyPairGenerator オブジェクトを適切なインタフェースにキャストします。このサンプルケースでは、「DSA」 アルゴリズムの鍵のペア生成子を要求します。このようなアルゴリズムは、DSAKeyPairGenerator インタフェースを (java.security.interfaces から) 実装します。従って、生成子を DSAKeyPairGenerator に対してキャストしたあとで、インタフェースから initialize メソッドを呼び出して DSA 特定パラメータを指定することができます。

DSA 特定パラメータをグループ分けするための、java.security.interfaces.DSAParams インタフェースがあります。DSAKeyPairGenerator の initialize メソッドは、次の 2 つの引数を取ります。つまり、p、 q、および g パラメータを指定する DSAParams オブジェクトと、ランダム性のソースである SecureRandom オブジェクトです。前者の引数を構築するには、DSAParams インタフェースを実装する単純クラスのインスタンスを構築してから、BigInteger オブジェクトとして表される p、q、および g パラメータをこれに渡します。後者の引数の場合、アルゴリズム独立型メソッドと同じコードを使ってランダム性のソースを指定します。DSAParams を実装するクラス名が DSAParamsClass と仮定し、以下のようにして鍵のペア生成子を初期化します: 

    DSAParams dsaParams = new DSAParams(p, q, g);
    DSAKeyPairGenerator dsaKeyGen = (DSAKeyPairGenerator)keyGen;
    dsaKeyGen.initialize(dsaParams, new SecureRandom(userSeed));
(注意: 名前が p のパラメータは、長さがモジュラスのプライム数値です。従って、モジュラス長を指定するために他のメソッドを呼び出す必要はありません。)

鍵のペアの生成

最終ステップは、鍵のペアの生成です。使用した初期化の型 (アルゴリズム独立型またはアルゴリズム特定型) に関係なく、同じコードを使って鍵のペアを生成します。 
    KeyPair pair = keyGen.generateKeyPair();

署名の生成

まず最初に署名オブジェクトを生成します。 

    Signature dsa = Signature.getInstance("DSA");

次に 鍵のペアの例で生成した鍵のペアを使い、秘密鍵を指定してオブジェクトを初期化します。この後でdata というバイト配列に署名を付けます。 

    /* Initializing the object with a private key */
    PrivateKey priv = pair.getPrivate();
    dsa.initSign(priv);

    /* Update and sign the data */
    dsa.update(data);
    byte[] sig = dsa.sign();

署名の検証

署名の検証は簡単です。(注意: ここでも、 鍵のペアの例で生成した鍵のペアを使います)。 

    /* Initializing the object with the public key */
    PublicKey pub = pair.getPublic();
    dsa.initVerify(pub);

    /* Update and verify the data */
    dsa.update(data);
    boolean verifies = dsa.verify(sig);
    System.out.println("signature verifies: " + verifies);

付録 A: 標準名

「Java セキュリティ API」は様々なアルゴリズム、埋込みスキーム、プロバイダなどの標準名を必要とし、これらを使用します。ここに記載の仕様は、標準名として以下の名前を確立するものです。アルゴリズムの仕様については、付録 B を参照してください。

SHA-1 (および SHA): セキュアハッシュアルゴリズム、セキュアハッシュ標準 NIST FIPS 180-1 で定義

MD5: メッセージダイジェストアルゴリズム RSA-MD5、RFC 1321 の RSA DSI で定義

MD2: メッセージダイジェストアルゴリズム RSA-MD2、RFC 1423 の RSA DSI で定義

RawDSA: NIST FIPS 186 に記載の非対称変換、ダイジェストの生成の前で 「DSA 署名オペレーション」 および 「DSA 検証オペレーション」 として説明。RawDSA への入力は必ず 20 バイトの長さ。

RSA: Rivest, Shamir and Adleman AsymmetricCipher アルゴリズム、RSA Laboratory のテクニカルノート PKCS#1 で RSA 暗号として定義。

DSA: デジタル署名アルゴリズム、デジタル署名標準 NIST FIPS 186 で定義。この標準は、RawDSA 非対称変換と SHA-1 メッセージダイジェストアルゴリズムを併用するデジタル署名アルゴリズムを定義します。

MD5/RSA: RSA AsymmetricCipher アルゴリズムと MD5 MessageDigest アルゴリズムを組み合わせた Signature アルゴリズム。

MD2/RSA: RSA AsymmetricCipher アルゴリズムと MD2 MessageDigest アルゴリズムを組み合わせた Signature アルゴリズム。

SHA-1/RSA: RSA AsymmetricCipher アルゴリズムと SHA-1 MessageDigest アルゴリズムを組み合わせた Signature アルゴリズム。

DES: データ暗号化標準、NIST の FIPS 46-1 および 46-2 で定義。

IDEA: 国際データ暗号化アルゴリズム (IDEA)、スイスの ASCOM Systec によるもの。

RC2: RSA DSI が独占権を持つ SymmetricCipher アルゴリズム。

RC4: RSA DSI が独占権を持つ SymmetricCipher アルゴリズム。

付録 B: アルゴリズム

この付録では、付録 A で定義したいくつかのアルゴリズムに関する詳細を示します。一覧されているアルゴリズムの実装を与えるプロバイダは、この付録の仕様に従うことが必要です。 注意: このドキュメントの最新バージョンは、JavaSoft の公開 Web サイトから入手できます。

ここに記載のない新しいアルゴリズムを追加するには、まず最初にプロバイダパッケージの供給先に問い合わせて、該当アルゴリズムが追加済みでないかどうかを確認します。既に追加されている場合は、可能であれば開示されている定義を使います。まだ追加されていない場合は、アルゴリズムの仕様を添えて、この付録 B に記載のテンプレートに類似した使用可能なテンプレートを作成します。

仕様テンプレート

以下のアルゴリズム仕様には、次のフィールドが含まれます。

名前

アルゴリズムの認識名。これは、既存のアルゴリズムオブジェクト名を判別するために、(アルゴリズムの要求時に) getInstance メソッドに渡される名前で、getAlgorithm メソッドによって返されます。この 2 つのメソッドは、次の関連エンジンクラス内にあります:。 Signature, MessageDigest, and KeyPairGenerator.

型

アルゴリズムの型: Signature, MessageDigest, または KeyPairGenerator

記述

アルゴリズムに関する一般的なメモ。アルゴリズム、該当する特許権などが実装する標準も含みます。

KeyPair アルゴリズム (オプション指定)

このアルゴリズムの keypair アルゴリズム

強度 (オプション指定)

鍵のアルゴリズムや鍵生成アルゴリズムの場合: 鍵生成や鍵初期化の正しい強度

パラメータのデフォルト値 (オプション指定)

鍵生成アルゴリズムの場合: デフォルトのパラメータ値

Signature フォーマット (オプション指定)

Signature アルゴリズムの場合: 署名のフォーマット。つまり、検証メソッドの入力と署名メソッドの出力。

アルゴリズムの仕様

SHA-1 メッセージダイジェストアルゴリズム

名前: SHA-1

型: MessageDigest

説明: NIST の FIPS 180-1 で定義したメッセージダイジェストアルゴリズム。このアルゴリズムの出力は 160 ビットのダイジェストです。「SHA」 という用語が頻繁に使われますが、これは SHA-1 を意味します。FIPS 180 で開示した最初の SHA は、現在は使われていません。このアルゴリズムの正しい Java 暗号化アーキテクチャ名は SHA-0 です。

MD2 メッセージダイジェストアルゴリズム

名前: MD2

型: MessageDigest

説明: RFC 1319 で定義したメッセージダイジェストアルゴリズム。このアルゴリズムの出力は 128 ビット (16 バイト) のダイジェストです。

MD5 メッセージダイジェストアルゴリズム

名前: MD5

型: MessageDigest

説明: RFC 1321 で定義したメッセージダイジェストアルゴリズム。このアルゴリズムの出力は 128 ビット (16 バイト) のダイジェストです。

デジタル署名アルゴリズム

名前: DSA

型: Signature

説明: このアルゴリズムは、NIST FIPS 186 に記述の署名アルゴリズムです。DSA は SHA-1 メッセージダイジェストアルトリズムを使います。

KeyPair アルゴリズム: DSA

署名フォーマット: 2 つの ASN.1 INTEGER 値の DER シーケンス r および s (この順序): SEQUENCE ::= { r INTEGER, s INTEGER }

RSA ベースの署名アルゴリズム、MD2, MD5 または SHA-1 を使用

名前: MD2/RSA, MD5/RSA および SHA-1/RSA

型: Signature

説明: それぞれに MD2, MD5, および SHA-1 メッセージアルゴリズムを RSA 暗号化と一緒に使う署名アルゴリズムです。

KeyPair アルゴリズム: RSA

署名フォーマット: RSA Laboratory の公開鍵暗号化標準ノート #1 で定義の DER コード化 PKCS#1 ブロック。暗号化データは署名付きデータのダイジェストです。

DSA KeyPair 生成アルゴリズム

名前: DSA

型: KeyPairGenerator

説明: このアルゴリズムは、DSA 対応 NIST FIPS 186 に記載の鍵のペア生成アルゴリズムです。

強度: モジュラス p の長さ (ビット単位)。512 以上で 8 の倍数の任意の整数にできます。

パラメータのデフォルト値: 以下のデフォルトのパラメータ値は、512、768、および 1024 ビットの強度用に使います。

512 ビットの鍵パラメータ
SEED = b869c82b 35d70e1b 1ff91b28 e37a62ec dc34409b

counter = 123

p = fca682ce 8e12caba 26efccf7 110e526d b078b05e decbcd1e b4a208f3
    ae1617ae 01f35b91 a47e6df6 3413c5e1 2ed0899b cd132acd 50d99151
    bdc43ee7 37592e17

q = 962eddcc 369cba8e bb260ee6 b6a126d9 346e38c5
	 
g = 678471b2 7a9cf44e e91a49c5 147db1a9 aaf244f0 5a434d64 86931d2d
    14271b9e 35030b71 fd73da17 9069b32e 2935630e 1c206235 4d0da20a
    6c416e50 be794ca4
768 ビットの鍵パラメータ
SEED = 77d0f8c4 dad15eb8 c4f2f8d6 726cefd9 6d5bb399

counter = 263

p = e9e64259 9d355f37 c97ffd35 67120b8e 25c9cd43 e927b3a9 670fbec5
    d8901419 22d2c3b3 ad248009 3799869d 1e846aab 49fab0ad 26d2ce6a
    22219d47 0bce7d77 7d4a21fb e9c270b5 7f607002 f3cef839 3694cf45
    ee3688c1 1a8c56ab 127a3daf

q = 9cdbd84c 9f1ac2f3 8d0f80f4 2ab952e7 338bf511

g = 30470ad5 a005fb14 ce2d9dcd 87e38bc7 d1b1c5fa cbaecbe9 5f190aa7
    a31d23c4 dbbcbe06 17454440 1a5b2c02 0965d8c2 bd2171d3 66844577
    1f74ba08 4d2029d8 3c1c1585 47f3a9f1 a2715be2 3d51ae4d 3e5a1f6a
    7064f316 933a346d 3f529252
1024 ビットの鍵パラメータ
SEED = 8d515589 4229d5e6 89ee01e6 018a237e 2cae64cd

counter = 92

p = fd7f5381 1d751229 52df4a9c 2eece4e7 f611b752 3cef4400 c31e3f80
    b6512669 455d4022 51fb593d 8d58fabf c5f5ba30 f6cb9b55 6cd7813b
    801d346f f26660b7 6b9950a5 a49f9fe8 047b1022 c24fbba9 d7feb7c6
    1bf83b57 e7c6a8a6 150f04fb 83f6d3c5 1ec30235 54135a16 9132f675
    f3ae2b61 d72aeff2 2203199d d14801c7

q = 9760508f 15230bcc b292b982 a2eb840b f0581cf5
	 
p = f7e1a085 d69b3dde cbbcab5c 36b857b9 7994afbb fa3aea82 f9574c0b
    3d078267 5159578e bad4594f e6710710 8180b449 167123e8 4c281613
    b7cf0932 8cc8a6e1 3c167a8b 547c8d28 e0a3ae1e 2bb3a675 916ea37f
    0bfa2135 62f1fb62 7a01243b cca4f1be a8519089 a883dfe1 5ae59f06
    928b665e 807b5525 64014c3b fecf492a

RSA KeyPair 生成アルゴリズム

名前: RSA

型: KeyPairGenerator

説明: このアルゴリズムは、PKCS#1 に記載の鍵のペア生成アルゴリズムです。

強度: 512 以上で 8 の倍数の任意の整数。

Copyright (C) 1996, 1997 Sun Microsystems, Inc., 2550 Garcia Ave., Mtn. View, CA 94043-1100 USA. All rights reserved.

ご意見は java-security@java.sun.com までお寄せください。