Skip to main content

​
Docusign について

Iru は OAuth 2.0 JWT Grant を使用して eSignature REST API を呼び出します。Integration Key（クライアント ID）を登録し、RSA 公開鍵をアップロードして、サービスユーザーのなりすまし（impersonation）の同意を付与すると、Iru は署名付き JWT をアクセストークンと交換します。これは、1 時間ごとに対話的な同意を行う必要のないサーバー間の自動化に適しています。

​
仕組み

DocuSign は複数の OAuth 2.0 グラントタイプをサポートしていますが、Iru のサーバー間コネクタには JWT Grant が適したモデルです。Integration Key（クライアント ID）を作成し、RSA キーペアを設定して、Iru が代理で動作するユーザーに対してなりすましの同意を一度付与します。その後、Iru は eSignature REST API に対して署名付き JWT をアクセストークンと交換します。 大まかな手順: Apps and Keys → Integration Key を作成 → JWT 認証 → RSA を生成またはアップロード → Iru のウィザードに従って Integration Key、なりすまし対象ユーザーの GUID、アカウントのベース URI、秘密鍵を取得します。 公式の参考資料: プラットフォームの認証、JWT Grant、インテグレーションの構築、eSignature REST。

​
前提条件

  • Docusign の管理者アクセス権。
  • インテグレーションを管理するための developers.docusign.com へのアクセス権。
  • デモと本番のどちらのキーと OAuth ホスト（account-d.docusign.com と account.docusign.com）を使用するかを明確に決めておくこと。

​
Docusign を Iru に接続する

Compliance でソースを接続する前に、このタブを完了してください。
1

Apps and Keys を開く

正しい Docusign 環境（デモまたは本番）にサインインします。設定 → Apps and Keys を開きます（表記はアカウントの種類によって多少異なる場合があります）。
2

アプリとインテグレーションキーを追加する

Add App and Integration Key（または Create app）を選択します。担当者が識別できるようにアプリに名前を付けます（例: Iru Compliance）。Integration Key をコピーします。これが JWT の OAuth クライアント ID です。
3

JWT Grant を有効にする

アプリの認証設定で、サーバー間で使用するために JWT Grant を有効にします。Docusign で求められた場合は変更を保存します。
4

RSA キーを生成またはアップロードする

Service Integration で Generate RSA を選択します（または Docusign のドキュメントに従って公開鍵をアップロードします）。秘密鍵をすぐにダウンロードし、ボールトに保管します。後から Docusign で秘密鍵を取得することはできません。
5

なりすましの同意を付与する

Docusign が提供する JWT 用の同意 URL を開きます（スコープには通常 signature と impersonation が含まれます）。なりすまし対象のユーザーとしてサインインし、許可 を選択します。アプリの登録で必要なリダイレクトがあれば完了します。
Iru Compliance タブに進みます。

​
トラブルシューティング

Iru サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
秘密鍵がアップロードした公開鍵と一致していること、およびサーバーの時刻が正確であることを確認してください。
Docusign のアカウントメタデータから、リージョンの restapi ホストを確認してください。
キーと OAuth ホストは環境と一致している必要があります。

​
考慮事項

アクセストークンはおよそ 1 時間ごとに期限切れになり、JWT Grant が…

アクセストークンはおよそ 1 時間ごとに期限切れになりますが、JWT Grant が自動的に再実行されます。RSA 秘密鍵は本番環境のシークレットと同様に保護してください。

​
関連記事

Sources の管理

すべての Compliance ソースを参照・管理します。

Compliance の利用を開始する

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。