機械翻訳について

jarsignerコマンド

名前

jarsigner - Java Archive (JAR)ファイルに署名して確認

シノプシス

jarsigner [options] jar-file alias

jarsigner -verify [options] jar-file [alias ...]

jarsigner -version

options
コマンド行オプション。 「jarsignerのオプション」を参照してください。
-verify

-verifyオプションでは、JARファイル名の後に0個以上のキーストア別名を指定できます。 -verifyオプションを指定すると、jarsignerコマンドは、JARファイル内の個々の署名済エントリを検証するために使用された証明書がいずれかのキーストア別名と一致するかどうかを確認します。 別名は、-keystoreで指定されたキーストアまたはデフォルトのキーストアで定義されています。

-strictオプションも指定した場合は、jarsignerコマンドで重大な警告が検出されると、「jarは検証されました - 署名者エラーがあります。」というメッセージが表示されます。

jar-file

署名が付けられるJARファイルです。

-strictオプションも指定した場合は、jarsignerコマンドで重大な警告が検出されると、「jar signed, with signer errors」というメッセージが表示されます。

alias
別名は、-keystoreで指定されたキーストアまたはデフォルトのキーストアで定義されています。
-version
-versionオプションは、プログラム・バージョンのjarsignerを出力します。

説明

jarsignerツールの目的は次の2つです。

JAR機能を使用すると、クラス・ファイル、イメージ、サウンドおよびその他のデジタル・データを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。 開発者は、jarという名前のツールを使用してJARファイルを作成できます。 (技術的な観点から言えば、ZIPファイルはいずれもJARファイルとみなすこともできます。ただし、jarコマンドによって作成されたJARファイル、またはjarsignerコマンドによって処理されたJARファイルには、META-INF/MANIFEST.MFファイルも含まれています。)

デジタル署名は、なんらかのデータ(署名の対象となるデータ)と、エンティティ(人、会社など)の秘密キーとに基づいて計算されるビット列です。 手書きの署名と同様に、デジタル署名には多くの利点があります。

ファイルに対してエンティティの署名を生成するには、まず、エンティティは、そのエンティティに関連する公開キーと秘密キーのペアを持つ必要があります。また、公開キーを認証する1つまたは複数の証明書も必要です。 証明書とは、あるエンティティが発行したデジタル署名付きの文書であり、別のエンティティの公開キーが特定の値であることを証明しています。

jarsignerコマンドは、キーストアに含まれるキーと証明書情報を使用して、JARファイルのデジタル署名を生成します。 キーストアは、秘密キーとそれに関連するX.509証明書チェーン(対応する公開キーを認証する)が格納されたデータベースです。 キーストアの作成と管理には、keytoolコマンドを使用します。

jarsignerコマンドは、エンティティの秘密キーを使用して署名を生成します。 署名付きJARファイルには、ファイルの署名に使用する秘密キーに対応する公開キーを保存するキーストアから取った証明書のコピーも含まれています。 jarsignerコマンドは、署名付きJARファイルのデジタル署名を、ファイル内(の署名ブロック・ファイル)に含まれている証明書を使用して検証できます。

jarsignerコマンドはタイムスタンプを含む署名を生成できるので、システムやデプロイヤはJARファイルが署名証明書の有効期間中に署名されたかどうかをチェックできます。

さらに、アプリケーションはAPIを使用してタイムスタンプ情報を取得できます。

現時点では、jarsignerコマンドで署名できるのは、jarコマンドで作成されたJARファイルまたはZIPファイルのみです。 JARファイルはzipファイルと同じですが、JARファイルにはMETA-INF/MANIFEST.MFファイルが含まれている点が異なります。 META-INF/MANIFEST.MFファイルは、jarsignerコマンドがzipファイルに署名を付けるときに作成されます。

デフォルトでは、jarsignerコマンドはJARまたはzipファイルに署名を付けます。 署名付きJARファイルを検証する場合は、-verifyオプションを使用します。

また、jarsignerコマンドは、署名または検証後に署名者の証明書の検証も試みます。 -revCheckオプションが指定されている場合、検証時に署名者証明書チェーン内の各証明書の失効ステータスがチェックされます。 検証エラーやその他の問題が発生した場合は、コマンドによって警告メッセージが生成されます。 -strictオプションを指定した場合は、コマンドで重大な警告がエラーとして処理されます。 エラーと警告」を参照してください。

キーストアの別名

キーストアのすべてのエントリは、一意の別名を使用してアクセスされます。

jarsignerコマンドを使用してJARファイルに署名を付けるときは、署名の生成に必要な秘密キーを含むキーストア・エントリの別名を指定する必要があります。 出力ファイルが指定されていない場合は、元のJARファイルを署名付きJARファイルで上書きします。

キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。 コマンド行で指定しないと、入力を求められます。 同様に、秘密鍵はパスワードのあるキーストアで保護されるため、コマンドラインで指定しない場合はパスワードの入力を求めるプロンプトが表示され、ストア・パスワードと同じではありません。

キーストアの場所

jarsignerコマンドには、使用するキーストアのURLを指定する-keystoreオプションがあります。 キーストアは、デフォルトではユーザーのホーム・ディレクトリの.keystoreという名前のファイルに格納されます。ユーザーのホーム・ディレクトリは、user.homeシステム・プロパティによって決まります。

LinuxおよびOS X: user.homeのデフォルトはユーザー・ホーム・ディレクトリです。

-keystoreオプションからの入力ストリームは、KeyStore.loadメソッドに渡されます。 URLとしてNONEが指定されている場合は、nullのストリームがKeyStore.loadメソッドに渡されます。 NONEは、KeyStoreクラスがファイルベースではなく、たとえば、ハードウェア・トークン・デバイスに置かれている場合に指定してください。

キーストアの実装

java.securityパッケージで提供されるKeyStoreクラスには、キーストア内の情報に対するアクセスと変更を行うための明確に定義されたインタフェースが用意されています。 複数の異なる固定実装を生成できます(それぞれ特定のタイプのキーストアを実装)。

