Docusign
Docusignは、安全なeSignatureソリューションです。電子署名テクノロジーとデジタルトランザクション管理サービスを提供し、企業が完全にデジタル化されたワークフローを作成できるようにします。
APIバージョン
DocusignコネクターはDocusign eSignature REST APIを使用します。
サポートされているエディションとバージョン
DocusignコネクターはすべてのDocusignプランで動作します:
- 個人用
- Standard
- Business Pro
コネクションの設定
Docusignコネクターは、次の認証方法をサポートしています:
認証と送信
impersonationスコープを使用したJWT Token認証では、Send On Behalf Ofフィールドを使用して、別のユーザーのメールアドレスからドキュメントを送信できます。 このフィールドには、JWTアプリの管理者の同意と個別ユーザーの同意の両方が必要です。
OAuth 2.0（Authorization Code Grant）では、すべてのドキュメントがコネクションを承認したユーザーのメールアドレスから送信されます。 Send On Behalf Ofフィールドは、OAuth 2.0認証では使用できません。
ロールと権限
DocusignにサインインできるDocusignユーザーは、WorkatoからDocusignに接続できます。 ユーザーはDocusignと同じ権限と機能で、Workato上のエンベロープを表示、管理、送信できます。
JWT Token
JWT Token認証を使用して、サーバー間認証用の秘密キーでDocusignに接続します。 この方法ではSend On Behalf Ofフィールドがサポートされ、別のユーザーのメールアドレスからドキュメントを送信できます。
JWT Tokenの設定
JWT Token認証を設定するには、次の手順を実行します:
User IDを取得する
User ID（API Username）を取得するには、次の手順を実行します:
Docusignにサインインします。
Admin＞Apps and Keysに移動します。
このページでAPI Usernameを見つけ、この値を安全な場所に記録します。 この値は、WorkatoでJWT Tokenコネクションを確立するときにUser IDとして必要です。
インテグレーションキーを作成する
Docusignインスタンスでインテグレーションキーを作成するには、次の手順を実行します:
Apps and Keysページで、Add App and Integration Keyをクリックします。
Workato Integrationなど、アプリケーションの名前を入力します。
Create Appをクリックします。
Integration Key（Client IDとも呼ばれます）を安全な場所に記録します。 この値は、Workatoでコネクションを確立するために必要です。
RSAキーペアを生成する
JWT認証用のRSAキーペアを生成するには、次の手順を実行します:
インテグレーションアプリ設定のService Integrationセクションに移動します。
Generate RSAをクリックして、新しいRSAキーペアを作成します。
Private Keyをコピーし、安全な場所に保存します。 この値は、Workatoでコネクションを確立するために必要です。
秘密キーを保存する
秘密キーは1回だけ表示されます。 このダイアログを閉じると、再度取得することはできません。 紛失した場合は、新しいキーペアを生成する必要があります。
Closeをクリックして、キーペアをインテグレーションに保存します。
リダイレクトURIを追加する
リダイレクトURIを追加するには、次の手順を実行します:
インテグレーションアプリ設定のAdditional settings＞Redirect URIsセクションに移動します。
+ Add URIをクリックします。
Redirect URIsフィールドにhttps://www.workato.com/oauth/callbackを入力します。
保存をクリックします。
Send On Behalf Ofの同意を取得する
Send On Behalf Ofフィールドを使用すると、JWT Token認証を使用するときに、別のユーザーのメールアドレスからエンベロープを送信できます。
このフィールドは次のアクションで使用できます:
このフィールドには2種類の同意が必要です:
管理者の同意を取得する
Docusign Adminパネルを使用して、組織の要求済みドメイン内のすべてのユーザーに代わってJWTアプリに同意を付与します。 この承認により、指定した権限に制限された状態で、アプリにすべてのドメインユーザーへのアクセス権が付与されます。 これは1回限りの設定です。
管理者の同意の前提条件
- 組織でDocusign Admin機能が有効になっている必要があります。
- 組織に少なくとも1つの要求済みドメインが必要です。 DocusignドキュメントのClaim a domainを参照してください。
- アプリのインテグレーションキーを作成済みである必要があります。
管理者の同意を取得するには、次の手順を実行します:
組織管理者としてDocusignにサインインします。
Docusign AdminでOrganizationホームページを開きます。
左側のナビゲーションからConnected Appsを選択します。
Authorize Applicationを選択し、ドロップダウンメニューからアプリケーションを選択します。 このメニューには、すべてのインテグレーションキーが名前別に表示されます（例: Workato Integration）。
Add New Applicationダイアログでsignature impersonation権限を入力します。
これらの権限は、組織の要求済みドメインのメンバーであるすべてのユーザーに適用されます。
Addをクリックして、アプリケーションを確認し承認します。
詳細については、DocusignドキュメントのHow to obtain admin consent for internal applicationsを参照してください。
個別ユーザーの同意を取得する
Send On Behalf Ofフィールドで使用する予定のメールアドレスを持つ各ユーザーは、JWTアプリに個別に同意を付与する必要があります。 これにより、エンベロープ送信時にアプリがユーザーに代わって動作できるようになります。
インテグレーションキーとリダイレクトURI
個別の同意を設定する前に、JWT Token設定セクションのインテグレーションキーとリダイレクトURIの手順を必ず完了してください。
個別ユーザーの同意を取得するには、次の手順を実行します:
コネクション中の同意
JWT Token認証を使用して接続すると、Docusignから同意を付与するよう求められます。 これにより、コネクションを認証するユーザーに個別の同意が付与されます。 上記の手順は、代理送信を予定している追加ユーザーに対してのみ実行する必要があります。
詳細については、DocusignドキュメントのHow to obtain individual consentを参照してください。
JWT Tokenを使用してDocusignに接続する
JWT Token認証を使用してDocusignに接続するには、次の手順を実行します:
作成 > コネクションをクリックするか、Cを2回押します。
新規コネクションページでDocusignを検索して選択します。
コネクション名フィールドにコネクションの名前を入力します。
JWT Token認証を使用してDocusignに接続する
Locationドロップダウンメニューを使用して、コネクションを保存する予定のプロジェクトまたはフォルダを選択します。
認証タイプドロップダウンメニューを使用して、JWT Tokenを選択します。
Demoドロップダウンメニューを使用して、これがデモDocusignアカウントかどうかを示します。 デモ/サンドボックスアカウントの場合はYes、プロダクションアカウントの場合はNoを選択します。
DocusignアプリケーションのインテグレーションキーをClient IDフィールドに入力します。
JWT Tokenの設定手順で取得したUser ID（API Username）をUser IDフィールドに入力します。
JWT Tokenの設定手順で取得したRSA秘密キーをPrivate keyフィールドに入力します。 -----BEGIN RSA PRIVATE KEY-----と-----END RSA PRIVATE KEY-----のヘッダーを含む完全な秘密キーを含めます。
任意です。 複数のアカウントがある場合に特定のDocusignアカウントを指定するには、Account IDを入力します。 アカウントIDは、Admin＞Apps and Keys＞API Account IDに移動して確認できます。 デフォルトでは、コネクションによって最初のDocusignアカウントが選択されます。
任意です。 Webhookリクエストを検証するには、Connect keyフィールドにConnect keyを入力します。 詳細については、DocusignドキュメントのAdd HMAC keys for your appを参照してください。
任意です。 Custom OAuth profileドロップダウンメニューを使用して、コネクション用のCustom OAuth profileを選択します。
接続をクリックします。 Workatoはコネクションを承認するためにDocusignにリダイレクトします。
Allow Accessをクリックして、Workatoインテグレーションにアカウントへのアクセス権限を付与します。
JWT同意画面
OAuth 2.0（Authorization Code Grant）
OAuth 2.0（Authorization Code Grant）を使用して、Docusignの承認フローを通じてサインインし、アクセス権を付与することでDocusignに接続します。 すべてのドキュメントは、コネクションを承認したユーザーのメールアドレスから送信されます。
OAuth 2.0（Authorization Code Grant）を使用してDocusignに接続する
OAuth 2.0認証を使用してDocusignに接続するには、次の手順を実行します:
作成 > コネクションをクリックするか、Cを2回押します。
新規コネクションページでDocusignを検索して選択します。
コネクション名フィールドにコネクションの名前を入力します。
OAuth 2.0（Authorization Code Grant）認証を使用してDocusignに接続する
Locationドロップダウンメニューを使用して、コネクションを保存する予定のプロジェクトまたはフォルダを選択します。
認証タイプドロップダウンメニューでOAuth 2.0 (Authorization Code Grant)を選択します。
Demoドロップダウンメニューを使用して、これがデモDocusignアカウントかどうかを示します。 デモ/サンドボックスアカウントの場合はYes、プロダクションアカウントの場合はNoを選択します。
任意です。 複数のアカウントがある場合に特定のDocusignアカウントを指定するには、Account IDを入力します。 アカウントIDは、Admin＞Apps and Keys＞API Account IDに移動して確認できます。 デフォルトでは、コネクションによって最初のDocusignアカウントが選択されます。
任意です。 Webhookリクエストを検証するには、Connect keyフィールドにConnect keyを入力します。 詳細については、DocusignドキュメントのAdd HMAC keys for your appを参照してください。
任意です。 Custom OAuth profileドロップダウンメニューを使用して、コネクション用のCustom OAuth profileを選択します。
接続をクリックします。
Last updated: