注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

OAuth 2.0 を使用したユーザーに紐づく SAP ライトバック

このページでは、SAP で OAuth 2.0 サーバーをセットアップする手順と、Foundry で OAuth 2.0 クライアントをセットアップする手順を説明します。

SAP で OAuth 2.0 サーバーをセットアップする

前提条件

  • Palantir Foundry Connector 2.0 for SAP Applications(以下「コネクター」)の SP21 以降
  • SAP の Foundry テクニカルユーザーが SYSTEM ユーザーであること
  • Foundry テクニカルユーザーと、Foundry から SAP へのライトバックを行うエンドユーザーに /PALANTIR/OAUTH_CLIENT が割り当てられていること
  • エンドユーザーに /PALANTIR/CONTENT_FUNCTION_ALL が割り当てられていること
  • /sap/public/bc ノード配下のすべてのサービスが有効化されていること(OAuth 2.0 設定用)
    • /sap/bc/sec/oauth2*
    • /default_host/sap/bc/webdynpro/sap/oauth2_authority
  • SAP Gateway がアクティブであること
  • SAP_BASIS(SAP NetWeaver と SAP S/4HANA の両システムに適用される技術コンポーネントのバージョン)が 7.4 SP09 以降であること(OAuth 2.0 および OData のサポート)

参考資料

OAuth 2.0 の設定

  1. SOAUTH2 トランザクションを実行します。
  2. 作成... を選択します。
  3. OAuth 2.0 クライアントIDに Foundry テクニカルユーザーのユーザー名を入力します。
  4. 次へ > を選択します。
  5. ユーザーIDに Foundry テクニカルユーザーのユーザー名を入力します。
  6. クライアントのユーザーIDとパスワードと SSL クライアント証明書の両方がオンになっていることを確認してください。
  7. 次へ > を選択します。
  8. リダイレクト URI を https://<FOUNDRY_DOMAIN>/workspace/oauth2-clients/callback に設定します。
  9. 次へ > を選択します。
  10. スコープ割り当てを追加し、OAuth 2.0 スコープIDを /PALANTIR/SRV_0001、説明を Palantir Foundry writeback using SAP functions などに設定します。
  11. 次へ > を選択してから、完了を選択します。

OData の設定

  1. SAP のサービスの保守ページで、サービスの階層をたどり、opu > odata > Palantir を見つけます。
  2. Palantir を右クリックし、サービスの有効化を選択します。
  3. 確認プロンプトが表示されたら、はいを選択します。
  4. サービスの作成/変更タブで、対話オプションの GUI 設定を選択します。
  5. 名前が ~CHECK_CSRF_TOKEN、値が 0(ゼロ)のパラメーターを追加します。
  6. 次のページの説明に従って CSRF_TOKEN 検証を無効にします:https://help.sap.com/doc/saphelp\_hba/1.0/de-DE/e6/cae27d5e8d4996add4067280c8714e/content.htm
  7. /IWFND/MAINT_SERVICE トランザクションを実行します。
  8. システムエイリアスのシステムエイリアスを追加を選択します。
  9. 次の値でシステムエイリアスを追加します。
    • サービスドキュメント識別子: /PALANTIR/SRV_0001
    • ユーザーロール: 空欄
    • ホスト名: 空欄
    • SAP システムエイリアス: LOCAL
    • メタデータのデフォルト: オフ
    • デフォルトシステム: オン
    • 技術サービス名: /PALANTIR/SRV
    • 外部サービス名: ODATA_SRV
    • バージョン: 1
    • ユーザー名: 空欄

Foundry で OAuth 2.0 クライアントをセットアップする

この手順は、アウトバウンドアプリケーションを設定するで説明している一般的な方法に沿ったものですが、SAP システム向けに調整されています。

SAP 接続に合ったセットアップを選択します。