現在、キーストアの実装を使用するものとして、2つのコマンド行ツール(keytooljarsigner)があります。

デフォルトのキーストアの実装はPKCS12です。 これは、RSA PKCS12 Personal Information Exchange Syntax Standardに基づくクロス・プラットフォーム・キーストアです。 この規格は、ユーザーの秘密キー、証明書、その他の秘密を格納および転送することを主な目的としています。 Oracleが提供する組み込みの実装がもう1つあります。 これは、JKSという独自のキーストア・タイプ(形式)を使用してキーストアをファイルとして実装します。 この実装では、個々の秘密キーは個別のパスワードによって保護され、キーストア全体の整合性も(秘密キーとは別の)パスワードによって保護されます。

キーストアの実装はプロバイダベースです。つまり、KeyStoreクラスが提供するアプリケーション・インタフェースは、Service Provider Interface (SPI)という形で実装されています。 対応するKeystoreSpi抽象クラス(これもjava.securityパッケージ内)があり、プロバイダが実装する必要があるService Provider Interfaceメソッドを定義しています。 ここで、プロバイダとは、Java Security APIによってアクセス可能なサービスのサブセットに対して、その固定実装を提供するパッケージまたはパッケージの集合のことです。 キーストアの実装を提供するには、「Java暗号化アーキテクチャでのプロバイダの実装方法」で説明されているように、クライアントがプロバイダを実装し、KeystoreSpiサブクラスの実装を提供する必要があります。

アプリケーションでは、KeyStoreクラスのgetInstanceファクトリ・メソッドを使用することで、様々なプロバイダから異なるタイプのキーストア実装を選択できます。 キーストアのタイプは、キーストア情報のストレージ形式とデータ形式を定義するとともに、キーストア内の秘密キーとキーストア自体の整合性を保護するために使われるアルゴリズムを定義します。 異なるタイプのキーストアの実装には、互換性はありません。

jarsignerコマンドは、URLを使用して指定可能な任意の場所からファイルベースのキーストアを読み取ることができます。 さらに、これらのコマンドは、WindowsではMSCAPI、すべてのプラットフォームではPKCS11によって提供されるキーストアなどのファイルベースではないキーストアも読み取ることができます。

jarsignerおよびkeytoolコマンドの場合は、-storetypeオプションを使用してコマンド行でキーストアのタイプを指定できます。

キーストアのタイプを明示的に指定しなかった場合、ツールはセキュリティ・プロパティ・ファイル内で指定されたkeystore.typeプロパティの値に基づいてキーストア実装を選択します。 セキュリティ・プロパティ・ファイルは、java.securityという名前で、JDKのセキュリティ・プロパティ・ディレクトリjava.home/conf/securityにあります。

各ツールは、keystore.type値を取得してから、インストールされているすべてのプロバイダを調べてそのタイプのキーストアを実装しているものを見つけます。 目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。

KeyStoreクラスには、アプリケーションがkeystore.typeプロパティの値を取得するためのgetDefaultTypeという名前のstaticメソッドが定義されています。 次のコード行は、keystore.typeプロパティで指定されたデフォルトのキーストア・タイプのインスタンスを生成します。

KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());

デフォルトのキーストア・タイプは、pkcs12で、RSA PKCS12 Personal Information Exchange Syntax Standardに基づいたクロス・プラットフォーム・キーストアです。 これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。

keystore.type=pkcs12

キーストア・タイプの指定では、大文字と小文字は区別されません。 たとえば、JKSjksは同じです。

各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。 たとえば、Oracleのjksキーストアの実装を使用する場合は、行を次のとおり変更します。

keystore.type=jks

サポートされるアルゴリズム

デフォルトでは、jarsignerコマンドは、秘密キーのタイプおよびサイズに応じて、次のいずれかのアルゴリズムおよびブロック・ファイル拡張子を使用してJARファイルに署名します:

keyalg keysize デフォルトのsigalg ブロック・ファイル拡張子
DSA 任意のサイズ SHA256withDSA .DSA
RSA <= 3072 SHA256withRSA .RSA
<= 7680 SHA384withRSA
> 7680 SHA512withRSA
EC < 384 SHA256withECDSA .EC
< 512 SHA384withECDSA
= 512 SHA512withECDSA
RSASSA-PSS <= 3072 RSASSA-PSS (SHA-256を使用) .RSA
<= 7680 RSASSA-PSS (SHA-384を使用)
> 7680 RSASSA-PSS (SHA-512を使用)
EdDSA 255 Ed25519 .EC
448 Ed448

これらのデフォルトの署名アルゴリズムは、-sigalgオプションを使用してオーバーライドできます。

jarsignerコマンドは、jdk.jar.disabledAlgorithmsおよびjdk.security.legacyAlgorithmsセキュリティ・プロパティを使用して、セキュリティ・リスクとみなされるアルゴリズムを決定します。 JARファイルが無効になっているアルゴリズムで署名されていると、署名されていないJARファイルとして扱われます。 JARファイルがレガシー・アルゴリズムで署名されている場合、今後の更新でレガシー・アルゴリズムが無効になることをユーザーに通知するために、情報警告付きで署名済として扱われます。 詳細な検証出力が必要な場合は、-J-Djava.security.debug=jarを指定します。 jdk.jar.disabledAlgorithmsおよびjdk.security.legacyAlgorithmsのセキュリティ・プロパティは、java.securityファイル(JDK $JAVA_HOME/conf/securityディレクトリにあります)で定義されます。

ノート:

初期状態のキーのサイズとシグネチャ・アルゴリズムの名前は、JDKの各リリースで定期的により高い値に更新されます。 JDKの旧リリースとの相互運用性が重要である場合は、デフォルトがそれらのリリースでサポートされていることを確認してください。あるいは、-sigalgオプションを使用して自己責任でデフォルト値をオーバーライドしてください。

署名付きJARファイル

jarsignerコマンドを使用してJARファイルに署名を付けた場合、出力される署名付きJARファイルは入力JARファイルと同じですが、次の2つの追加ファイルがMETA-INFディレクトリに置かれる点が異なります。

