> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Docusign
> インテグレーションキー、RSA キーペア、同意を使用した OAuth JWT Grant で Docusign を Iru Compliance に接続し、エンベロープとアカウントのエビデンスを収集します。
### 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** を**アクセストークン**と交換します。
| 項目 | 値 |
| - | - |
| **カテゴリ** | 生産性 |
| **認証** | OAuth 2.0 JWT Grant |
大まかな手順: **Apps and Keys** → **Integration Key** を作成 → **JWT** 認証 → **RSA** を生成またはアップロード → Iru のウィザードに従って **Integration Key**、なりすまし対象ユーザーの **GUID**、**アカウントのベース URI**、**秘密鍵**を取得します。
公式の参考資料: [プラットフォームの認証](https://developers.docusign.com/platform/auth/)、[JWT Grant](https://developers.docusign.com/platform/auth/jwt/jwt-get-token/)、[インテグレーションの構築](https://developers.docusign.com/platform/build-integration/)、[eSignature REST](https://developers.docusign.com/docs/esign-rest-api/)。
### 前提条件
* Docusign の**管理者**アクセス権。
* インテグレーションを管理するための **developers.docusign.com** へのアクセス権。
* **デモ**と**本番**のどちらのキーと OAuth ホスト（`account-d.docusign.com` と `account.docusign.com`）を使用するかを明確に決めておくこと。
### Docusign を Iru に接続する
Compliance でソースを接続する前に、このタブを完了してください。
正しい Docusign 環境（**デモ**または**本番**）にサインインします。**設定** → **Apps and Keys** を開きます（表記はアカウントの種類によって多少異なる場合があります）。
**Add App and Integration Key**（または **Create app**）を選択します。担当者が識別できるようにアプリに名前を付けます（例: **Iru Compliance**）。**Integration Key** をコピーします。これが JWT の OAuth **クライアント ID** です。
アプリの認証設定で、サーバー間で使用するために **JWT Grant** を有効にします。Docusign で求められた場合は変更を保存します。
**Service Integration** で **Generate RSA** を選択します（または Docusign のドキュメントに従って公開鍵をアップロードします）。**秘密鍵**をすぐにダウンロードし、ボールトに保管します。後から Docusign で秘密鍵を取得することはできません。
Docusign が提供する JWT 用の**同意 URL** を開きます（スコープには通常 **`signature`** と **`impersonation`** が含まれます）。**なりすまし対象のユーザー**としてサインインし、**許可** を選択します。アプリの登録で必要なリダイレクトがあれば完了します。
[**Iru Compliance**](#iru-compliance) タブに進みます。
先に [**Docusign**](#docusign) タブを完了してください。
Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。
**Docusign** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
ウィザードで、**Integration Key**（**クライアント ID**）と、Docusign が代理で動作するアカウントのなりすまし対象ユーザーの **ID**（**GUID**）を貼り付けます。
**RSA 秘密鍵**と、お客様のアカウントの **REST ベース URI**（例: `https://na4.docusign.net/restapi`）を貼り付けます。ベース URI が不明な場合は、Docusign のドキュメントに従って **`/oauth/userinfo`** で確認します。
設定を **送信** します（ウィザードのラベルに合わせてください。ベンダーのフローではこれを **Submit the configuration** と呼んでいます）。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
**Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Docusign** カードが **有効** になっていることを確認します。
### トラブルシューティング
Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
ブラウザでなりすましの同意を完了してください。
秘密鍵がアップロードした公開鍵と一致していること、およびサーバーの時刻が正確であることを確認してください。
Docusign のアカウントメタデータから、リージョンの **`restapi`** ホストを確認してください。
キーと OAuth ホストは環境と一致している必要があります。
### 考慮事項
アクセストークンはおよそ 1 時間ごとに期限切れになりますが、**JWT Grant** が自動的に再実行されます。**RSA 秘密鍵**は本番環境のシークレットと同様に保護してください。
### 関連記事
すべての Compliance ソースを参照・管理します。
フレームワーク、アクション、**アーティファクト**。
Endpoint、Compliance、Identity がどのように連携するか。
ソースやアクションから得たエビデンスをアップロード、確認、整理します。