組織レベルで DocuSign と統合

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：12分

    • 組織レベルで ソフトウェア資産管理 アプリケーションを DocuSign サービスと統合することで、ソフトウェアサブスクリプションとエンベロープ消費データを追跡できます。

    注:
    組織レベルでの DocuSign との統合はデータフィード API を使用して行われるため、ユーザーの最後のアクティビティはこの統合の一部として追跡されません。

    DocuSignサービスについて詳しくは、DocuSign開発者サイトを参照してください。

    重要:
    必要なユーザーまたは API 権限のみにアクセス権を付与することで、セキュリティリスクを最小限に抑え、情報を保護します。
    表 : 1. 最小限のユーザー権限
    プロセス DocuSign アプリケーションで必要なユーザーロール 認証スコープ
    サブスクリプションをダウンロード admin スコープなし
    ダウンロード消費 admin スコープなし

    このプロセスは、 Zurich パッチ 4、 ソフトウェア資産管理 - SaaS ライセンス管理 (sn_sam_saas_int) 16.0.8、および ソフトウェア資産管理 (sn_itam_samp) 2.1.0 以降のバージョンに適用されます。

    DocuSignアプリケーションを登録

    DocuSign アドミンポータルからDocuSignアプリケーションを登録します。

    始める前に

    DocuSign 必要なロール：admin

    手順

    1. DocuSignデモ (非本番) アカウントにログインします。
      後で対応する本番アカウントに昇格される任意のサブアカウントをログインに使用できます。
    2. [アドミン] タブに移動します。
      • 以前の統合の API 統合キーを本番環境で使用できる状態がすでにある場合は、 ステップ 15 に進みます。
      • API 統合キーを保存していない場合は、新しいキーを生成する必要があります。
    3. サイドナビゲーションペインで、[ アカウントプロファイル] を選択し、後で使用できるように組織 ID をコピーして保護します。
    4. 移動先 統合 > アプリとキー.
    5. [ アプリと統合キー] セクションで、[ アプリと統合キーを追加] を選択します。
    6. [統合キーを追加] フォームで、[ アプリ名 ] フィールドにアプリケーションの一意の名前を入力し、[ アプリを作成] を選択します。
    7. アプリケーションのプロファイルページで、[統合タイプ] フィールドで [サードパーティ統合キー] を選択します。
    8. 後で使用するために統合 キー の値をコピーして保護します。
      重要:
      生成する統合キーでデータフィード API を有効にする場合は、 DocuSign サポートチームに要求する必要があります。Enterprise Pro プランを使用している場合、組織管理でデータフィード API は無料です。低レベルのプランを使用している場合は、アドオンとして組織管理を選択できます。詳細については、 DocuSign サポートチームにお問い合わせください。
    9. [保存] を選択します。
    10. [ アプリと統合キー] セクションで、[アプリ名] リストで作成したアプリケーションを見つけます。
    11. 選択 アクション > 本番稼働アカウントを選択.
      DocuSignログインウィンドウがポップアップ表示され、DocuSignアカウントの認証情報を入力するように求められます。
    12. DocuSign 認証情報を入力します。
    13. 統合キーを昇格させる本番アカウントを選択するように求めるポップアップウィンドウで本番アカウントを選択します。
      [ 本番稼働ステータス] フィールドが [承認待ち] に変わります。本番稼働のレビューを成功させるには、アプリが使用する各 API の本番稼働の要件を満たしている必要があります。本番稼働レビューステージの詳細については、次を参照してください。 DocuSign ドキュメント.
    14. 統合が承認されると、[ 本番稼働ステータス ] が [ 本番稼働中に表示] に変わります。
    15. DocuSign本番アカウントにログインし、同じ統合キーが本番アカウントに昇格されていることを確認します。

    DocuSign統合のための RSA キーペアを生成

    RSA キーを生成して、 DocuSign アプリケーションを ServiceNow インスタンスと統合します。

    始める前に

    DocuSignの要件：
    • DocuSign アカウント
    • DocuSign と統合するように構成されたアプリ ServiceNow
    • 必要なロール：DocuSign アドミニストレーター

    このタスクについて

    組織レベルで DocuSign を統合すると、任意の 1 つのサブアカウントで生成された単一の統合キーを使用して、すべてのサブアカウントにアクセスできるようになります。

    手順

    1. DocuSign本番コンテンツアカウントにログインします。
    2. [アドミン] タブに移動します。
    3. 移動先 統合 > アプリとキー.
    4. アプリケーションの横にある アクション > 編集.
    5. [ RSA を生成 ] を選択し、後で使用するためにキーペア ID、公開鍵、および秘密鍵を保存します。

    Java Key Store 証明書の生成

    DocuSign 統合プロファイルの JSON Web トークン (JWT) 認証用の Java Key Store (JKS) 証明書を生成します。

    始める前に

    必要なロール：admin

    手順

    1. Sublime Text などのコード用のテキストエディターを開き、ファイルを作成します。
    2. DocuSign インテグレーターアプリから生成した秘密鍵を貼り付けます。

      詳細については、「DocuSign統合のための RSA キーペアを生成」を参照してください。

      注:
      秘密鍵の開始と終了の両方を含めるようにしてください。
    3. ファイルを.key拡張子で保存します。
      たとえば、 privatekey.key などです。
    4. コマンドラインインターフェイス (CLI) を開き、.key拡張子でファイルを保存したディレクトリに移動します。
    5. 次のコマンドを実行し、秘密鍵を使用して CA 署名済み証明書を作成します。 
      openssl req -new -x509 -key <file-name>.key -out <certificate-name>.pem -days 1095
      国名や都道府県名などの詳細を入力するように求められます。
    6. 必要な詳細を入力します。
    7. 次のコマンドを実行し、秘密鍵と CA 署名済み証明書を使用して PKCS 12 ファイルを作成します。 
      openssl pkcs12 -export -in <certificate-name>.pem -inkey <file-name>.key -certfile <certificate-name>.pem -out <PKCS-12-file-name>.p12
      ファイルのパスワードを入力するように求められます。
    8. エクスポートパスワードまたはソースキーストアパスワードを入力します。
    9. 次のコマンドを実行して、JKS ファイルを作成します。 
      keytool -importkeystore -srckeystore <PKCS-12-file-name>.p12 -srcstoretype pkcs12 -destkeystore <JKS-certificate-filename>.jks -deststoretype JKS
      JKS ファイルのパスワードを入力するように求められます。
    10. 宛先キーストアとソースキーストアのパスワードに同じパスワードを指定します。

    組織レベルで DocuSign 統合プロファイルを作成する

    統合プロファイルを作成して、ソフトウェアサブスクリプションを追跡し、 DocuSign サービスのライセンスを最適化します。

    始める前に

    DocuSign統合プロファイルを作成するには、ServiceNow Store から ソフトウェア資産管理 - SaaS ライセンス管理 プラグイン (sn_sam_saas_int) を要求します。

    ServiceNow 必要なロール:sam_integrator

    このタスクについて

    組織レベルの統合プロファイルは、組織全体の詳細なサブスクリプションと消費データを取得する DocuSign データフィード API を使用します。組織下のすべてのサブアカウントのデータを集計し、エンベロープのアクティビティと使用状況を一元的に表示します。

    ソフトウェア資産ワークスペース を使用している場合、コア UI で DocuSign 統合プロファイルを作成するオプションは無効です。

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      コア UI
      1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [新規] を選択します。
      3. [DocuSign 統合プロファイル] を選択します。
      ソフトウェア資産ワークスペース
      1. 移動先 ライセンス操作 > ユーザーサブスクリプション > 直接統合プロファイル.
      2. [新規] を選択します。
      3. ドロップダウンリストから [DocuSign ] を選択します。
      4. [Continue (続行)] を選択します。
    2. フォームで、フィールドに入力します。
      表 : 2. 統合プロファイルフォーム
      フィールド 説明
      表示名 データ連携プロファイルの名前例:DocuSign 統合
      統合タイプ デフォルト値は 組織レベルに設定されています。
      契約開始日 契約合意が発効した日付。

      この日付は、 DocuSign アカウントが作成された日付と同じではありません。
      プロファイルタイプ 統合プロファイルのタイプ。この値は自動的に [DocuSign サブスクリプション] に設定されます。
      組織 ID このアカウントが属する組織 ID。

      この値は、 DocuSign アカウントの [アドミン] タブで確認できます。[アカウントプロファイル] に移動し、組織 ID をコピーします。

      組織 ID が強調表示された Docusign アカウントプロファイル
      更新期間 (月) エンベロープの消費が更新される頻度。

      たとえば、3 か月の更新期間を入力すると、消費データは 3 か月ごとに更新されます。更新期間は消費サイクルを支配し、契約期間全体とは別のものです。
    3. 各プロセスの [ プロセス構成 ] フィールドで指定された必要なユーザーロールまたは API 権限を確認して、セキュリティリスクを最小限に抑え、 SaaS ライセンスを最適化します。
      注:
      必要なロールとスコープの詳細については、「 最小限のユーザー権限 」の表を参照してください。

      [ サブスクリプションをダウンロード] チェックボックスはデフォルトでオンになっており、オフにすることはできません。

      [ ダウンロード消費 (Download Consumption)] チェックボックスはデフォルトでオンになっています。詳細な消費データは、 DocuSign 消費テーブルで確認できます。この消費テーブルのデータは UTC タイムゾーンです。

    4. [送信] を選択します。
      ドラフトの統合プロファイルが作成されます。

      [ 接続および資格情報 ] フィールドが表示され、自動的に [sn_sam_saas_int] に設定されます。Docusign_OAuth_with_JWT。

    5. [接続および資格情報] フィールドの横にあるプレビューアイコンを選択し、レコードプレビューで [レコードを開く] を選択して、接続および資格情報エイリアスレコードを開きます。
    6. [接続および資格情報エイリアス] フォームで、[ 新しい接続および資格情報の作成 ] 関連リンクを選択します。
    7. [接続と資格情報を作成] ダイアログボックスで、フィールドに入力します。
      表 : 3. [接続と資格情報を作成] ダイアログボックス
      フィールド 説明
      接続情報
      接続名 接続の名前。
      接続 URL このフィールドは自動的に https://api.docusign.net に設定されます。
      認証情報
      統合キー DocuSignアプリケーションを登録手順で生成した API 統合キー。
      キーペア ID DocuSign統合のための RSA キーペアを生成手順で生成した秘密鍵のキーペア ID。
      対象者 URI URI として account.docusign.com を入力します。
      キーストアパスワード Java Key Store 証明書の生成手順で作成したアップロード済み JKS ファイルに関連付けられたパスワード。
    8. [ キーストア] を選択して、デバイス上の JKS ファイルを見つけます。

      JKS ファイルの作成の詳細については、「 Java Key Store 証明書の生成」を参照してください。

    9. [OAuth トークンを作成して取得] を選択します。
    10. 統合プロファイルフォームで、[ 接続を検証 ] を選択して、この統合の接続と資格情報の詳細を確認します。
      接続を検証すると、サブスクリプション API のダウンロードが確認されます。

    次のタスク

    統合が接続されると、 ServiceNow インスタンスでソフトウェアモデルとソフトウェアサブスクリプションが自動的に作成され、毎日更新されます。

    統合プロファイルを作成した後、次の場所に移動して、 ソフトウェア資産ワークスペース 内のプロファイルに関する情報を表示します ライセンス操作 > ユーザーサブスクリプション > 直接統合プロファイル. 統合プロファイルを選択すると、次の関連リストを表示できます。デフォルトビューの統合プロファイルに次の関連リストが表示されない場合は、[詳細] タブからカスタム統合ビューを選択できます。
    • ソフトウェアモデル
    • スケジュール済みジョブ
    • スケジュール済みジョブの結果
    • 認識されないサブスクリプション識別子
    • ソフトウェアサブスクリプション
    • サブスクリプション識別子除外ルール
    • サブスクリプションユーザー除外ルール

    統合プロファイルを作成した後、サブスクリプション除外ルールを定義して、特定のサブスクリプションをライセンスコストの計算対象にしないようにすることができます。詳細については、「SaaS および SSO アプリケーションのサブスクリプション除外」を参照してください。

    一意の接続を持つ複数の統合プロファイルを設定する場合は、子エイリアスを作成して、統合プロファイルごとに異なる構成と設定を管理します。詳細については、「子エイリアスを作成して複数の統合プロファイルを設定」を参照してください。

    自動生成されたソフトウェアモデルのソフトウェアエンタイトルメントを作成し、所有するソフトウェアに対して使用済みソフトウェアを追跡します。
    調整は、サブスクリプションでスケジュール済みジョブとして、またはオンデマンドで実行されます。調整結果は、 ライセンスワークベンチ (クラシックアプリケーションソフトウェア資産管理 ) または ライセンス使用状況ビュー (ソフトウェア資産ワークスペース) で表示できます。これらの結果を使用して、ライセンスコンプライアンスの状況を判断し、非準拠を修正します。