アウトバウンドアプリケーションのセットアップ

  1. Control Panel に移動し、組織の設定のアウトバウンドのアプリケーションを選択します。
  2. 新しいアプリケーションを追加を選択します。
  3. アプリケーション名に、たとえば SAP システムの名前を入力します。
  4. 承認プロンプトに、認可操作を説明する文(例:Allow Foundry to act on your behalf in SAP?)を設定します。
  5. OAuth 2.0 サーバー接続で、Foundry ワーカーの選択肢を選択します。
  6. 認可ページの URL に、SAP の HTTPS ポートを含む SAP OAuth 2.0 認可エンドポイントを設定します。<SAP_DOMAIN> を SAP のホスト名に、<SAP_PORT> をその HTTPS ポートに置き換えます。
https://<SAP_DOMAIN>:<SAP_PORT>/sap/bc/sec/oauth2/authorize
  1. トークンエンドポイント URL に、SAP の HTTPS ポートを含む SAP OAuth 2.0 トークンエンドポイントを設定します。
https://<SAP_DOMAIN>:<SAP_PORT>/sap/bc/sec/oauth2/token
  1. 出力ポリシーで、SAP システムにアクセスできるネットワーク内にインストールされた Data Connection の Agent を経由してトラフィックをルーティングする Agent プロキシのエグレスポリシーを選択します。

Foundry ワーカーの選択肢、SAP の認可およびトークンエンドポイント URL、Agent プロキシのエグレスポリシーを設定したアウトバウンドアプリケーション。

  1. OAuth 2.0 設定で、クライアントIDを SAP OAuth 2.0 サーバー設定のクライアントIDに設定します。スコープに /PALANTIR/SRV_0001 を追加します。
  2. アウトバウンドアプリケーションを保存します。
  3. これで、SAP Webhook の作成時にこのアウトバウンドアプリケーションを使用できます。

アウトバウンドアプリケーションの設定オプションの詳細については、アウトバウンドアプリケーションを設定するを参照してください。

SAP Data Accelerator を使用したアウトバウンドアプリケーションのセットアップ

SAP Data Accelerator を通じてユーザーに紐づくライトバックを有効にするには、SAP ERP ソースにトークン取得 Webhook と更新トークン Webhook の2個の Webhook を作成します。次に、アウトバウンドアプリケーションで両方の Webhook を選択します。これらの Webhook は、ソースの認証設定と SAP Data Accelerator 接続設定を使用して、トークンの交換と更新を行います。

開始する前に、SAP OAuth 2.0 サーバーのセットアップを完了し、SAP Data Accelerator を使用するように SAP ERP ソースを設定してください。また、アウトバウンドアプリケーションを管理する権限も必要です。

トークン取得 Webhook とリフレッシュトークン Webhook を作成する

両方の Webhook で関数の設定をオフにする

トークン取得 Webhook とリフレッシュトークン Webhook を作成するときは、関数の設定をオフにしてください。この設定が有効になっていると、Webhook が関数として公開され、アウトバウンドアプリケーションで使用できなくなります。

各 Webhook のタスクタイプを選択した後、例を挿入を使用します。これにより、タスク本文テンプレートが自動的に入力され、入力パラメーターと出力パラメーターが、そのデータ型やレスポンスフィールドへのマッピングも含めて作成されます。以下のパラメーターテーブルを使用して、生成された設定を確認します。

SAP ERP トークン取得 Webhook のタスクタイプが選択され、タスク本文テンプレートの横に表示されている「例を挿入」ボタン。

トークン取得 Webhook とリフレッシュトークン Webhook の権限付与

両方の Webhook で、リクエスト設定 > 権限付与のアウトバウンドアプリケーションを選択されていませんのままにします。これらの Webhook は、SAP ソースの認証を使用して、アウトバウンドアプリケーションのトークンを取得および更新します。ここでそのアプリケーションを選択すると、循環依存関係が発生します。

両方の Webhook で、Webhook の安全性をデフォルトの API を書き込むのままにします。

