DocuSign との統合

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：10分

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

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

    注:
    DocuSign は、ユーザー API から lastLogin フィールドを削除しました。そのため、ユーザーの最後のアクティビティは、この統合の一部として追跡されません。

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

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

    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. [秘密キーの追加] を選択します。
      後で Postman アプリで使用するために統合キー (クライアント ID) と秘密キー (クライアントシークレット) を安全な場所に保存し、統合キー (クライアント ID) を ServiceNow インスタンスに保存します。
    11. [Save (保存)] をクリックする。
    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. [GET] フィールドに 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 アドミンポータルの [アプリと統合キー (Apps and Integration Keys)] に移動します。
    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. [Save (保存)] をクリックする。

    DocuSign 統合プロファイルの作成

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

    始める前に

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

    ServiceNow 必要なロール:sam_integrator または admin

    このタスクについて

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

    手順

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

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

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

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

      接続を検証すると、Download Subscriptions API は検証されますが、Reclaim Subscriptions API は検証されません。

    タスクの結果

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

    次のタスク

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

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

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

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