注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
このページでは、SAP で OAuth 2.0 サーバーをセットアップする手順と、Foundry で OAuth 2.0 クライアントをセットアップする手順を説明します。
SYSTEM ユーザーであること/PALANTIR/OAUTH_CLIENT が割り当てられていること/PALANTIR/CONTENT_FUNCTION_ALL が割り当てられていること/sap/public/bc ノード配下のすべてのサービスが有効化されていること(OAuth 2.0 設定用)
/sap/bc/sec/oauth2*/default_host/sap/bc/webdynpro/sap/oauth2_authoritySOAUTH2 トランザクションを実行します。https://<FOUNDRY_DOMAIN>/workspace/oauth2-clients/callback に設定します。/PALANTIR/SRV_0001、説明を Palantir Foundry writeback using SAP functions などに設定します。~CHECK_CSRF_TOKEN、値が 0(ゼロ)のパラメーターを追加します。/IWFND/MAINT_SERVICE トランザクションを実行します。/PALANTIR/SRV_0001LOCAL/PALANTIR/SRVODATA_SRV1この手順は、アウトバウンドアプリケーションを設定するで説明している一般的な方法に沿ったものですが、SAP システム向けに調整されています。
SAP 接続に合ったセットアップを選択します。
Allow Foundry to act on your behalf in SAP?)を設定します。<SAP_DOMAIN> を SAP のホスト名に、<SAP_PORT> をその HTTPS ポートに置き換えます。https://<SAP_DOMAIN>:<SAP_PORT>/sap/bc/sec/oauth2/authorize
https://<SAP_DOMAIN>:<SAP_PORT>/sap/bc/sec/oauth2/token

/PALANTIR/SRV_0001 を追加します。アウトバウンドアプリケーションの設定オプションの詳細については、アウトバウンドアプリケーションを設定するを参照してください。
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 は、SAP ソースの認証を使用して、アウトバウンドアプリケーションのトークンを取得および更新します。ここでそのアプリケーションを選択すると、循環依存関係が発生します。
両方の Webhook で、Webhook の安全性をデフォルトの API を書き込むのままにします。
以下の手順に従って、同じ SAP ERP ソースに2個の Webhook を作成します。
Get OAuth Token などの Webhook 名を入力し、関数の設定をオフにします。sap-erp-oauth2-token-webhook-task に設定します。Refresh OAuth Token などの名前を入力します。sap-erp-oauth2-refresh-webhook-task に設定します。トークン取得 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 に設定された入力と出力マッピングを示しています。

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

以下の手順に従って、保存した2個の Webhook を使用して OAuth 2.0 接続を設定します。
Allow Foundry to act on your behalf in SAP? などの承認プロンプトを入力します。sap-erp-oauth2-token-webhook-task を使用する Webhook に設定し、更新トークン Webhook を sap-erp-oauth2-refresh-webhook-task を使用する Webhook に設定します。https://<SAP_DOMAIN>/sap/bc/sec/oauth2/authorize に設定します。ユーザーがブラウザーからアクセスできる SAP URL を使用してください。トークンの交換と更新には SAP Data Accelerator を使用しますが、この対話型の権限付与ステップにはユーザーのコンピューターからのアクセスが必要です。/PALANTIR/SRV_0001 を追加します。
同じ SAP ERP ソースで、BAPI を呼び出す Webhook を作成または編集します。この BAPI Webhook のリクエスト設定 > 権限付与 > アウトバウンドアプリケーションで、保存したアプリケーションを選択します。ユーザーがライトバックワークフローを実行したときに、有効なトークンをまだ持っていない場合、Foundry は SAP へのアクセスを承認するためのダイアログを表示します。その後、ライトバックはそのユーザーの SAP 認可を使用し、必要に応じてリフレッシュトークン Webhook が新しいアクセストークンを取得します。
以下で説明する REST API Webhook の設定は、開発のレガシーフェーズにあり、追加の開発は予定されていません。新しく設定する場合は、Foundry で OAuth 2.0 クライアントを設定するで該当する接続設定を選択します。レガシーの方法の詳細については、(レガシー)カスタム Webhook ベースの OAuth 2.0 ハンドシェイクを参照してください。
以前は、SAP 用の OAuth 2.0 を設定するには、トークンフローと更新フローを手動で処理する Webhook を備えた専用の REST API ソースを作成する必要がありました。既存の SAP 統合でこの方法を使用している場合は、引き続き動作します。
SAP ソースの URL が HTTPS を使用していることを確認してください。そうでない場合、OAuth フローを使用すると Webhook が失敗します。


関数として公開された Webhook は、レガシーのカスタム Webhook ベースの OAuth 2.0 アウトバウンドアプリケーションでは使用できません。トークン Webhook と更新 Webhook を作成する際は、関数としての公開が無効になっていることを確認してください。
新しい REST API ソースの概要ページで、Webhook を作成を選択します。
Webhook に名前(SAP OAuth2 authorization code flow webhook など)を付けます。関数の設定がオフになっていることを確認してください。
リクエスト設定ステップに進みます。
呼び出しで、リクエストの種類として POST を選択し、パスとして sap/bc/sec/oauth2/token を入力します。
クエリパラメーターで、使用するクライアントがデフォルトのクライアントでない場合は、sap-client の設定が必要になることがあります。

redirect_uriclient_idauthorization_code
grant_type → authorization_coderedirect_uri → redirect_uri 入力パラメーターにマッピング(方法は以下を参照)client_id → client_id 入力パラメーターにマッピングcode → authorization_code 入力パラメーターにマッピング

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

SAP OAuth2 refresh flow webhook など)を付けます。関数の設定がオフになっていることを確認してください。sap/bc/sec/oauth2/token)を使用します。sap-client をクエリパラメーターとして設定します。Content-Type → application/x-www-form-urlencoded
client_idrefresh_tokengrant_type → refresh_tokenclient_id → client_id 入力パラメーターにマッピングrefresh_token → refresh_token 入力パラメーターにマッピング

access_tokentoken_typeexpires_inrefresh_tokenscopehttps://<SAP_DOMAIN>/sap/bc/sec/oauth2/authorize
/PALANTIR/SRV_0001 を追加します。