WebReportCafe

Size: px

Start display at page:

Download "WebReportCafe"

さあしゃしまむね
4 years ago
Views:

2 1 1. 概要 WebReportCafe 4.0 以降では WRC Engine で作成する PDF に VeriSign の不可視電子署名を付加することができます電子署名を付加する事により文書の作成者を証明することができ作成された PDF を改竄することが不可能になりますこの文書では WebReportCafe で電子署名を付加するために必要なドキュメントサイン用 Digital ID の取得と必須ファイル作成 WRC Designer を使用した帳票フォームの設定プログラム上での電子署名ヘルパーの設定方法を説明します

2 2. ドキュメントサイン用 Digital ID の取得と必須ファイルの作成 VeriSgin の不可視署名を PDF に付加するためには日本ベリサイン社が販売しているドキュメントサイン用 Digital ID を購入する必要があります購入の方法はベリサインのホームページ (http://www.verisign.co.

3 2 2. ドキュメントサイン用 Digital ID の取得と必須ファイルの作成 VeriSgin の不可視署名を PDF に付加するためには日本ベリサイン社が販売しているドキュメントサイン用 Digital ID を購入する必要があります購入の方法はベリサインのホームページ ( を参照してくださいベリサインから提供される Digital ID はプライベートキーが保存されている拡張子が PVK ファイルと公開部分が格納されている SPC ファイルの二つのファイルに分かれています WRC で電子署名を行うには PVK と SPC を一つにした PKCS#12 形式のファイルを作成する必要が有ります PVK ファイルと SPC ファイルを PKCS#12 に変換するには Windows2000 又は WindowsXP と IE5.0 以上がインストールされている必要がありますまた Microsoft 社が提供している PVK Digital Certificate Files Importer という Digital ID を OS に取り込むコマンドラインツールが必要です PVK Digital Certificate Files Importer は Microsoft 社のホームページ ( から無料でダウンロードできます PVK Digital Certificate Files Importer にインストール方法等に関してはホームページの情報を参照してください PKCS#12 ファイルの作成手順は以下の通りです 1. OS の個人証明書ストアに Digital ID を取り込む OS の個人証明書ストアに Digital ID を取り込むにはコマンドラインツールの PVK Digital Certificate Files Importer(pvkimprt.exe) を使用しますコマンドプロンプトから下記のように PVK ファイルと SPC ファイルを引数として指定し実行します pvkimprt.exe "[SPC ファイルへのパス ]" "[PVK ファイルへのパス ]" すると Enter Private Key Password ダイアログが表示されるので申請時に設定したパスワードを入力し [OK] ボタンをクリックします Enter Private Key Password ダイアログ続いて証明書インポートウィーザードが表示されますデフォルト状態でウィザードを進んでいき完了をクリックしてください以上で証明書ストアへの Digital ID の取り込みが完了します 2. 個人証明書ストアを表示する取り込んだ Digital ID を確認しエクスポートするために個人証明書ストアを表示しますまず Internet Explorer を起動し [ ツール ] メニューの [ インターネットオプション ] をクリックし表示されたダイアログボックスの [ コンテンツ ] タブを選択します続いて [ 証明書 ] ボタンをクリックすると Windows 証明書

4 3 マネージャが表示されます [ 個人 ] タブを選択するとユーザーが所有するプライベートキーの証明書が表示されますこれが個人証明書ストアです表示されている証明書の一覧の中に取り込んだ Digital ID が存在する事を確認してください 3. PKCS#12 ファイルを作成する 2 で表示した個人証明書ストアから PKCS#12 ファイルを作成しますまず個人証明書ストアの一覧から 1 で取り込んだ証明書を選択し [ エクスポート ] ボタンをクリックすると証明書のエクスポートウィザードが表示されます [ 次へ ] ボタンをクリックすると秘密キーのエクスポートの有無を設定画面が表示されますはい秘密キーをエクスポートしますのラジオボタンをクリックし [ 次へ ] ボタンをクリックします次にエクスポートファイル形式の設定画面が表示されます証明のパスにある証明書を可能であればすべて含むのチェックボックスをオンにして次へをクリックしますパスワード入力画面が表示されるので適当なパスワードを入力し次へをクリックしますパスワードは WRC で使用する際にも必要になりますので忘れないようにしてください続いてエクスポートファイルの場所と名称の指定を行うダイアログが表示されるので出力するファイル名と場所を指定し [ 次へ ] ボタンをクリックします最後に表示される確認画面で [ 完了 ] ボタンをクリックすると PKCS#12 ファイルを作成することができます 3. WRC Designer を使用した帳票フォームの設定電子子署名を行うには WRC Designer を使用して PDF を作成する帳票フォームに電子署名の設定を行う必要があります帳票フォームへの電子署名の設定手順は下記の通りです 1. WRC Designer を起動し帳票フォームを作成します 2. [ ツール ] メニューから [PDF 設定 ] を選択し PDF 設定ダイアログを表示します 3. [VeriSign 不可視署名 ] タブをクリックし電子署名設定タブを表示します 4. [VeriSign 不可視署名を設定する ] チェックボックスをオンし詳細情報入力項目を表示します 5. 詳細情報を入力します ([ 名前 ] フィールドは必須項目なので必ず入力してください ) 6. PDF 設定ダイアログの [OK] ボタンをクリックしダイアログを閉じます以上で帳票フォーム電子署名の設定が完了です尚 WRC Designer 上の PDF プレビュー機能では電子署名は行われませんのでご注意ください

5 4 4. Java プログラム上での電子署名ヘルパーの設定作成した帳票フォームを表示するには Java プログラム上で帳票フォーム PDF を生成するためのクラス jp.co.tenartni.xreport.xreport のインスタンスに電子署名を行うためのヘルパークラスのインスタンスをセットする必要がありますここでは XReport 詳しい説明は省き同オブジェクトへの電子署名ヘルパーの設定についてのみご説明します XReport の使用方法は WRC Engine のドキュメントを参考にしてください電子署名ヘルパークラスとは電子署名ヘルパークラスとは電子署名ヘルパーインターフェース jp.co.tenartni.pdf.digsig.digitalsignhelper をインプリメントした電子署名を行うロジックが実装されたヘルパークラスです WebReportCafe ではオープンソース暗号化ライブラリ Bounchy Castle v1.25 を使用して電子署名を行うヘルパークラス jp.co.tenartni.xreport.digsig.lightdigitalsigner を提供しています電子署名ヘルパークラスの使用方法電子署名ヘルパークラスの設定方法と XReport オブジェクトへセットする方法をご説明します 1. インスタンスの作成まずヘルパークラスのインスタンスを作成します下記の例では XReport のインスタンスも作成しています例 ) XReport rep = new XReport(); LightDigitalSigner digsighelper = new LightDigitalSigner(); 2. Digital ID ファイル (PKCS#12) をセット次に Digital ID から作成した PKCS#12 形式のファイルをヘルパークラスのインスタンスにパスワードと一緒に設定します例 ) digsighelper.setpkcs12urlinfo("file:///d:/pdf/tenartni.pfx", "tenartni"); 3. XReport オブジェクトにセット最後にヘルパークラスを XReport に設定します例 ) rep.setdigitalsignhelper(digsighelper);

6 5 電子署名付き PDF 作成 Java プログラムサンプル電子署名月の PDF 作成 Java プログラムのサンプルは下記の通りです import jp.co.tenartni.xreport.digsig.lightdigitalsigner; import jp.co.tenartni.sql.*; import jp.co.tenartni.xreport.*; public class SignedReportProductList { // 1 必要なインスタンスを作成する XReport rep = new XReport(); LightDigitalSigner digsighelper = new LightDigitalSigner(); SQLHandler sqlhandler = new SQLHandler(); SQLRowSet sqlrowmain = new SQLRowSet(); public SignedReportProductList() { try { // 2 Digital ID ファイル (PKCS#12) をセットする digsighelper.setpkcs12urlinfo("file:///d:/pdf/tenartni.pfx", "tenartni"); // 3 ヘルパークラスを XReport オブジェクトにセットする rep.setdigitalsignhelper(digsighelper); // 4 データベース情報を設定する sqlhandler.setdrivername("oracle.jdbc.oracledriver"); sqlhandler.setdburl("jdbc:oracle:thin:@wwb:1521:wwbdb"); sqlhandler.setdbusername("maido"); sqlhandler.setdbpassword("maido"); // 5 帳票フォームを設定する rep.loadproperty("file:///d:/pdf/reportform/product_list_signed.xml"); // 6 SQL を設定する sqlrowmain.setsql(rep.getsql()); sqlrowmain.setsqlhandler(sqlhandler); rep.setrowset(sqlrowmain); // 7 帳票を生成する rep.createpdf("d:/pdf/product_list_signed.pdf"); System.out.println("completed."); System.exit(0); catch (Exception e) { System.out.println("error!! : " + e.tostring()); System.exit(-1); finally { try { sqlhandler.disconnect(); catch (Exception e) { public static void main(string[] args) { SignedReportProductList reportproductlist = new SignedReportProductList();

7 6 5. J2SDK の設定 (J2SDK1.4X 以降 ) WRC では電子署名処理にオープンソース暗号処理ライブラリ Bounchy Castle v1.25( の JCE プロバイダを使用しています v1.4.0 以降の J2SDK でこの JCE プロバイダを使用するには暗号化強度制限を解除する必要があります暗号化強度制限を解除するために JCE Unlimited Strength Jurisdiction Policy Files が必要です JCE Unlimited Strength Jurisdiction Policy Files は Sun Developer Network Site( からダウンロードすることができますセットアップ方法は JCE Unlimited Strength Jurisdiction Policy Files の README.txt を参照してください

8 7 6. 注意点 Acrobat5.0 での署名検証 Acrobat6.0 及び Adobe Reader6.0 において電子署名検証のハンドラが標準で搭載されるようになりました WRC4.0 からは新しいハンドラに対応したため Acrobat5.X での署名が検証できなくなりました署名の検証には Acrobat6.0 をご使用くださいメモリーリソース消費について WebReportCafe を使用して電子署名なしの PDF を作成する場合は PDF データの一部が生成される度に出力先へ出力する仕様になっていますが電子署名付き PDF を生成する場合は電子署名を行うために PDF 全体のデータからハッシュコードを作成必要があるため生成される全体の PDF データをメモリ上に展開する仕様になっていますよって電子署名付き PDF を生成する場合は電子署名なしの PDF を生成する場合よりも JVM のヒープを多く使用しますので膨大なデータの PDF を生成する際はご注意ください Adobe Reader6.0 での電子署名の検証について Adobe Reader6.0 で電子署名を検証する場合設定が必要になります詳しくは Adobe 社のサポートサイトの文書番号 : ベリサインの証明書で作成された電子署名の検証方法 ( を参照してください暗号化ライブラリについて WRC では電子署名処理に JCE プロバイダとしてオープンソース Bounchy Castle v1.25 を使用しています他のバージョンの Bounchy Castle を誤使用の場合は不具合が起こる可能性があります Bounchy Castle ライブラリは下記の条件で配布されているオープンソースソフトウェアです Copyright (c) 2000 The Legion Of The Bouncy Castle ( Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

WebReportCafe

WebReportCafe Ver. 8.0_000 1 目次 1. 概要... 2 2. ドキュメントサイン用 Digital IDの取得と必須ファイルの作成... 3 3. WRC Designerを使用した帳票フォームの設定... 4 4. Javaプログラム上での電子署名ヘルパーの設定... 5 電子署名ヘルパークラスとは... 5 電子署名ヘルパークラスの使用方法... 5 電子署名付きPDF 作成 Javaプログラムサンプル...