これら2つのファイルのベース・ファイル名は、-sigfileオプションの値から作成されます。 たとえば、オプションが-sigfile MKSIGNの場合、ファイルの名前はMKSIGN.SFおよびMKSIGN.RSAになります。 このドキュメントでは、署名者が常にRSAキーを使用することを前提としています。

コマンドラインに-sigfileオプションが表示されない場合、.SFおよびシグネチャ・ブロック・ファイルのベース・ファイル名は、コマンドラインで指定された別名の最初の8文字で、すべて大文字に変換されます。 別名が8文字未満の場合は、別名がそのまま使われます。 別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字をアンダースコア(_)に置き換えてファイル名が作成されます。 有効な文字は、アルファベット、数字、アンダースコア、ハイフンです。

署名ファイル

署名ファイル(.SFファイル)は、jarsignerコマンドで署名を付けたJARファイルに常に含まれるマニフェスト・ファイルと似ています。 マニフェスト・ファイルと同様に、.SFファイルには、JARファイルに含まれているソース・ファイルごとに、次に示す2つの行があります。

ノート:

ダイジェスト・アルゴリズム(SHA)の名前とSHAダイジェストの値は、同じ行に指定されています。

マニフェスト・ファイルでは、SHAダイジェストの値は、ソース・ファイルのバイナリ・データのダイジェスト(ハッシュ)です。 .SFファイルでは、指定されたソース・ファイルのダイジェストの値は、マニフェスト・ファイル中の該当するソース・ファイルに対応する2行のハッシュです。

署名ファイルには、デフォルトでマニフェスト・ファイル全体のハッシュが格納されたヘッダーが含まれています。 ヘッダーには、マニフェスト・ヘッダーのハッシュも格納されています。 ヘッダーが存在すると、検証の最適化が有効になります。 JARファイルの検証」を参照してください。

署名ブロック・ファイル

.SFファイルには署名が付けられ、署名は署名ブロック・ファイルに置かれます。 このファイルには、キーストアからの証明書または証明書チェーンも符号化された形で含まれています。証明書または証明書チェーンは、署名に使われた秘密キーに対応する公開キーを認証します。 ファイルの拡張子は、使用されるキー・アルゴリズムに応じて、.DSA.RSAまたは.ECになります。 「サポートされているアルゴリズム」の表を参照してください。

署名タイムスタンプ

jarsignerコマンドを次のオプションとともに使用すると、JARファイルの署名時に署名タイムスタンプを生成して保存できます。

「jarsignerのオプション」を参照してください。

JARファイルの検証

JARファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後にJARファイル内のどのファイルも変更されていない場合です。 JARファイルの検証は、次のステップで行われます。

  1. .SFファイルの署名を検証します。

    この検証では、各シグネチャ・ブロック・ファイルに格納されているシグネチャが、証明書(証明書チェーン)もシグネチャ・ブロック・ファイルに表示される公開キーに対応する秘密キーを使用して生成されたことを確認します。 また、この手順では、目的の署名が、対応する署名(.SF)ファイル内の有効な署名であるかどうかを調べ、.SFファイルが改ざんされていないことも確認します。

  2. .SFファイル内の各エントリのダイジェストをマニフェスト内の対応する各セクションと突き合わせて検証します。

    .SFファイルには、マニフェスト・ファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。 このヘッダーが存在する場合は、ヘッダー内のハッシュがマニフェスト・ファイルのハッシュと一致するかどうかを検証できます。 一致する場合、検証は次のステップに進みます。

    一致しない場合は、効率的には劣る方法を使用した検証が必要になります。具体的には、.SFファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するかどうかが確認されます。 「署名ファイル」を参照してください。

    .SFファイル・ヘッダーに格納されているマニフェスト・ファイルのハッシュが、現在のマニフェスト・ファイルのハッシュと等しくない理由の1つは、ファイルが署名されたあとに新しく追加されたファイルのセクションが含まれている可能性があるためです。 たとえば、シグネチャ付きのJARファイル(jarツールの使用)に、すでにシグネチャと.SFファイルが含まれている1つ以上のファイルを追加したとします。 JARファイルが別の署名者によって再度署名された場合、マニフェスト・ファイルは(jarsignerツールによって、新しいファイルのセクションが追加されます)に変更され、新しい.SFファイルが作成されますが、元の.SFファイルは変更されません。 元のシグネチャの生成時、JARファイルにあったファイルがすべて変更されていない場合、検証は引き続き成功しているとみなされます。 これは、.SFファイルのヘッダー以外のセクションのハッシュが、マニフェスト・ファイルの対応するセクションのハッシュと一致するためです。

  3. JARファイル内のファイルのうち、.SFファイル内にエントリを持つ各ファイルを読み込みます。 読込み中にファイルのダイジェストを計算し、結果をマニフェスト・セクション内の該当するファイルのダイジェストと比較します。 2つのダイジェストは同じでなければならず、そうでない場合は検証が失敗します。

    検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセスは中止され、セキュリティ例外がスローされます。 jarsignerコマンドは、例外をキャッチして表示します。

  4. 無効になっているアルゴリズムの使用状況を確認します。 「サポートされているアルゴリズム」を参照してください。

ノート:

追加の警告(または、-strictオプションを指定した場合はエラー)はすべて読む必要があります。同様に、証明が信頼できるかを決定するために、(-verboseおよび-certsオプションを指定して)証明書の内容も読む必要があります。

1つのJARファイルを対象とする複数の署名

1つのJARファイルに対してjarsignerコマンドを複数回実行し、実行のたびに、異なるユーザーの別名を指定すれば、JARファイルに複数のユーザーの署名を付けることができます。

jarsigner myBundle.jar susan
jarsigner myBundle.jar kevin

JARファイルが複数回シグネチャされている場合、生成されるJARファイルには複数の.SFおよびシグネチャ・ブロック・ファイルがあり、シグネチャごとにペアになっています。 上の例で出力されるJARファイルには、次の名前を持つファイルが含まれます。

SUSAN.SF
SUSAN.RSA
KEVIN.SF
KEVIN.RSA

