DocuSign との統合

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：9分

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

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

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

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

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

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

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

    始める前に

    DocuSign 必要なロール：admin

    手順

    1. DocuSign デモ (非本番) アカウントにログインします。
    2. プロファイル画像を選択します。
    3. [ マイ アプリとキー] を選択します。
      • 本番環境で使用する準備ができている以前の統合の API 統合キーが既にある場合は、 ステップ 33 に進みます。
      • クライアントシークレットを保存していない場合は、新しいシークレットを生成する必要があります。
    4. 左側のペインで、 統合 > アプリとキー.
    5. [ アプリと統合キー (Apps and Integration Keys)] セクションで、[ アプリと統合キーの追加 (ADD APP AND INTEGRATION KEY)] を選択します。
    6. [統合キーを追加] フォームで、[ アプリ名 ] フィールドに名前を入力し、[アプリを作成] を選択します。
    7. [追加設定] セクションの [リダイレクト URI] フィールドで [URI の追加] を選択します。
    8. https://oauth.pstmn.io/v1/browser-callback を追加します。
    9. もう一度 [URI を追加] を選択し、https:// ServiceNow instance.service-now.com/oauth_redirect.do を追加します。
    10. [ADD SECRET KEY] を選択します。
      統合キー (クライアント 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. [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 回選択して、API 呼び出しを 20 回行います。
      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. [ADD SECRET KEY] を選択します。
      本番アカウントの秘密キー (クライアントシークレット) を安全な場所に保存して、 ServiceNow インスタンスで使用します。
    40. [保存] を選択します。

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

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

    始める前に

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

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

    このタスクについて

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

    手順

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

    タスクの結果

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

    次のタスク

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

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

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