アカウントレベルで DocuSign と統合

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

    • ソフトウェア資産管理 アプリケーションを DocuSign サービスと統合することで、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用することができます。

    DocuSign リセラーを通じて行われた購入は、 DocuSign 標準請求システム内に反映されません。そのため、 ServiceNow利用可能なエンベロープ消費の API を介して値は返されません。

    重要:
    DocuSign によって Users API から lastLogin フィールドが削除され、ユーザーの最後のアクティビティはこの統合の一部として追跡されなくなりました。ソフトウェア資産管理 アプリケーションは、サブスクリプションのアサイン日に基づいて再利用候補を作成するようになりました。

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

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

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

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

    始める前に

    DocuSign 必要なロール：admin

    手順

    1. DocuSignデモ (非本番) アカウントにログインします。
    2. プロファイル画像を選択します。
    3. [ 自分のアプリとキー] を選択します。
      • 以前の統合の API 統合キーを本番環境で使用できる状態がすでにある場合は、 ステップ 33 に進みます。
      • クライアントシークレットを保存していない場合は、新しいシークレットを生成する必要があります。
    4. サイドペインで、 統合 > アプリとキー.
    5. [ アプリと統合キー] セクションで、[ アプリと統合キーを追加] を選択します。
    6. [統合キーを追加] フォームで、[ アプリ名 ] フィールドに名前を入力し、[アプリを作成] を選択します。
    7. [追加の設定] セクションの [リダイレクト URI] フィールドで [URI の追加] を選択します。
    8. https://oauth.pstmn.io/v1/browser-callback を追加します。
    9. もう一度 [URI の追加] を選択し、https:// ServiceNow instance.service-now.com/oauth_redirect.do を追加します。
    10. [秘密キーを追加] を選択します。
      統合キー (クライアント ID) とシークレットキー (クライアントシークレット) を安全な場所に保存して、後で Postman アプリで使用できるように保存し、統合キー (クライアント ID) を ServiceNow インスタンスに保存します。
    11. [保存] を選択します。
    12. Postman アプリの最新バージョンをダウンロードし、ログインをスキップします。
    13. 選択 新しいコレクション をクリックし、コレクションに名前を付けます。
    14. [ 認証] タブを選択します。
    15. [タイプ] リストメニューから [OAuth 2.0] を選択します。
    16. 名前を入力し、[ 構成オプション ] タブのフィールドに入力してトークンを作成します。
      フィールド 値
      コールバック URL https://oauth.pstmn.io/v1/browser-callback
      認証 URL https://account-d.docusign.com/oauth/auth
      アクセストークン URL https://account-d.docusign.com/oauth/token
      クライアント ID ステップ 10 で作成したDocuSignデモアカウントの統合キー。
      クライアントシークレット DocuSignデモアカウントの秘密キー ステップ 10。
    17. [ 新しいアクセストークンの取得] を選択します。
      DocuSignにリダイレクトされます。
    18. [承認] を選択します。
    19. アクセストークンが収集されて認証が完了したら、後で使用するためにアクセストークンをコピーします。
    20. [ 新しい要求 ] を選択して、アカウント ID の GET 要求を作成します。
    21. [取得] フィールドに URL を https://account-d.docusign.com/oauth/userinfo として入力します。
    22. [ヘッダー] タブで、[キー] の下の [認証] を選択し、[値] にベアラー <認証中にコピーしたアクセストークン> を入力します。
    23. [ 送信] を選択し、要求が完了したことを確認します。
      アカウント ID が応答本文に表示されます。
    24. GET 要求を複製します。
      [ ヘッダー] の下にある認証キーと値をコピーします。
    25. [GET] フィールドの URL を https://demo.docusign.net/restapi/v2/accounts/<account-id>/users に更新します。
      ここで、 account-id は前の要求から保存した ID です。
    26. [20 回 送信 ] を選択して 20 件の API 呼び出しを行います。
      DocuSign アドミンポータルからアプリケーションを登録するには、少なくとも 20 個の API 呼び出しを呼び出す必要があります。
    27. DocuSign管理ポータルの [アプリと統合キー] に移動します。
    28. 選択 アクション > API ダッシュボードを表示 アプリケーションの横にあります。
    29. DocuSign が 20 件の API コールをすべて登録するまで数分待ちます。
    30. 移動先 統合 > アプリとキー をクリックし、[ レビューのため送信] を選択します。
      5〜20分後、アプリケーションのレビューは完了です。アプリケーションを本番アカウントに昇格させることができます。
    31. 選択 アクション > Start-Go-Live レビュー アプリケーションを本番アカウントに昇格させます。
    32. 統合キーを管理する対象となる本番アカウントを選択します。
    33. DocuSign本番アカウントにログインします。
    34. プロファイル画像を選択します。
    35. [ アドミンに移動] を選択します。
    36. サイドペインで、 統合 > アプリとキー.
      ServiceNow インスタンスで統合プロファイルに使用する API アカウント ID を見つけます。
    37. アプリケーションの横にある アクション > 編集.
    38. [URI を追加] を選択し、https:// ServiceNow instance.service-now.com/oauth_redirect.do を追加します。
    39. [秘密キーを追加] を選択します。
      本番アカウントの秘密キー (クライアントシークレット) を安全な場所に保存して、 ServiceNow インスタンスで使用できるようにします。
    40. [保存] を選択します。

    アカウントレベルで DocuSign 統合プロファイルを作成する

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

    始める前に

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

    ServiceNow 必要なロール:sam_integrator

    このタスクについて

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

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      コア UI
      1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [新規] を選択します。
      3. [DocuSign 統合プロファイル] を選択します。
      ソフトウェア資産ワークスペース
      1. 移動先 ライセンス操作 > ユーザーサブスクリプション > 直接統合プロファイル.
      2. [新規] を選択します。
      3. ドロップダウンリストから [DocuSign ] を選択します。
      4. [Continue (続行)] を選択します。
    2. フォームで、フィールドに入力します。
      表 : 2. 統合プロファイルフォーム
      フィールド 説明
      表示名 データ連携プロファイルの名前例:DocuSign 統合
      統合タイプ デフォルト値は [アカウントレベル] に設定されています。
      クライアント ID DocuSignアプリケーションを登録手順の SaaS admin アカウントで作成された OAuth アプリケーションのクライアント ID。
      リダイレクト URL 認証後にリダイレクトされる OAuth プロバイダーの URL。この値は、自動的に入力されます。
      テクニカルアカウント ID DocuSign本番アカウントの API アカウント ID。
      インスタンス URL DocuSign本番アカウントへのアクセスに使用するログインページの URL。このフィールドは自動的に https://account.docusign.com に設定されます。
      クライアントシークレット DocuSignアプリケーションを登録手順で作成されたクライアント ID に関連付けられたパスワード。
      プロファイルタイプ 統合プロファイルのタイプ。この値は自動的に [DocuSign サブスクリプション] に設定されます。
    3. 各プロセスの [ベンダー構成] フィールドで指定された必要なユーザーロールまたは API 権限を確認して、セキュリティリスクを最小限に抑え、 SaaS ライセンスを最適化します。
      注:
      必要なロールとスコープの詳細については、「 最小限のユーザー権限 」の表を参照してください。

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

      • [ サブスクリプションを再利用] チェックボックスはデフォルトでオンになっています。サブスクリプションを再利用しない場合は、このチェックボックスをオフにします。これをクリアすると、削除候補は作成されますが、再利用サブスクリプションサブフローはトリガーされないか、再利用プロセスは開始されません。

    4. [送信] を選択します。
      ドラフトの統合プロファイルが作成されます。
    5. 統合プロファイルで [OAuth トークンの取得] を選択し、手順に従って OAuth トークンを取得します。
      注:
      この手順を実行するために必要なロールについては、「 最小限のユーザー権限 」表を参照してください。
    6. 統合プロファイルフォームで、[ 接続を検証 ] を選択して、この統合の接続と資格情報の詳細を確認します。

      接続を検証すると、サブスクリプションのダウンロード API は確認されますが、サブスクリプションの再利用 API は確認されません。

    タスクの結果

    現在の日付の最大 1 年前までに個々のユーザーが実行したイベントを表示できます。詳細については、「 ソフトウェア再利用ルールのレビュー」を参照してください。 ソフトウェア資産管理 は、プロファイルの作成日に関係なく、ユーザーサブスクリプションのダウンロードを開始した時点からイベントをプルします。

    次のタスク

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

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

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

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

    自動的に生成されたすべての再利用ルールを確認して、ユーザーサブスクリプションを再利用します。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。

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