jarsignerのオプション

次の各項では、jarsignerのオプションについて説明します。 次の標準に注意してください。

-keystore url

キーストアの場所を示すURLを指定します。 このデフォルトは、ユーザーのホーム・ディレクトリ内のファイル.keystoreです。ユーザーのホーム・ディレクトリは、user.homeシステム・プロパティによって決まります。

署名するときはキーストアが必要です。 デフォルトのキーストアが存在しない場合、あるいはデフォルト以外のキーストアを使用する場合は、キーストアを明示的に指定する必要があります。

検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに-verboseオプションも指定されていた場合、JARファイルの検証に使用される証明書がそのキーストアに1つでも含まれているかどうかに関する追加情報が出力されます。

-keystoreの引数には、URLの代わりにファイル名とパスを指定できます。この場合は、file: URLと同様に処理されます。たとえば、次に示す例は同等です。

  • -keystore filePathAndName

  • -keystore file:filePathAndName

Sun PKCS #11プロバイダがjava.securityセキュリティ・プロパティ・ファイル(JDK $JAVA_HOME/conf/securityディレクトリにあります)で構成されている場合、keytoolおよびjarsignerツールは、次のオプションを指定してPKCS #11トークンを操作できます:

-keystore NONE -storetype PKCS11

たとえば、次のコマンドは、構成されたPKCS#11トークンの内容を一覧表示します。

keytool -keystore NONE -storetype PKCS11 -list

-storepass [:env | :file] argument

キーストアにアクセスするのに必要なパスワードを指定します。 このオプションが必要なのは、JARファイルに署名を付けるときだけです(JARファイルを検証するときは不要)。 その場合、コマンド行で-storepassオプションを指定しないと、パスワードの入力を求められます。

修飾子envまたはfileが指定されていない場合、パスワードの値はargumentです。 それ以外の場合、パスワードは次のように取得されます。

  • env: argumentという名前の環境変数からパスワードを取得します。

  • file: argumentという名前のファイルからパスワードを取得します。

ノート:

テストを目的とする場合、またはセキュアなシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。

-storetype storetype

インスタンスを生成するキーストアのタイプを指定します。 デフォルトのキーストア・タイプは、セキュリティ・プロパティ・ファイル内のkeystore.typeプロパティの値で指定されたタイプです。この値は、java.security.KeyStoreのstatic getDefaultTypeメソッドで返されます。

-storepassオプションを使用してPKCS #11トークンのPINを指定することもできます。 何も指定されない場合は、keytoolおよびjarsignerコマンドでトークンPINの入力を求められます。 トークンに保護された認証パス(専用のPINパッドや生体読取り機など)がある場合、-protectedオプションを指定する必要がありますが、パスワード・オプションを指定する必要はありません。

-keypass [:env | :file] argument -certchain file

コマンド行で指定された別名に対応するキーストア・エントリの秘密キーを保護するのに使うパスワードを指定します。 jarsignerを使ってJARファイルに署名を付けるときは、パスワードが必要です。 コマンド行でパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。

修飾子envまたはfileが指定されていない場合、パスワードの値はargumentです。 それ以外の場合、パスワードは次のように取得されます。

  • env: argumentという名前の環境変数からパスワードを取得します。

  • file: argumentという名前のファイルからパスワードを取得します。

ノート:

テストを目的とする場合、またはセキュアなシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。

-certchain file
コマンド行で指定された別名で決まるキーストア・エントリの秘密キーに関連付けられた証明書チェーンが完全でない場合に使用される証明書チェーンを指定します。 このような状態になる可能性があるのは、キーストアがハードウェア・トークン上に格納されているが、そこには証明書チェーンの全体を保持するための十分な領域がない場合です。 このファイルは連結された一連のX.509証明書か、PKCS#7形式の単一データ・ブロックのいずれかであり、そのエンコーディング形式はバイナリ・エンコーディング形式、インターネットRFC 1421証明書エンコーディング規格で規定される印刷可能エンコーディング形式(Base64エンコーディングとも呼ばれる)のいずれかです。
-sigfile file

生成された.SFおよびシグネチャ・ブロック・ファイルに使用するベース・ファイル名を指定します。 たとえば、ファイルがDUKESIGNの場合、生成された.SFおよびシグネチャ・ブロック・ファイルはDUKESIGN.SFおよびDUKESIGN.RSAという名前で、シグネチャ付きJARファイルのMETA-INFディレクトリに配置されます。

fileに使用できる文字はa-zA-Z0-9_-です。 文字、数字、アンダースコアおよびハイフンのみを使用できます。 .SFおよびシグネチャ・ブロック・ファイル名では、すべての小文字が大文字に変換されます。

コマンドラインに-sigfileオプションが表示されない場合、.SFおよびシグネチャ・ブロック・ファイルのベース・ファイル名は、コマンドラインで指定された別名の最初の8文字で、すべて大文字に変換されます。 別名が8文字未満の場合は、別名がそのまま使われます。 別名の中に、署名ファイル名に無効な文字が含まれている場合は、該当する文字をアンダースコア(_)に置き換えてファイル名が作成されます。

-signedjar file
署名付きJARファイルの名前を指定します。
-digestalg algorithm

JARファイルのエントリをダイジェストする際に使用するメッセージ・ダイジェスト・アルゴリズムの名前を指定します。

標準のメッセージ・ダイジェスト・アルゴリズム名のリストは、Javaセキュリティ標準アルゴリズム名を参照してください。

このオプションを指定しなかった場合、SHA256が使用されます。 指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、ユーザーがそれを-addproviderまたは-providerClassオプションを使用して指定する必要があり、そうでない場合はコマンドが成功しません。

-sigalg algorithm

JARファイルの署名に使用する署名アルゴリズムの名前を指定します。

このアルゴリズムは、JARファイルの署名に使用する秘密キーと互換性のあるものでなければなりません。 このオプションを指定しなかった場合、秘密キーと一致するデフォルトのアルゴリズムが使用されます(「サポートされるアルゴリズム」を参照)。 指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、-addproviderまたは-providerClassオプションを使用してそれを指定する必要があり、そうでない場合はコマンドが成功しません。

