SAP Concur スポークのセットアップ

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

    • SAP Concur でカスタム OAuth アプリケーションを作成して ServiceNow インスタンスと SAP Concur を統合し、ServiceNow 要求を認証します。

    始める前に

    • 統合ハブサブスクリプションを要求します。
    • SAP Concur スポークを有効化します。
    • 必要なロール：admin

    手順

    1. OAuth プロバイダーとして SAP Concur を登録します。
      1. 次のように移動する。 システム OAuth > アプリケーションレジストリー.
      2. [New] をクリックします。
        「どのような OAuth アプリケーションですか？」というメッセージが表示されます。
      3. [サードパーティ OAuth プロバイダーに接続します] を選択します。
        空のアプリケーション登録フォームが表示されます。
      4. フォームに、これらの値を入力します。
        フィールド 説明
        名前 アプリケーションレジストリを一意に識別する名前です。たとえば、SAP Concur OAuth です。
        クライアント ID SAP Concur クライアントアプリケーションのクライアント ID です。この値を取得するには、 SAP Concur 実装チームにお問い合わせください。
        クライアント シークレット SAP Concur クライアントアプリケーションのクライアントシークレットです。この値を取得するには、 SAP Concur 実装チームにお問い合わせください。
        デフォルトの権限許可タイプ トークンを確立するために使用される権限許可タイプです。[リソース所有者のパスワード認証情報] を選択します。
        トークン URL ServiceNow インスタンスがアクセストークンを取得する URL です。トークン URL のフォーマットは、https://<host-name>/oauth2/v0/token です。ここでは、ホスト名は SAP Concur がインストールされているターゲットホストの完全修飾ドメイン名です。
        リダイレクト URL OAuth コールバックエンドポイントのフォーマット：https://<instance>.service-now.com/oauth_redirect.do
      5. フォームヘッダーを右クリックし、[保存] をクリックします。
        • OAuth 認証情報が検証され、[リダイレクト URL] に情報が入力されます。
        • [OAuth エンティティプロファイル] に [リソース所有者のパスワード認証情報] として [権限許可タイプ] が入力されます。たとえば、[OAuth エンティティプロファイル] が、デフォルトの [名前]、[SAPConcur] で作成されます。
    2. SAP Concur スポークの認証情報レコードを作成します。
      1. 次のように移動する。 接続 & 認証情報 > 認証情報.
      2. [New] をクリックします。
        「作成する認証情報のタイプは？」というメッセージが表示されます。
      3. [OAuth 2.0 認証情報] を選択します。
      4. フォームに、これらの値を入力します。
        フィールド 必要な値
        名前 レコードを一意に識別する名前を入力します。たとえば、SAP Concur Cred を入力します。
        有効 認証情報レコードを積極的に使用するオプションです。
        OAuth エンティティ プロファイル カスタム SAP Concur アプリケーションを OAuth プロバイダーとして登録したときに作成した OAuth プロファイルです。たとえば、 SAPConcur を選択します。
        適用先 この認証情報を使用できる MID サーバーを選択します。たとえば、[すべての MID サーバー] を選択します。
        順番 この認証情報を適用する順番を選択します。たとえば、「100」と入力します。
      5. レコードを保存します。
    3. SAP Concur スポークの接続レコードを作成します。
      1. 次のように移動する。 接続 & 認証情報 > 接続 & 資格情報エイリアス.
      2. レコードの [SAPConcur] を開きます。
      3. [接続] タブで、[新規] をクリックします。
      4. フォームに、次の値を入力します。
        フィールド 必要な値
        名前 接続レコードを一意に識別する名前です。たとえば、SAP Concur 接続を入力します。
        認証情報 SAP Concur のために作成された認証情報レコードです。たとえば、[SAP Concur Cred] を選択します。
        接続 URL SAP Concur に接続するための接続 URL を次のフォーマットで入力します：<Host>/api
        ホスト SAP Concur がインストールされているターゲットホストの完全修飾ドメイン名です。たとえば、us.api.concursolutions.com や eu.api.concursolutions.com です。
        プロトコル https
        ベースパス /api
      5. [送信] をクリックします。
    4. SAP Concur API ユーザー認証情報を指定して、OAuth トークンを生成します。
      1. 次のように移動する。 接続 & 認証情報 > 認証情報.
      2. 作成された認証情報レコードを開きます。
        たとえば、[SAP Concur Cred] です。
      3. [OAuth トークンの取得] 関連リンクをクリックし、 SAP Concur API ユーザー認証情報を指定して OAuth トークンを生成します。
    5. [SAP Concur Event Subscription Service] 接続を設定します。
      1. 次のように移動する。 プロセス自動化 > Flow Designer (フローデザイナー).
      2. [接続] タブをクリックします。
      3. [SAP Concur Event Subscription Service] 接続エイリアスを見つけて、[詳細を表示] をクリックします。
      4. スポークを初めて設定する場合は、[設定] を選択するか、または [編集] をクリックします。
      5. [接続] フォームのフィールドに入力します。
        フィールド 説明
        名前 接続エイリアスレコードの名前です。
        接続 URL 接続 URL の形式は https://www-<Region>.api.concursolutions.com です。

        <Region> を適切な SAP Concur リージョンに置き換えます。
        バージョン 「v4」と入力します。
        トークン URL トークン URL の形式は https://<Region>.api.concursolutions.com/oauth2/v0/token です。

        <Region> を適切な SAP Concur リージョンに置き換えます。
        クライアント ID SAP Concur クライアントアプリケーションのクライアント ID です。この値を取得するには、 SAP Concur 実装チームにお問い合わせください。
        クライアント シークレット SAP Concur クライアントアプリケーションのクライアントシークレットです。この値を取得するには、 SAP Concur 実装チームにお問い合わせください。
      6. [OAuth トークンを作成して取得] をクリックします。
      OAuth トークンが正常に生成された旨の確認メッセージが表示されます。
    6. [SAP Concur v4 APIs] 接続を設定します。
      1. 次のように移動する。 プロセス自動化 > Flow Designer (フローデザイナー).
      2. [接続] タブをクリックします。
      3. [SAP Concur v4 APIs] 接続エイリアスを見つけて、[詳細を表示] をクリックします。
      4. [編集] をクリックするか、スポークを初めて設定する場合は、[設定 (Configure)] をクリックします。
      5. [接続] フォームのフィールドに入力します。
        フィールド 説明
        名前 接続エイリアスレコードの名前です。
        接続 URL 接続 URL の形式は https://<Region>.api.concursolutions.com です。

        <Region> を適切な SAP Concur リージョンに置き換えます。
        バージョン 「v4」と入力します。
        トークン URL トークン URL の形式は https://<Region>.api.concursolutions.com/oauth2/v0/token です。

        <Region> を適切な SAP Concur リージョンに置き換えます。
        クライアント ID SAP Concur クライアントアプリケーションのクライアント ID です。この値を取得するには、 SAP Concur 実装チームにお問い合わせください。
        クライアント シークレット SAP Concur クライアントアプリケーションのクライアントシークレットです。この値を取得するには、 SAP Concur 実装チームにお問い合わせください。
      6. [OAuth トークンを作成して取得] をクリックします。
        新しいウィンドウでは、[ユーザー名] と [パスワード] の入力を求められます。
      7. [ユーザー名] には SAP Concur インスタンスの会社 ID を入力し、[パスワード] には会社要求トークンの値を入力します。
        注:
        SAP Concur 実装チームに連絡し、会社 ID と会社要求トークンの値を入手してください。
      8. [OAuth トークンを取得 (Get OAuth Token)] をクリックします。
    7. SAP Concur ユーザーマッピングモジュールで、 SAP Concur ユーザーを ServiceNow ユーザーにマッピングします。
      1. 次のように移動する。 SAP Concur スポーク > SAP Concur ユーザーマッピング.
      2. [New] をクリックします。
      3. フォームに、これらの値を入力します。
        フィールド 説明
        ServiceNow ユーザー ユーザー [sys_user] テーブルのユーザーレコードへの参照です。
        SAP Concur ユーザー ID SAP Concur で必要なユーザーのユーザー ID です。
      4. [送信] をクリックします。
        注:
        ユーザーが SAP Concur ユーザーマッピングモジュールの対応する SAP Concur ユーザー ID にマッピングされることなく SAP Concur 経費エントリモジュールのデータにアクセスしようとすると、このエラーメッセージが表示されます。ユーザー名がアドミンのユーザーは存在しません。

        ServiceNow ユーザーを SAP Concur の対応するユーザー ID にマッピングし、SAP Concur 経費エントリモジュールのデータにアクセスします。

      • SAP Concur スポークが設定されます。
      • データが取得され、 SAP Concur経費エントリモジュールおよび SAP Concur経費レポートモジュールに表示されます。