DocuSign との統合

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む9読むのに数分

    • インスタンスをサービスとDocuSignデータ連携ServiceNowして、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用することができます。

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

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

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

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

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

    始める前に

    DocuSign 必要なロール：admin

    手順

    1. デモ (非本番) アカウントにログインします DocuSign 。
    2. プロフィール写真を選択します。
    3. [マイ アプリとキー] を選択します。
      • 本番環境で使用する準備ができている以前の統合の API 統合キーが既にある場合は、 ステップ 33 に進みます。
      • クライアントシークレットが保存されていない場合は、新しいシークレットを生成する必要があります。
    4. 左側のペインで、 統合 > アプリとキー.
    5. [ Apps and Integration Keys (アプリと統合キー )] セクションで、[ ADD APP AND INTEGRATION KEY (アプリと統合キーの追加)] を選択します。
    6. [統合キーの追加 (Add Integration Key)] フォームで、[ アプリ名 (App Name )] フィールドに名前を入力し、[アプリを作成 (CREATE APPP)] を選択します。
    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] を選択します。
      後で Postman アプリで使用したり、インスタンスで ServiceNow 統合キー (クライアント ID) を使用したりするために、統合キー (クライアント ID) を安全な場所に保存します。
    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] フィールドに https://account-d.docusign.com/oauth/userinfo として URL を入力します。
    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. 管理ポータルの [アプリと統合キー (Apps and Integration KeysDocuSign)] に移動します。
    28. 選択 アクション > API ダッシュボードを表示 アプリケーションの横にあります。
    29. 20 件の API 呼び出しがすべて登録されるまで数分待ち DocuSign ます。
    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. [Save (保存)] を選択します。

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

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

    始める前に

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

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

    このタスクについて

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

    手順

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

    タスクの結果

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

    次のタスク

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

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

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