標準のメッセージ・ダイジェスト・アルゴリズム名のリストは、Javaセキュリティ標準アルゴリズム名を参照してください。

-verify
署名付きJARファイルを検証します。
-verbose [: サブ・オプション]

-verboseオプションがコマンド行に表示されているときは、表示される情報の量を判断するサブ・オプション付きでの署名または確認時に、jarsignerは詳細モードを使用することを示しています。 これにより、jarsignerはJARの署名または検証の進行状況に関する追加情報を出力します。 suboptionsは、allgroupedsummaryのいずれかです。

-certsオプションも指定した場合、デフォルト・モード(またはサブオプションall)では、エントリが処理されるたびにそのエントリが表示され、それに続いてJARファイルの各署名者の証明書情報が表示されます。

-certs-verbose:groupedサブオプションを指定した場合、同じ署名者情報を持つエントリがグループ化され、その証明書情報とともに表示されます。

-certs-verbose:summaryサブオプションを指定した場合、同じ署名者情報を持つエントリがグループ化され、その証明書情報とともに表示されます。

各エントリに関する詳細は、1つ(以上)のエントリとしてまとめて表示されます。 「署名付きJARファイルの検証の例」「証明書情報による検証の例」を参照してください。

-certs

コマンド行で、-verifyおよび-verboseオプションとともに-certsオプションが指定されている場合は、JARファイルの各署名者の証明書情報も出力されます。 この情報には、署名者公開キーを証明する証明書(シグネチャ・ブロック・ファイルに格納されます)のタイプの名前、および証明書がX.509証明書(java.security.cert.X509Certificateのインスタンス)の場合は署名者の識別名が含まれます。

キーストアの確認も行われます。 コマンド行でキーストアの値が指定されていない場合、デフォルトのキーストア・ファイルがあれば、検査されます。 署名者の公開キーの証明書がキーストア内のエントリと一致した場合は、その署名者のキーストア・エントリの別名がカッコ内に表示されます。

-revCheck
このオプションは、JARファイルの署名または検証時に証明書の失効チェックを有効にします。 コマンドラインで-revCheckオプションが指定されている場合、jarsignerコマンドはOCSPレスポンスおよびCRLをフェッチするためのネットワーク接続を試行します。 このオプションを指定しないかぎり、失効チェックは有効になりません。
-tsa url

JARファイルの署名時にコマンド行に-tsa http://example.tsa.urlが表示される場合、署名のタイムスタンプが生成されます。 URL http://example.tsa.urlは、TSA (Time Stamping Authority)の場所を特定し、-tsacertオプションで見つかったURLをオーバーライドします。 -tsaオプションでは、TSAの公開キー証明書がキーストアに配置されている必要はありません。

タイムスタンプを生成するために、jarsignerはRFC 3161で定義されているTSP (Time-Stamp Protocol)を使用してTSAと通信します。 成功すると、TSAから返されたタイムスタンプ・トークンが署名ブロック・ファイルの署名とともに保存されます。

-tsacert alias

JARファイルにシグネチャするときに、-tsacert aliasがコマンド行に表示されると、シグネチャ用のタイムスタンプが生成されます。 aliasは、キーストア内の有効なTSAの公開キー証明書を特定します。 エントリの証明書で、TSAの場所を特定するURLを含むSubject Information Access拡張機能が確認されます。

-tsacertオプションを使用する場合は、TSAの公開キー証明書がキーストアに配置されている必要があります。

-tsapolicyid policyid

TSAサーバーに送信されるポリシーIDを識別するオブジェクト識別子(OID)を指定します。 このオプションを指定しなかった場合、ポリシーIDは送信されず、TSAサーバーではデフォルトのポリシーIDが選択されます。

オブジェクト識別子は、ITU電気通信標準化部門(ITU-T)の規格であるX.696で定義されます。 一般に、これらの識別子は、1.2.3.4などの負ではない数字をピリオドで区切ったセットです。

-tsadigestalg algorithm

TSAサーバーに送信するメッセージ・インプリントを生成するために使用されるメッセージ・ダイジェスト・アルゴリズムを指定します。 このオプションを指定しなかった場合は、SHA-256が使用されます。

「サポートされているアルゴリズム」を参照してください。

標準のメッセージ・ダイジェスト・アルゴリズム名のリストは、Javaセキュリティ標準アルゴリズム名を参照してください。

-internalsf
以前は、JARファイルのシグネチャ時に生成されたシグネチャ・ブロック・ファイルには、.SFファイル(シグネチャ・ファイル)の完全にエンコードされたコピーも含まれていました。 この動作は変更されました。 出力JARファイルの全体的なサイズを小さくするために、シグネチャ・ブロック・ファイルにはデフォルトで.SFファイルのコピーが含まれなくなりました。 コマンド行で-internalsfオプションを指定すると、以前と同じように動作します。 このオプションは、テスト時に役立ちます。 実際には、-internalsfオプションを使用するとオーバーヘッドが増加するため、使用しないでください。
-sectionsonly

コマンド行で-sectionsonlyオプションが指定されている場合、JARファイルの署名時に生成される.SFファイル(署名ファイル)には、マニフェスト・ファイル全体のハッシュを含むヘッダーは追加されません。 このファイルに含まれるのは、JARファイル内の各ソース・ファイルに関する情報およびハッシュのみです。 「署名ファイル」を参照してください。

デフォルトでは、最適化を行うために、このヘッダーが追加されます。 ヘッダーが存在する場合は、JARファイルの検証時に、まずヘッダー内のハッシュがマニフェスト・ファイル全体のハッシュと一致するかどうかを確認できます。 一致する場合、検証が次のステップに進みます。 一致しない場合は、効率的には劣る方法を使用して検証を行います。具体的には、.SFファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するかどうかを確認します。 JARファイルの検証」を参照してください。

-sectionsonlyオプションは、主にテスト時に使用されます。 これを使用するとオーバーヘッドが増加するため、テスト以外では使用しないでください。

