OneSpan Sign Developer：アカウント送信者の署名を上書き

Duo Liang, 2018年8月22日

前回のブログ「署名者の署名をアップロード」では、キャプチャされた署名がOneSpan Signでどのように機能するか、アプリケーションが統合されており、署名パッドからカスタム署名を使用している場合に署名者の署名をアップロードする方法について説明しました。本日はさらに詳しく説明し、アクセス権のない送信者に署名をアップロードするときに発生する可能性がある2つの例外シナリオについて説明します。送信者プロファイルの署名は変更できません。

アカウント送信者の署名を上書き

署名者の署名がアップロードされたパッケージを作成する場合、手描きの値をリクエストペイロードの「signature」ブロックに直接追加します。ただし、この方法は、OneSpan Signでアカウントとしてメールが登録されていない署名者に対してのみ機能します。アカウントの送信者に対して同じことを行うと、OneSpan Signは送信者を認識し、アップロードされた署名を無視します。Senderの登録済み署名を上書きするには、いくつかの追加手順を実行する必要があります。このブログでは、そのプロセスの詳細を示します。

1。パッケージを作成し、ステータスを「DRAFT」のままにします。

2。署名者の署名を更新する

まず、APIを呼び出します。 GET / api / packages / {packageID} / roles / {roleID} 」を使用して、役割のJSON全体を取得します。

次に、手書きの値を新しい署名で置き換えます。

次に、「 PUT / api / packages / {packageID} / roles / {roleID} 」を使用して、変更を有効にします。

3。パッケージを送信します。
初めて署名者を作成するとき、OneSpan Signは送信者を認識し、関連するロール情報を自動的に挿入します。この役割情報には、手書きの署名が含まれています。その署名が署名者に既に添付されている場合、OneSpan Signはアップロードされた署名を無視し、デフォルトですでにファイルにある署名に設定されます。上記の3つの手順を実行して、署名者を手動で更新すると、OneSpan Signは署名者と再度一致しなくなります。したがって、変更は有効です。

注意：

このプロセスは実際には元の署名を変更せず、今回のみ機能します。
自分のアカウントを含む、あらゆるアカウントの署名を上書きできます。

公証人の署名をアップロード

上記のプロセスはほとんどの状況で機能しますが、公証人が存在する場合に署名をアップロードするには、特別な手順が必要です。

ステップ1

notaryRoleIDを割り当てずに公証済みパッケージを作成し、「DRAFT」ステータスのままにします。APIを使用して、公証人の役割情報を独自の役割情報に置き換えます。

POST / api / packages
承認：基本apikey
承諾：application / json
コンテンツタイプ：multipart / form-data
リクエストのペイロード：
{
   「役割」：[
      {
         "id"： "role1"、
         "タイプ"： "SIGNER"、
         "インデックス"：0、
         「署名者」：[
            {
               "メール"： "公証メール"、
               "firstName"： "notary.firstname"、
               "lastName"： "notary.lastname"
            }
         ]、
         「名前」：「署名者1」
      }、
      {
         "id"： "role2"、
         "タイプ"： "SIGNER"、
         "インデックス"：0、
         「署名者」：[
            {
               "id"： "role2"、
               "メール"： "signer1 @mailinator .com "、
               "firstName"： "1.firstname"、
               "lastName"： "1.lastname"
            }
         ]、
         "名前"： "署名者2"
      }
   ]、
   "ステータス"： "ドラフト"、
   "ドキュメント"：[
      ……
   ]、
   "公証済み"：true、
   「notaryRoleId」：null、
   "タイプ"： "パッケージ"、
   "name"： "公証人のためのテストアップロード署名"
}

ステップ2

公証人の署名を更新：
（1）。使用する GET / api / packages / {packageID} / roles / {notaryRoleID} 応答本文全体をコピーします
（2）。公証人を更新：

PUT / api / packages / {packageID} / roles / {notaryRoleID}
承認：基本apikey
承諾：application / json
コンテンツタイプ：application / json
リクエストのペイロード：
{
   ...
    「署名者」：[
        {
          ...
            "署名"：{
                "textual"：null、
                "手描き"： "手描きの値"
              }、
          ...
        }
]、
”名前”：” Signer1”
}

応答の本文をペイロードに貼り付け、手描きの値を独自の値に置き換えます。

ステップ3

パッケージレベルでnotaryRoleIDを割り当てます。

PUT / api / packages / {packageID}
承認：基本apikey
承諾：application / json
コンテンツタイプ：application / json
リクエストのペイロード：
{
"notaryRoleId"： "あなたの公証ID"
}

ステップ4

パッケージを送信します。

PUT / api / packages / {packageID}
承認：基本apikey
承諾：application / json
コンテンツタイプ：application / json
リクエストのペイロード：
{
"ステータス"： "送信済み"
}

注意：

ステップ3とステップ4は、2つの別個のAPI呼び出しを通じて実行する必要があります。

これらの4つのステップの背後にある主なポイントは、最初のセクションで行ったプロセスを実行すると、「公証人を編集できない」というエラーが表示されることです。ただし、手書きの値を更新するまで公証人を割り当てない場合は、このエラーを回避でき、すべてが期待どおりに機能します。

送信者と公証人にアクセスできる場合でも、送信者プロファイルの署名を更新することをお勧めします。コードに実装する前に、Postmanでプロセス全体をテストすることを常にお勧めします。

このブログや、OneSpan Signをアプリケーションに統合することに関するその他の質問がある場合は、開発者コミュニティフォーラム。あなたのフィードバックは私たちにとって重要です！

高度電子署名機能

Duo Liang

OneSpan Blog