SAP Concur Spoke を設定

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

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

    始める前に

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

    手順

    1. OAuth プロバイダーとして SAP Concurを登録します。
      1. 移動先 システム OAuth > アプリケーションレジストリー.
      2. [新規] をクリックします。
        「どのような 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 ConcurSpoke の資格情報レコードを作成します。
      1. 移動先 接続 & 認証情報 > 資格情報.
      2. [新規] をクリックします。
        「作成する資格情報のタイプは？」というメッセージが表示されます。
      3. [OAuth 2.0 資格情報] を選択します。
      4. フォームに、これらの値を入力します。
        フィールド 必要な値
        名前 レコードを一意に識別する名前を入力します。たとえば、SAP Concur Cred を入力します。
        有効 資格情報レコードを積極的に使用するオプションです。
        OAuth エンティティ プロファイル カスタム SAP Concurアプリケーションを OAuth プロバイダーとして登録したときに作成した OAuth プロファイルです。たとえば、 SAPConcur を選択します。
        適用先 この認証情報を使用できる MID Server を選択します。たとえば、[すべての MID Server] を選択します。
        順番 この認証情報を適用する順番を選択します。たとえば、「100」と入力します。
      5. レコードを保存します。
    3. SAP ConcurSpoke の接続レコードを作成します。
      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 ConcurAPI ユーザー資格情報を指定して、OAuth トークンを生成します。
      1. 移動先 接続 & 認証情報 > 資格情報.
      2. 作成した資格情報レコードを開きます。
        例: SAP Concur 資格情報
      3. [OAuth トークンの取得] 関連リンクをクリックし、 SAP ConcurAPI ユーザー資格情報を指定して OAuth トークンを生成します。
    5. [SAP Concur Event Subscription Service] 接続を設定します。
      1. 移動先 プロセス自動化 > フローデザイナー.
      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. 移動先 プロセス自動化 > フローデザイナー.
      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. [新規] をクリックします。
      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経費レポートモジュールに表示されます。