-protected
値には、trueまたはfalseを指定できます。 専用PINリーダーなどの保護された認証パスを介してパスワードを指定する必要がある場合は、trueを指定します。
-providerName providerName

java.securityセキュリティ・プロパティ・ファイルに複数のプロバイダが構成された場合は、-providerNameオプションを使用して特定のプロバイダ・インスタンスを選択できます。 このオプションの引数は、プロバイダの名前です。

Oracle PKCS #11プロバイダの場合、providerNameSunPKCS11-TokenNameという形式になります(TokenNameはプロバイダ・インスタンスが構成された名前の接尾辞です。詳細は、構成属性の表を参照してください)。 たとえば、次のコマンドでは、名前接尾辞SmartCardPKCS #11キーストア・プロバイダ・インスタンスの内容を一覧表示します。

jarsigner -keystore NONE -storetype PKCS11 -providerName SunPKCS11-SmartCard -list

-addprovider name [-providerArg arg]

名前(SunPKCS11など)でセキュリティ・プロバイダを追加する他、オプションの構成引数も追加します。 セキュリティ・プロバイダの値はモジュールで定義されているセキュリティ・プロバイダの名前です。

-providerArg ConfigFilePathオプションを付けてkeytoolおよびjarsignerツールを使用すると、プロバイダが動的にインストールされ、トークン構成ファイルへのパスとしてConfigFilePathが使用されます。 次の例では、セキュリティ・プロパティ・ファイル内でOracle PKCS #11プロバイダが構成されていない場合にPKCS #11キーストアをリストするコマンドを示します。

jarsigner -keystore NONE -storetype PKCS11 -addprovider SunPKCS11 -providerArg /mydir1/mydir2/token.config

-providerClass provider-class-name [-providerArg arg]

暗号サービス・プロバイダがjava.securityセキュリティ・プロパティ・ファイルにリストされていない場合に、暗号サービス・プロバイダ・マスター・クラス・ファイルの名前を指定するために使用されます。 完全修飾クラス名でセキュリティ・プロバイダを追加する他、オプションの構成引数も追加します。

ノート:

PKCS11をロードする方法としては、モジュールの使用が推奨されます。 -addproviderを参照してください。

-Jjavaoption
指定されたjavaoption文字列をJavaインタプリタに直接渡します。 jarsignerコマンドは、インタプリタに対するラッパーです。 このオプションには、空白を含めることはできません。 このオプションは、実行環境またはメモリー使用を調整する場合に便利です。 指定できるインタプリタ・オプションを一覧表示するには、コマンド行でjava -hまたはjava -Xと入力してください。
-strict
署名または検証処理中に、コマンドから警告メッセージが発行される場合があります。 このオプションを指定すると、このコマンドで見つかった重大な警告メッセージがツールの終了コードに反映されます。 エラーと警告」を参照してください。
-conf url
事前構成済のオプション・ファイルを指定します。 詳細は、「keytoolのドキュメント」を参照してください。 サポートされているプロパティ・キーは、すべてのアクション用の"jarsigner.all"、署名用の"jarsigner.sign"および検証用の"jarsigner.verify"です。JARファイル名や別名などのjarsigner引数は、このファイルに設定できません。
-version
プログラムのバージョンを印刷します。

非推奨のオプション

次のjarsignerオプションは、JDK 9から非推奨となり、将来のJDKリリースでは削除される可能性があります。

-altsigner class

このオプションには、代替署名メカニズムを指定します。 完全修飾クラス名は、com.sun.jarsigner.ContentSigner抽象クラスを拡張するクラス・ファイルを識別します。 このクラス・ファイルへのパスは、-altsignerpathオプションによって定義されます。 -altsignerオプションが使用されている場合、jarsignerコマンドは指定されたクラスが提供する署名メカニズムを使用します。 それ以外の場合、jarsignerコマンドはデフォルトの署名メカニズムを使用します。

たとえば、com.sun.sun.jarsigner.AuthSignerというクラスが提供する署名メカニズムを使用するには、jarsigner-altsigner com.sun.jarsigner.AuthSignerオプションを使用します。

-altsignerpath classpathlist

クラス・ファイルおよびそれに依存するJARファイルへのパスを指定します。 クラス・ファイル名は、-altsignerオプションで指定します。 クラス・ファイルがJARファイル内にある場合、このオプションではそのJARファイルへのパスが指定されます。

絶対パスまたは現在のディレクトリからの相対パスを指定できます。 classpathlistに複数のパスまたはJARファイルを含める場合、次を使用して区切ります。

  • LinuxおよびmacOS上のコロン(:)

  • セミコロン(;) on Windows

目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。

次の例では、クラス・ファイルを含むJARファイルへのパスを指定する方法を示します。 JARファイル名が含まれています。

-altsignerpath /home/user/lib/authsigner.jar

次の例では、クラス・ファイルを含むJARファイルへのパスを指定する方法を示します。 JARファイル名は省略されています。

-altsignerpath /home/user/classes/com/sun/tools/jarsigner/

エラーおよび警告

署名または検証処理中に、jarsignerコマンドから様々なエラーや警告が発行される場合があります。

エラーが発生した場合、jarsignerコマンドはコード1で終了します。 エラーは発生していないが、1つ以上の重大な警告が発生した場合は、-strictオプションが指定されていなければjarsignerコマンドはコード0で終了し、-strictが指定されていれば、警告コードのOR値で終了します。 情報警告のみが発生した場合や警告がまったく発生しない場合、コマンドは常にコード0で終了します。

たとえば、エントリの署名に使用される証明書の有効期限が切れていて、その証明書のkeyUsage拡張機能でファイルの署名が許可されていない場合は、-strictオプションが指定されていれば、jarsignerコマンドはコード12 (=4+8)で終了します。

ノート: LinuxおよびOS Xでは0から255の値のみが有効であるため、終了コードは再利用されます。

次のセクションでは、jarsignerコマンドが発行できるエラーおよび警告の名前、コードおよび説明を示します。

失敗

