compact1, compact2, compact3

java.security

クラスKeyFactory

java.lang.Object

java.security.KeyFactory

public class KeyFactory
extends Object

鍵ファクトリは、Key型の不透明な暗号鍵である鍵と、基本の鍵データの透明な表現である鍵仕様との間の変換を行うために使用します。

鍵ファクトリは、双方向性があります。つまり、指定した鍵仕様(鍵データ)から不透明な鍵オブジェクトを構築することも、適切な形式で鍵オブジェクトの基本の鍵データを取り出すこともできます。

同一の鍵に対して、複数の互換性のある鍵仕様が存在することがあります。たとえばDSA公開鍵は、DSAPublicKeySpecまたはX509EncodedKeySpecを使って指定できます。鍵ファクトリは、互換性のある鍵仕様間の変換に使用できます。

次に、鍵ファクトリを使って、DSA公開鍵を符号化した状態からインスタンスを生成する方法の例を示します。AliceがBobからデジタル署名を受け取ったとします。Bobは、彼の署名を検証するための符号化形式の公開鍵も送りました。Aliceは、これらを次のように処理します。

 X509EncodedKeySpec bobPubKeySpec = new X509EncodedKeySpec(bobEncodedPubKey);
 KeyFactory keyFactory = KeyFactory.getInstance("DSA");
 PublicKey bobPubKey = keyFactory.generatePublic(bobPubKeySpec);
 Signature sig = Signature.getInstance("DSA");
 sig.initVerify(bobPubKey);
 sig.update(data);
 sig.verify(signature);
 

Javaプラットフォームの実装は、すべて次の標準のKeyFactoryアルゴリズムをサポートする必要があります。

• DiffieHellman
• DSA
• RSA

これらのアルゴリズムについては、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのKeyFactoryのセクションで説明されています。サポートされているその他のアルゴリズムについては、実装のリリース・ドキュメントを参照してください。

導入されたバージョン:

1.2

関連項目:

Key, PublicKey, PrivateKey, KeySpec, DSAPublicKeySpec, X509EncodedKeySpec

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

コンストラクタ

修飾子	コンストラクタと説明
protected	KeyFactory(KeyFactorySpi keyFacSpi, Provider provider, String algorithm) KeyFactoryオブジェクトを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
PrivateKey	generatePrivate(KeySpec keySpec) 指定された鍵仕様(鍵データ)から非公開鍵オブジェクトを生成します。
PublicKey	generatePublic(KeySpec keySpec) 指定された鍵仕様(鍵データ)から公開鍵オブジェクトを生成します。
String	getAlgorithm() このKeyFactoryに関連したアルゴリズムの名前を取得します。
static KeyFactory	getInstance(String algorithm) 指定のアルゴリズムの公開鍵または非公開鍵を変換するKeyFactoryオブジェクトを返します。
static KeyFactory	getInstance(String algorithm, Provider provider) 指定のアルゴリズムの公開鍵または非公開鍵を変換するKeyFactoryオブジェクトを返します。
static KeyFactory	getInstance(String algorithm, String provider) 指定のアルゴリズムの公開鍵または非公開鍵を変換するKeyFactoryオブジェクトを返します。
<T extends KeySpec> T	getKeySpec(Key key, Class<T> keySpec) 指定された鍵オブジェクトの仕様(鍵データ)を返します。
Provider	getProvider() この鍵ファクトリ・オブジェクトのプロバイダを返します。
Key	translateKey(Key key) プロバイダが未知であるか、信頼できない可能性がある鍵オブジェクトを、この鍵ファクトリの対応する鍵オブジェクトに変換します。

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

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

コンストラクタの詳細

KeyFactory

protected KeyFactory(KeyFactorySpi keyFacSpi,
                     Provider provider,
                     String algorithm)

KeyFactoryオブジェクトを作成します。

パラメータ:

keyFacSpi - 委譲先

provider - プロバイダ

algorithm - このKeyFactoryに関連付けるアルゴリズムの名前

メソッドの詳細

getInstance

public static KeyFactory getInstance(String algorithm)
                              throws NoSuchAlgorithmException

指定のアルゴリズムの公開鍵または非公開鍵を変換するKeyFactoryオブジェクトを返します。

このメソッドは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。指定されたアルゴリズムをサポートする最初のProviderのKeyFactorySpi実装をカプセル化する新しいKeyFactoryオブジェクトが返されます。

登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。

パラメータ:

algorithm - 要求される鍵アルゴリズムの名前。アルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのKeyFactoryのセクションを参照。

戻り値:

新しいKeyFactoryオブジェクト。

例外:

