認証コード権限許可を使用した Docusign eSignature スポークの設定

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

    • 認証コードを使用して ServiceNow インスタンスと Docusign eSignature スポークを統合し、ServiceNow 要求を認証します。

    始める前に

    • 統合ハブサブスクリプションを要求します。
    • Docusign eSignature スポークをアクティブ化します。
    • 必要なロール：admin
    重要:
    認証コード権限許可を使用して Docusign eSignature スポークを設定する場合は、JWT 権限許可を使用してスポークを設定する必要はありません。

    Docusign アカウントの設定

    Docusign アカウントからカスタム OAuth アプリケーションを構成し、Docusign eSignature スポークで認証を有効にします。

    このタスクについて

    Docusign アカウントから、次の手順を完了します。カスタムアプリケーションの作成と構成については、Docusign 開発者センターのドキュメントを参照してください。Docusign は、スクリプト化された Webhook を使用して、署名済みドキュメントデータを ServiceNow インスタンスに送信します。これにより、ドキュメントが署名されるまでフローデザイナーでフローを一時停止し、フローでドキュメントデータを使用できます。

    始める前に

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

    手順

    1. アドミンとして Docusign アカウントにログインします。
    2. Docusign アカウントから、アプリケーションを登録します。
      注:
      [ユーザーアプリケーション (User Application)] の [認証コード許可 (Authorization Code Grant)] オプションを選択していることを確認します。
    3. インテグレーターキーと秘密キーを生成します。
    4. サードパーティ OAuth プロバイダーとして ServiceNow インスタンスでアプリを登録するインテグレーターキーおよび秘密鍵の値を記録します。
      「Docusign eSignature スポークの接続を設定する」で、これらの値が必要になります。
    5. Docusign アカウントに ServiceNow OAuth リダイレクト URL を追加します。
      1. 移動先 統合 > アプリとキー.
      2. [アプリと統合キー (Apps and Integration Keys)] で、必要なアプリを見つけます。
      3. 必要なアプリケーションについて、[アクション] ドロップダウンリストをクリックし、[編集] をクリックします。
      4. [追加の設定] で、[URIを追加] をクリックし、次の形式で OAuth コールバックエンドポイントを入力します。「https://<インスタンス>.service-now.com/oauth_redirect.do」
        Docusign アカウントにリダイレクト URI を追加します。
    6. Docusign アカウントから [アカウントベース URI] の値を取得します。
      1. 移動先 統合 > アプリとキー.
      2. [マイ アカウント情報 (My Account Information)] で、アカウント ベース URI の値を確認できます。
        アカウントベース URI。
      3. 後で使用するためにこの値をコピーして記録しておきます。

    Docusign eSignature スポークの接続を設定する

    ServiceNow 要求を認証する認証コード権限許可を使用して、ServiceNow インスタンスと Docusign アカウントインスタンスを統合します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > Flow Designer.
    2. [接続] タブをクリックします。
    3. [すべての接続を検索] フィールドに「Docusign」と入力します。
    4. Docusign のエイリアスを見つけて、[詳細を表示] をクリックします。
      注:
      [接続を追加] はクリックしないでください。
      Docusign eSignature スポークの接続テンプレート
    5. スポークを初めて設定する場合は、[設定 (Configure)] をクリックします。
      Docusign eSignature スポークの初めての接続の設定
    6. [接続の設定] フォームのフィールドに記入します。
      表 : 1. 接続の設定フォーム
      フィールド 説明
      接続名 接続を識別する一意の名前です。
      接続 URL Docusign 環境に接続するためのアカウントベース URI。この値は、Docusign アカウントから取得できます。詳細については、「Docusign アカウントの設定」を参照してください。
      API バージョン Docusign API のバージョン です。デフォルト値は v2.1 です。
      認証 URL Docusign 認証 URL。
      • 開発者サンドボックス環境の場合は、「https://account-d.docusign.com/oauth/auth」と入力します。
      • 本番システムの場合は、「https://account.docusign.com/oauth/auth」と入力します。
      トークン URL ServiceNow インスタンスがアクセストークンを取得する URL です。
      OAuth クライアント ID Docusign アカウントのインテグレーターキー。
      OAuth クライアントシークレット Docusign アカウントのシークレットキー (クライアントシークレット)。
      OAuth リダイレクト URL 次の形式で OAuth コールバックエンドポイントを入力します：https://<instance>.service-now.com/oauth_redirect.do
      注:
      この URL は必ず Docusign アカウントに追加してください。詳細については、「Docusign アカウントの設定」を参照してください。

      Docusign 接続。

    7. [OAuth トークンを設定して取得 (Configure and get OAuth Token)] をクリックします。