jarsignerコマンドに失敗する原因として、コマンド行の解析エラー、JARファイルに署名するキー・ペアが見つからないこと、署名付きJARの検証の失敗などが考えられますが、それだけにかぎりません。

failure
コード1。 署名または検証に失敗しました。

重大な警告

ノート:

-strictオプションを指定した場合、重大な警告はエラーとして報告されます。

jarsignerコマンドで重大な警告が発行される原因として、JARファイルの署名に使用される証明書でエラーが発生したことや、署名付きJARファイルでその他の問題が発生したことが考えられます。

hasExpiredCert
コード4。 このJARには、署名者証明書が失効したエントリが含まれています。
hasExpiredTsaCert
コード4。 タイムスタンプは期限切れになりました。
notYetValidCert
コード4。 このJARには、署名者の証明書がまだ有効になっていないエントリが含まれています。
chainNotValidated
コード4。 このJARには、証明書チェーンが検証されていないエントリが含まれています。
tsaChainNotValidated
コード64。 タイムスタンプが無効です。
signerSelfSigned
コード4。 このJARには、署名者証明書が自己署名されたエントリが含まれています。
disabledAlg
コード4。 使用されるアルゴリズムはセキュリティ・リスクとみなされ、無効になります。
badKeyUsage
コード8。 このJARには、署名者証明書KeyUsage拡張でコード署名が許可されていないエントリが含まれます。
badExtendedKeyUsage
コード8。 このJARには、署名者証明書ExtendedKeyUsage拡張でコード署名が許可されていないエントリが含まれます。
badNetscapeCertType
コード8。 このJARには、署名者証明書NetscapeCertType拡張でコード署名が許可されていないエントリが含まれます。
hasUnsignedEntry
コード16。 このJARには、整合性チェックが行われていない未署名のエントリが含まれています。
notSignedByAlias
コード32。 このJARには、指定した別名(複数可)で署名されていない署名済エントリが含まれています。
aliasNotInStore
コード32。 このJARには、このキーストア内の別名で署名されていない署名済エントリが含まれています。
tsaChainNotValidated
コード64。 このJARには、TSA証明書チェーンが無効になっているエントリが含まれています。

情報警告

情報警告には、エラーではないが、不適切と見なされるものが含まれます。 コードはありません。

extraAttributesDetected
POSIXファイルのアクセス権またはsymlink属性(あるいはその両方)は、JARファイルの署名または検証中に検出されます。 jarsignerツールは、これらの属性を新しくシグネチャされたファイルに保持しますが、これらの属性がシグネチャされておらず、シグネチャによって保護されていないことを警告します。
hasExpiringCert
このJARには、署名者証明書が6か月以内に失効するエントリが含まれています。
hasExpiringTsaCert
タイムスタンプは1年以内のYYYY-MM-DDに期限切れになります。
legacyAlg
使用されるアルゴリズムはセキュリティ・リスクとみなされますが、無効にはなりません。
noTimestamp
このJARには、タイムスタンプがない署名が含まれています。 タイムスタンプがないと、署名者の証明書の有効期限日(YYYY-MM-DD)後や今後の失効日後に、このJARファイルをユーザーが検証できない可能性があります。

JARファイルへの署名の例

キーストアの別名がworkingディレクトリにあるmystoreという名前のキーストア内のjaneであるユーザーの秘密キーを使用してbundle.jarに署名し、署名付きのJARファイルにsbundle.jarという名前を付けるには、次のコマンドを使用します。

jarsigner -keystore /working/mystore -storepass keystore_password -keypass private_key_password -signedjar sbundle.jar bundle.jar jane

前のコマンドでは-sigfileが指定されていないため、シグネチャ付きJARファイルに配置される生成済の.SFおよびシグネチャ・ブロック・ファイルには、別名に基づいたデフォルト名があります。 これらは、JANE.SFおよびJANE.RSAという名前です。

ストアのパスワードおよび秘密キーのパスワードを求めるようにする場合は、上のコマンドを次のように短縮します。

jarsigner -keystore /working/mystore -signedjar sbundle.jar bundle.jar jane

keystoreがデフォルトのkeystore(ホーム・ディレクトリ内の.keystore)である場合は、次に示すように、キーストアを指定する必要がありません。

jarsigner -signedjar sbundle.jar bundle.jar jane

署名付きJARファイルで入力JARファイル(bundle.jar)を上書きする場合は、次に示すように、-signedjarオプションを指定する必要がありません。

jarsigner bundle.jar jane

署名付きJARファイルの検証の例

署名付きJARファイルを検証して、署名が有効であり、JARファイルが改ざんされていないことを確認するには、次のようなコマンドを使用します。

jarsigner -verify ButtonDemo.jar

検証に成功すると、jar verifiedと表示されます。 そうでない場合は、エラー・メッセージが表示されます。 -verboseオプションを使用すると、より多くの情報を取得できます。 -verboseオプションを指定したjarsignerの使用例を次に示します。

jarsigner -verify -verbose ButtonDemo.jar

s       866 Tue Sep 12 20:08:48 EDT 2017 META-INF/MANIFEST.MF
        825 Tue Sep 12 20:08:48 EDT 2017 META-INF/ORACLE_C.SF
       7475 Tue Sep 12 20:08:48 EDT 2017 META-INF/ORACLE_C.RSA
          0 Tue Sep 12 20:07:54 EDT 2017 META-INF/
          0 Tue Sep 12 20:07:16 EDT 2017 components/
          0 Tue Sep 12 20:07:16 EDT 2017 components/images/
sm      523 Tue Sep 12 20:07:16 EDT 2017 components/ButtonDemo$1.class
sm     3440 Tue Sep 12 20:07:16 EDT 2017 components/ButtonDemo.class
sm     2346 Tue Sep 12 20:07:16 EDT 2017 components/ButtonDemo.jnlp
sm      172 Tue Sep 12 20:07:16 EDT 2017 components/images/left.gif
sm      235 Tue Sep 12 20:07:16 EDT 2017 components/images/middle.gif
sm      172 Tue Sep 12 20:07:16 EDT 2017 components/images/right.gif

  s = signature was verified
  m = entry is listed in manifest
  k = at least one certificate was found in keystore