以下の手順に従って、同じ SAP ERP ソースに2個の Webhook を作成します。

  1. まず、トークン取得 Webhook を作成します。Data Connection でソースを開き、Webhook を作成を選択します。
  2. Get OAuth Token などの Webhook 名を入力し、関数の設定をオフにします。
  3. リクエスト設定で、タスクタイプを sap-erp-oauth2-token-webhook-task に設定します。
  4. 空のタスク本文 Template の横にある例を挿入を選択して、トークン取得 Webhook の設定を生成します。生成されたパラメーターを以下のリファレンスと照合して確認し、Webhook を保存します。
  5. 次に、同じソースにリフレッシュトークン Webhook を作成します。Refresh OAuth Token などの名前を入力します。
  6. 関数の設定をオフにし、タスクタイプを sap-erp-oauth2-refresh-webhook-task に設定します。
  7. 例を挿入を選択して、リフレッシュトークン Webhook の設定を生成します。生成されたパラメーターを以下のリファレンスと照合して確認し、Webhook を保存します。

トークン取得 Webhook には、次の入力パラメーターが必要です。

入力パラメーターデータ型必須
client_id文字列はい
redirect_uri文字列はい
authorization_code文字列はい
code_verifier任意の文字列送信先アプリケーションで PKCE を有効化がオンになっている場合は必須です。

生成されたタスク本文では、これらの入力が次のようにマッピングされます。

Copied!
1 2 3 4 5 6 { "client_id": {{json client_id}}, "redirect_uri": {{json redirect_uri}}, "authorization_code": {{json authorization_code}}, "code_verifier": {{json code_verifier}} }

リフレッシュトークン Webhook には、次の入力パラメーターが必要です。

入力パラメーターデータ型必須
client_id文字列はい
refresh_token文字列はい

生成されたタスク本文では、これらの入力が次のようにマッピングされます。

Copied!
1 2 3 4 { "client_id": {{json client_id}}, "refresh_token": {{json refresh_token}} }

Foundry は、権限付与とトークン更新の際にこれらの入力値を渡します。各リクエストに適切な値が渡されるように、タスク本文内のパラメーター参照を保持してください。

例を挿入は、両方の Webhook に対して次の出力パラメーターも作成します。レスポンスで、各変数に、指定された名前、データ型、レスポンスキーを持つ専用の出力パラメーターがあることを確認します。Webhook を手動で設定する場合は、以下のテーブルに示すとおり、行ごとに1個の出力パラメーターを作成し、対応するレスポンスキーにマッピングします。

出力パラメーターデータ型レスポンスキー
access_token文字列access_token
scope文字列scope
token_type任意の文字列token_type
expires_in任意の文字列expires_in
refresh_token任意の文字列refresh_token

次の例は、トークン取得 Webhook に設定された入力と出力マッピングを示しています。

任意のコード検証子を含む4個の入力パラメーターと、JSON レスポンスキーによって抽出される出力パラメーターを持つトークン取得 Webhook。

リフレッシュトークン Webhook は、2個の入力パラメーターとともに同じ出力マッピングを使用します。

クライアントIDとリフレッシュトークンの入力、および対応する JSON レスポンスフィールドから抽出される出力パラメーターを持つリフレッシュトークン Webhook。

アウトバウンドアプリケーションを設定する