NoSuchAlgorithmException - 指定されたアルゴリズムのKeyFactorySpi実装をサポートするProviderが存在しない場合。

関連項目:

Provider

getInstance

public static KeyFactory getInstance(String algorithm,
                                     String provider)
                              throws NoSuchAlgorithmException,
                                     NoSuchProviderException

指定のアルゴリズムの公開鍵または非公開鍵を変換するKeyFactoryオブジェクトを返します。

指定されたプロバイダのKeyFactorySpi実装をカプセル化する新しいKeyFactoryオブジェクトが返されます。指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。

登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。

パラメータ:

algorithm - 要求される鍵アルゴリズムの名前。アルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのKeyFactoryのセクションを参照。

provider - プロバイダ名。

戻り値:

新しいKeyFactoryオブジェクト。

例外:

NoSuchAlgorithmException - 指定されたプロバイダに指定されたアルゴリズムのKeyFactorySpi実装がない場合。

NoSuchProviderException - 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合。

IllegalArgumentException - プロバイダ名がnullまたは空の場合。

関連項目:

Provider

getInstance

public static KeyFactory getInstance(String algorithm,
                                     Provider provider)
                              throws NoSuchAlgorithmException

指定のアルゴリズムの公開鍵または非公開鍵を変換するKeyFactoryオブジェクトを返します。

指定されたProviderオブジェクトのKeyFactorySpi実装をカプセル化する新しいKeyFactoryオブジェクトが返されます。指定されたProviderオブジェクトは、プロバイダ・リストに登録する必要はありません。

パラメータ:

algorithm - 要求される鍵アルゴリズムの名前。アルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのKeyFactoryのセクションを参照。

provider - プロバイダ。

戻り値:

新しいKeyFactoryオブジェクト。

例外:

NoSuchAlgorithmException - 指定されたProviderオブジェクトに指定されたアルゴリズムのKeyFactorySpi実装がない場合。

IllegalArgumentException - 指定されたプロバイダがnullの場合。

導入されたバージョン:

1.4

関連項目:

Provider

getProvider

public final Provider getProvider()

この鍵ファクトリ・オブジェクトのプロバイダを返します。

戻り値:

この鍵ファクトリ・オブジェクトのプロバイダ

getAlgorithm

public final String getAlgorithm()

このKeyFactoryに関連したアルゴリズムの名前を取得します。

戻り値:

このKeyFactoryに関連付けられたアルゴリズムの名前

generatePublic

public final PublicKey generatePublic(KeySpec keySpec)
                               throws InvalidKeySpecException

指定された鍵仕様(鍵データ)から公開鍵オブジェクトを生成します。

パラメータ:

keySpec - 公開鍵の仕様(鍵データ)。

戻り値:

公開鍵。

例外:

InvalidKeySpecException - 指定された鍵仕様がこの鍵ファクトリによる公開鍵の生成に不適切な場合。

generatePrivate

public final PrivateKey generatePrivate(KeySpec keySpec)
                                 throws InvalidKeySpecException

指定された鍵仕様(鍵データ)から非公開鍵オブジェクトを生成します。

パラメータ:

keySpec - 非公開鍵の仕様(鍵データ)。

戻り値:

非公開鍵。

例外:

InvalidKeySpecException - 指定された鍵仕様がこの鍵ファクトリによる非公開鍵の生成に不適切な場合。

getKeySpec

public final <T extends KeySpec> T getKeySpec(Key key,
                                              Class<T> keySpec)
                                       throws InvalidKeySpecException

指定された鍵オブジェクトの仕様(鍵データ)を返します。keySpecは、鍵のデータが返されるべき仕様クラスを識別します。たとえば、DSAPublicKeySpec.classは、鍵のデータがDSAPublicKeySpecクラスのインスタンスに返されるべきであることを指示します。

型パラメータ:

T - 返される鍵仕様の型

パラメータ:

key - 鍵。

keySpec - 鍵データが返される仕様クラス。

戻り値:

要求される仕様クラスのインスタンスにおける基本の鍵仕様(鍵データ)。

例外:

InvalidKeySpecException - 要求される鍵仕様が指定された鍵に不適切な場合、または認識されないアルゴリズムや形式の鍵を指定した場合など、指定された鍵を処理できない場合。

translateKey

public final Key translateKey(Key key)
                       throws InvalidKeyException

プロバイダが未知であるか、信頼できない可能性がある鍵オブジェクトを、この鍵ファクトリの対応する鍵オブジェクトに変換します。

パラメータ:

key - プロバイダが未知であるか、信頼できない鍵。

戻り値:

変換した鍵。

例外:

InvalidKeyException - 指定された鍵をこの鍵ファクトリで処理できない場合。