API 呼び出しの最初の実行で PDF にハッシュ署名
ハッシュに署名するには、以下の各 API 呼び出しを実行します。
自分の DigiCert ONE アカウントに保存されているクレデンシャル（証明書）のリストを取得するには、以下の手順を実行します。
コレクション PDFService-2-0-SealSign CADES - API-Token Flow - Visible Signature works を開きます。
［1 - DTM CSC Credential List］ > ［Send］を選択します。
使用した DigiCert ONE CredentialID （証明書）は本文に表示されます。
DigiCert ONE で使用されている機能の概要を取得するには、以下の手順を実行します。
［2 - DTM CSC Credential Info］ > ［Send］を選択します。
DigiCert ONE で使用されている機能を確認できます。
文書を登録するには、以下の手順を実行します。
［3 - PDF Service: Register Document］を選択します。
文書の署名に使用するタイムスタンプ認証局の URL を入力して、tsa_url 変数の値を設定します。
［Send］を選択します。
署名の外観を変更するには、以下の設定を使用します。
設定 | 説明 |
|---|---|
type（オプション） | タイプによっては、認証済み MDP （文書変更検知および防止）文書を作成できます。デフォルトでは未認証で、緑色のチェックマークが表示されています。認証済みの場合、シール付きのリボンが表示されます。 例: NOT_CERTIFIED CERTIFIED_NO_CHANGES_ALLOWED CERTIFIED_FORM_FILLING CERTIFIED_FORM_FILLING_AND_ANNOTATIONS |
preservation_size（オプション） | 署名を埋め込むスペースの保存サイズをバイト単位で入力します。値は 1024 の倍数にする必要があります。（フォーマット: int32） |
signature_rectangle（オプション） | 電子署名の注釈の位置とサイズを設定します。デフォルトは不可視の署名です。位置は、長方形の左下隅（x、y）、幅と高さ（w、h）の 4 つの値で定義されます。単位はページの左下隅から計測した PDF ポイントです（1 ポイント = 1/72 インチ、A4 = 595 x 842 ポイント、レター = 612 x 792 ポイント、1 cm = 28.3465 ポイント）。幅または高さのいずれかがゼロまたは負の場合、不可視の署名が作成されます。つまり、形のない署名が作成されるということです。 （フォーマット: int32） ページ: 署名が追加されるページを入力します。 x: 左下隅の x 値を入力します。 y: 左下隅の y 値を入力します。 w: 長方形の幅の寸法を入力します。 h: 長方形の高さの寸法を入力します。 |
signature_text1（オプション） | 標準の署名の代わりに、特定の署名テキストを入力します。（例: 署名者の名前） |
reason（オプション） | 理由を入力します。 |
contact（オプション） | 連絡先を入力します。 |
font_text1（オプション） | フォント名を入力します。 |
font_size_text1（オプション） | 署名テキスト 1 のフォントサイズを入力します。属性が存在しない場合、デフォルトの 16 pt が使用されます。（フォーマット: int32） |
signature_text2（オプション） | 標準の署名の代わりに、特定の署名テキストを入力します。（例: 署名者の名前、理由、署名日時） |
font_text2（オプション） | フォント名を入力します。 |
font_size_text2（オプション） | 署名テキスト 2 のフォントサイズを入力します。属性が存在しない場合、デフォルトの 8pt が使用されます。（フォーマット: int32） |
signature_fill_color（オプション） | 背景色を RGB で入力します。デフォルトは 16761024 （赤 = 192、緑 = 192、青 = 255）です。 色の値は以下のように計算されます。 赤 + 緑 * 256 + 青 * 256 * 256。長方形を透明にするには、値を -1 に設定します。（フォーマット: int32） |
signature_stroke_color（オプション） | 署名の境界線の色を RGB 値で入力します。デフォルトは 8405056 （赤 = 64、緑 = 64、青 = 128）です。 色の値は以下のように計算されます。 赤 + 緑 * 256 + 青 * 256 * 256。境界線を透明にするには、値を -1 に設定します。（フォーマット: int32） |
signature_line_width（オプション） | 可視の署名を囲む線の太さをポイント単位で入力します。（フォーマット: int32） |
background_image（オプション） | 署名フィールドに埋め込む画像を挿入します。（Base64 エンコード）（例: "dGVzdA==”） |
ハッシュを作成するには、以下の手順を実行します。
書類を添付します。
［4 - PDF Service: Create Hash］ > ［Send］を選択します。
SAD（署名アクティベーションデータ）を生成し、Go>Sign Mobile アプリケーションで承認を開始します。
［5 - DTM: CSC Credential Authorize］ > ［Send］を選択します。
Go>Sign Mobile アプリケーションで、［Authorization request］ > ［Authorize］を選択します。
ハッシュに署名するために必要な、有効な SAD が返されます。これは「署名の埋め込み」ステップで必要になります。
注記
DigiCert ONE デモ環境では、Go>Sign Mobile アプリケーション経由の再認証のデフォルト値は「250,000 ハッシュまたは 30 日」に設定されています。
DigiCert ONE 本番環境では、Go>Sign Mobile アプリケーション経由の再認証のデフォルト値は「100 万ハッシュまたは 95 日」に設定されています。
ハッシュに署名するには、以下の手順を実行します。
［7 - DTM: CSC Signatures SignHash］ > ［Send］を選択します。
文書に埋め込むための有効な署名が本文で返されます。
新しいハッシュに署名するには、以下の手順を実行します。
［8 - PDF Service: Embed Signature］を選択します。
「クレデンシャルの承認」ステップで作成された SAD が自動的に更新されます。
［Send］を選択します。
署名が埋め込まれた文書が返されます。
PDF をダウンロードし、署名の有効性を確認するには、以下の手順を実行します。
［Save as example］（右下） > ［Save response to file］を選択します。
Adobe Acrobat Reader で PDF を開き、署名の有効性を確認します。
注記
DigiCert ONE のデモ環境で作成された PDF では、使用されている証明書がデモ証明書であり信頼されていないため、無効な署名が表示されます。ただし、Adobe Acrobat Reader でルート証明書を信頼済みとして分類すると、緑色のチェックマークが表示されます。