以下の手順に従って、保存した2個の Webhook を使用して OAuth 2.0 接続を設定します。

  1. Control Panel で、組織の設定 > アウトバウンドのアプリケーションを開き、新しいアプリケーションを追加を選択します。
  2. アプリケーション名と、Allow Foundry to act on your behalf in SAP? などの承認プロンプトを入力します。
  3. OAuth 2.0 サーバー接続で、レガシーと表示されているオンプレミス Webhook を選択します。この選択肢により、アウトバウンドアプリケーションで SAP ソースの Data Accelerator 接続を使用できます。ソース自体は引き続き Foundry ワーカーで実行されます。
  4. ソース接続で、Webhook を作成した SAP ERP ソースを選択します。
  5. トークン Webhook を sap-erp-oauth2-token-webhook-task を使用する Webhook に設定し、更新トークン Webhook を sap-erp-oauth2-refresh-webhook-task を使用する Webhook に設定します。
  6. 認可ページの URL を https://<SAP_DOMAIN>/sap/bc/sec/oauth2/authorize に設定します。ユーザーがブラウザーからアクセスできる SAP URL を使用してください。トークンの交換と更新には SAP Data Accelerator を使用しますが、この対話型の権限付与ステップにはユーザーのコンピューターからのアクセスが必要です。
  7. OAuth 2.0 設定で、クライアントIDを SAP OAuth 2.0 設定で作成した OAuth 2.0 クライアントIDに設定します。その手順に従った場合、これは Foundry の技術ユーザーの SAP ユーザー名です。
  8. スコープに /PALANTIR/SRV_0001 を追加します。
  9. アウトバウンドアプリケーションを保存します。

オンプレミス Webhook(レガシー)を使用するアウトバウンドアプリケーション。SAP ERP ソース、トークン取得 Webhook とリフレッシュトークン Webhook、SAP 認可 URL、クライアントIDの例 PALANTIR、および /PALANTIR/SRV_0001 スコープが設定されています。

アウトバウンドアプリケーションをライトバックに使用する

同じ SAP ERP ソースで、BAPI を呼び出す Webhook を作成または編集します。この BAPI Webhook のリクエスト設定 > 権限付与 > アウトバウンドアプリケーションで、保存したアプリケーションを選択します。ユーザーがライトバックワークフローを実行したときに、有効なトークンをまだ持っていない場合、Foundry は SAP へのアクセスを承認するためのダイアログを表示します。その後、ライトバックはそのユーザーの SAP 認可を使用し、必要に応じてリフレッシュトークン Webhook が新しいアクセストークンを取得します。

(レガシー)Webhook ベースの OAuth 2.0 設定

レガシー

以下で説明する REST API Webhook の設定は、開発のレガシーフェーズにあり、追加の開発は予定されていません。新しく設定する場合は、Foundry で OAuth 2.0 クライアントを設定するで該当する接続設定を選択します。レガシーの方法の詳細については、(レガシー)カスタム Webhook ベースの OAuth 2.0 ハンドシェイクを参照してください。

以前は、SAP 用の OAuth 2.0 を設定するには、トークンフローと更新フローを手動で処理する Webhook を備えた専用の REST API ソースを作成する必要がありました。既存の SAP 統合でこの方法を使用している場合は、引き続き動作します。

ソース接続のセットアップ

SAP ソースの URL が HTTPS を使用していることを確認してください。そうでない場合、OAuth フローを使用すると Webhook が失敗します。

  1. 新しい REST API ソースを作成します。

REST API ソースを作成する

  1. SAP ソースで使用するベースドメイン URL とポートでソースを設定します。
  2. 基本認証を選択し、SAP への接続に使用するユーザー名とパスワードを追加します。

REST API ソースを設定する

  1. ソースを保存します。

OAuth 2.0 認可フローの Webhook のセットアップ

関数として公開された Webhook は非対応

関数として公開された Webhook は、レガシーのカスタム Webhook ベースの OAuth 2.0 アウトバウンドアプリケーションでは使用できません。トークン Webhook と更新 Webhook を作成する際は、関数としての公開が無効になっていることを確認してください。

  1. 新しい REST API ソースの概要ページで、Webhook を作成を選択します。

  2. Webhook に名前(SAP OAuth2 authorization code flow webhook など)を付けます。関数の設定がオフになっていることを確認してください。

  3. リクエスト設定ステップに進みます。

  4. 呼び出しで、リクエストの種類として POST を選択し、パスとして sap/bc/sec/oauth2/token を入力します。

  5. クエリパラメーターで、使用するクライアントがデフォルトのクライアントでない場合は、sap-client の設定が必要になることがあります。