- Signed by "CN="Oracle America, Inc.", OU=Software Engineering, O="Oracle America, Inc.", L=Redwood City, ST=California, C=US"
    Digest algorithm: SHA-256
    Signature algorithm: SHA256withRSA, 2048-bit key
  Timestamped by "CN=Symantec Time Stamping Services Signer - G4, O=Symantec Corporation, C=US" on Tue Sep 12 20:08:49 UTC 2017
    Timestamp digest algorithm: SHA-1
    Timestamp signature algorithm: SHA1withRSA, 2048-bit key

jar verified.

The signer certificate expired on 2018-02-01. However, the JAR will be valid until the timestamp expires on 2020-12-29.

証明書情報による検証の例

-verifyおよび-verboseオプションとともに-certsオプションが指定されている場合は、JARファイルの各署名者の証明書情報も出力されます。 次の例で示すように、この情報には、証明書のタイプ、署名者の識別名情報(X.509証明書の場合)、およびカッコで囲まれた署名者のキーストア別名(JARファイルの公開キーの証明書がキーストア・エントリの公開キーの証明書と一致する場合)が含まれます。

jarsigner -keystore $JAVA_HOME/lib/security/cacerts -verify -verbose -certs ButtonDemo.jar

s k     866 Tue Sep 12 20:08:48 EDT 2017 META-INF/MANIFEST.MF

      >>> Signer
      X.509, CN="Oracle America, Inc.", OU=Software Engineering, O="Oracle America, Inc.", L=Redwood City, ST=California, C=US
      [certificate is valid from 2017-01-30, 7:00 PM to 2018-02-01, 6:59 PM]
      X.509, CN=Symantec Class 3 SHA256 Code Signing CA, OU=Symantec Trust Network, O=Symantec Corporation, C=US
      [certificate is valid from 2013-12-09, 7:00 PM to 2023-12-09, 6:59 PM]
      X.509, CN=VeriSign Class 3 Public Primary Certification Authority - G5, OU="(c) 2006 VeriSign, Inc. - For authorized use only", OU=VeriSign Trust Network, O="VeriSign, Inc.", C=US (verisignclass3g5ca [jdk])
      [trusted certificate]
      >>> TSA
      X.509, CN=Symantec Time Stamping Services Signer - G4, O=Symantec Corporation, C=US
      [certificate is valid from 2012-10-17, 8:00 PM to 2020-12-29, 6:59 PM]
      X.509, CN=Symantec Time Stamping Services CA - G2, O=Symantec Corporation, C=US
      [certificate is valid from 2012-12-20, 7:00 PM to 2020-12-30, 6:59 PM]

        825 Tue Sep 12 20:08:48 EDT 2017 META-INF/ORACLE_C.SF
       7475 Tue Sep 12 20:08:48 EDT 2017 META-INF/ORACLE_C.RSA
          0 Tue Sep 12 20:07:54 EDT 2017 META-INF/
          0 Tue Sep 12 20:07:16 EDT 2017 components/
          0 Tue Sep 12 20:07:16 EDT 2017 components/images/
smk     523 Tue Sep 12 20:07:16 EDT 2017 components/ButtonDemo$1.class

      [entry was signed on 2017-09-12, 4:08 PM]
      >>> Signer
      X.509, CN="Oracle America, Inc.", OU=Software Engineering, O="Oracle America, Inc.", L=Redwood City, ST=California, C=US
      [certificate is valid from 2017-01-30, 7:00 PM to 2018-02-01, 6:59 PM]
      X.509, CN=Symantec Class 3 SHA256 Code Signing CA, OU=Symantec Trust Network, O=Symantec Corporation, C=US
      [certificate is valid from 2013-12-09, 7:00 PM to 2023-12-09, 6:59 PM]
      X.509, CN=VeriSign Class 3 Public Primary Certification Authority - G5, OU="(c) 2006 VeriSign, Inc. - For authorized use only", OU=VeriSign Trust Network, O="VeriSign, Inc.", C=US (verisignclass3g5ca [jdk])
      [trusted certificate]
      >>> TSA
      X.509, CN=Symantec Time Stamping Services Signer - G4, O=Symantec Corporation, C=US
      [certificate is valid from 2012-10-17, 8:00 PM to 2020-12-29, 6:59 PM]
      X.509, CN=Symantec Time Stamping Services CA - G2, O=Symantec Corporation, C=US
      [certificate is valid from 2012-12-20, 7:00 PM to 2020-12-30, 6:59 PM]

smk    3440 Tue Sep 12 20:07:16 EDT 2017 components/ButtonDemo.class
...
smk    2346 Tue Sep 12 20:07:16 EDT 2017 components/ButtonDemo.jnlp
...
smk     172 Tue Sep 12 20:07:16 EDT 2017 components/images/left.gif
...
smk     235 Tue Sep 12 20:07:16 EDT 2017 components/images/middle.gif
...
smk     172 Tue Sep 12 20:07:16 EDT 2017 components/images/right.gif
...

  s = signature was verified
  m = entry is listed in manifest
  k = at least one certificate was found in keystore

- Signed by "CN="Oracle America, Inc.", OU=Software Engineering, O="Oracle America, Inc.", L=Redwood City, ST=California, C=US"
    Digest algorithm: SHA-256
    Signature algorithm: SHA256withRSA, 2048-bit key
  Timestamped by "CN=Symantec Time Stamping Services Signer - G4, O=Symantec Corporation, C=US" on Tue Sep 12 20:08:49 UTC 2017
    Timestamp digest algorithm: SHA-1
    Timestamp signature algorithm: SHA1withRSA, 2048-bit key

jar verified.

The signer certificate expired on 2018-02-01. However, the JAR will be valid until the timestamp expires on 2020-12-29.

署名者の証明書がX.509証明書でない場合は、識別名情報は表示されません。 その場合には、証明書のタイプと別名だけが表示されます。 たとえば、証明書がPGP証明書で、別名がbobの場合は、PGP, (bob)と表示されます。