Webhook の呼び出し

  1. 入力パラメーターまで下にスクロールし、次の3個のパラメーター(すべて文字列型)を追加します。
  • redirect_uri
  • client_id
  • authorization_code

Webhook の入力パラメーター

  1. 呼び出しまで上にスクロールして戻り、本体タブを選択します。
  2. フォーム URL エンコードを選択し、次の4件のエントリーを追加します。
  • grant_type → authorization_code
  • redirect_uri → redirect_uri 入力パラメーターにマッピング(方法は以下を参照)
  • client_id → client_id 入力パラメーターにマッピング
  • code → authorization_code 入力パラメーターにマッピング
  1. 入力パラメーターをマッピングするには、項目に @ を入力してから、入力パラメーターを選択します。該当するパラメーターを見つけて選択し、その下の追加を選択します。

入力パラメーターのマッピング

  1. 完了した本体の設定は次のようになります。

Webhook の本文

  1. レスポンスステップに進みます。
  2. 次の5個の出力パラメーターを作成します。すべて文字列型とし、レスポンスからキーで抽出するようにします。
  • access_token
  • token_type
  • expires_in
  • refresh_token
  • scope

これは access_token を作成する例です。すべての出力パラメーターをこのパターンに従って作成します。

Webhook の出力パラメーター

  1. Webhook を作成して続行を選択して Webhook を保存します。

OAuth 2.0 更新フローの Webhook のセットアップ

  1. REST API ソースから新しい Webhook を作成します。
  2. Webhook にほかと区別できる名前(SAP OAuth2 refresh flow webhook など)を付けます。関数の設定がオフになっていることを確認してください。
  3. リクエストメソッドは再び POST に設定し、同じパス(sap/bc/sec/oauth2/token)を使用します。
  4. 前の Webhook と同様に、必要に応じて sap-client をクエリパラメーターとして設定します。
  5. ヘッダータブで、次のヘッダーを追加します。
  • Content-Type → application/x-www-form-urlencoded

更新 Webhook のヘッダー

  1. 次の2個の入力パラメーター(どちらも文字列型)を設定します。
  • client_id
  • refresh_token
  1. 次に、本体タブで、次の3件のエントリーを追加します。
  • grant_type → refresh_token
  • client_id → client_id 入力パラメーターにマッピング
  • refresh_token → refresh_token 入力パラメーターにマッピング 更新 Webhook の本文
  1. 認可コードフローの Webhook とまったく同じ5個の出力パラメーターを作成します。すべて文字列型とし、レスポンスからキーで抽出するようにします。
  • access_token
  • token_type
  • expires_in
  • refresh_token
  • scope
  1. Webhook を作成して続行を選択して Webhook を保存します。

レガシーのアウトバウンドアプリケーションのセットアップ

  1. Foundry Control Panel に移動し、アウトバウンドのアプリケーションを選択します。
  2. アプリケーションに名前を付けてから、(レガシー)カスタム Webhook ベースの OAuth 2.0 ハンドシェイクに記載されているステップに従います。
  3. 先ほど作成した2個の Webhook のうち、認可コードフローの Webhook をトークン Webhook、更新フローの Webhook を更新トークン Webhookとして使用します。
  4. 認可ページの URL は、次の形式にします。
https://<SAP_DOMAIN>/sap/bc/sec/oauth2/authorize
  1. OAuth 2.0 設定で、クライアントIDを SAP OAuth 2.0 サーバー設定のクライアントIDに設定します。スコープに /PALANTIR/SRV_0001 を追加します。
  2. アウトバウンドアプリケーションを保存します。
  3. これで、SAP Webhook を作成する際に、このアウトバウンドアプリケーションを使用できます。