接続の確立

接続プロファイルの設定

［CData］リボンから［データの取得］をクリックし、［取得元：SAP Gateway］> 設定済みの接続を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいSAP Gateway 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。

SAP Gateway への接続

SAP Gateway は、データに接続する3つの方法を提供します。

デスクトップ経由で自分のローカルデータに接続する場合（非ブラウザ接続、以下「Basic 認証」と呼ぶ）は、CData が提供する組み込みOAuth アプリケーションを使用します。
ネットワーク経由で共有データに接続する場合（ブラウザ接続）は、カスタムOAuth アプリケーションを使用します。

SAP Gateway のテーブルにアクセスするには、次の接続プロパティを設定します。

URL：お使いの環境のURL、またはサービスの完全URL。例えば、完全URL は次のようになります：https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/。この例では、環境URL は次のようになります：https://sapes5.sapdevcenter.com。CustomURLParams プロパティを使用して、追加プロパティを追加します。
Namespace：適切なService Namespace。先ほどの例では、IWBEP が名前空間です。サービスへの完全URL が指定されている場合は任意です。
Service：データを取得するサービス。上記のURL プロパティの例では、サービスはGWSAMPLE_BASIC です。完全URL が指定されている場合は必須ではありません。
CustomURLParams：HTTP リクエストに含まれる必要のある追加プロパティ；例えば sap-client=001&sap-language=EN。

SAP Gateway への認証

SAP Gateway は、Basic 認証、OAuth、OAuth PKCE、API キー、SAP BTP Destination 認証など、複数の認証方法をサポートしています。ユーザー名とパスワードで接続する場合はBasic 認証を、ブラウザベースの認可フローで認証する場合はOAuth またはOAuth PKCE を、API キーを使用して接続する場合はAPI キー認証を、設定済みのSAP BTP Destination Service から資格情報を自動的に取得する場合はSAP Business Technology Platform（BTP）Destination 認証を使用します。

Basic

Basic 認証を有効にするには、以下のプロパティを設定します。

AuthScheme：Basic。
User：SAP Gateway へのログインに使用するユーザー名。
Password：SAP Gateway へのログインに使用するパスワード。

上記のプロパティを設定したら、接続の準備は完了です。ローカルデータにアクセスするには、個人の認証情報を使用します。

OAuth

以下のサブセクションでは、デスクトップアプリケーション、Web、またはヘッドレスマシンから認証する方法を詳しく説明します。カスタムOAuth アプリケーションの作成については、カスタムOAuth アプリケーションの作成を参照してください。

デスクトップアプリケーション

カスタムOAuth アプリケーションの資格情報を使用して認証するには、OAuth アクセストークンを取得し、更新する必要があります。これらを設定すると、接続の準備が整います。

OAuth アクセストークンの取得およびリフレッシュ

OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId。
OAuthClientSecret：アプリケーションの登録時に割り当てられたクライアントシークレット。
CallbackURL：アプリケーションの登録時に定義されたリダイレクトURI。

接続すると、本製品はデフォルトブラウザでSAP Gateway のOAuth エンドポイントを開きます。

ログインして、アプリケーションにアクセス許可を与えます。アクセストークンの期限が切れたときは、本製品はアクセストークンを自動でリフレッシュします。

OAuth PKCE

標準OAuth 2.0 フローの拡張機能であるProof Key for Code Exchange（PKCE）を使用してOAuth 認証を行うことができます。これは、クライアントシークレットを安全に保存できないクライアント向けに設計されています。PKCE にはカスタムOAuth アプリケーションが必要です。作成方法については、カスタムOAuth アプリケーションの作成を参照してください。

以下の接続プロパティを設定します。

AuthScheme = OAuthPKCE。OAuth PKCE フローを使用して認証する場合に設定します。
InitiateOAuth：GETANDREFRESH。この設定により、OAuth 認可フローが実行され、必要に応じてアクセストークンが自動的にリフレッシュされるため、手動でOAuth 交換を完了したりOAuthAccessToken を設定したりする必要がなくなります。
OAuthClientId = カスタムOAuth アプリケーションの登録時に割り当てられたクライアントId。
OAuthClientSecret = カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。このプロパティは任意です。クライアントシークレットを安全に保存できる機密クライアントは設定する必要がありますが、パブリッククライアントは通常使用しません。

PKCE 認証フローにはPKCE verifier が必要です。以下の手順に従ってこの値を取得します。

GetOAuthAuthorizationURL ストアドプロシージャを実行します。このプロシージャは、応答の中でPKCE verifier を返します。
認証を完了する前に、返された値をPKCEVerifier 接続プロパティに設定します。

API キー

API キーを使用して接続するには、以下のプロパティを設定します。

AuthScheme：Token。
APIKey：自身のアカウントに関連付けられたAPI キー。

API キーを取得するには、Developer Portal を開き、API を公開したProduct またはService を選択します。 Subscribe > Create a new Application をクリックし、必要な情報を入力してアプリケーションを作成します。アプリケーションキーが表示されます。この値をAPIKey 接続プロパティにコピーします。

SAP BTP Destination

SAP BTP Destination Service を使用して認証するには、SAP BTP Destination から認証の詳細を自動的に取得するように本製品を構成します。この方法は、トークンの管理を内部で処理することで認証を簡素化します。

SAP BTP Destination Service 経由の認証を有効にするには、次の接続プロパティを設定します：

AuthScheme：SAPBTP。
InitiateOAuth：GETANDREFRESH。
OAuthClientId：SAP BTP Destination Service に関連付けられたクライアントID。Destination Service インスタンスのサービスキーのclientid フィールドにあります。
OAuthClientSecret：SAP BTP Destination Service に関連付けられたクライアントシークレット。Destination Service インスタンスのサービスキーのclientsecret フィールドにあります。
OAuthAccessTokenURL：Destination のアクセストークンを取得するために使用されるSAP BTP OAuth トークンのエンドポイントのURL。Destination Service インスタンスのサービスキーのurl フィールドにあります。
DestinationName：接続するサービスの資格情報を保持するように設定されたSAP BTP Destination の名前。
DestinationURL：SAP BTP Destination Service API の URL。Destination Service インスタンスのサービスキーのuri フィールドにあります。

以上のプロパティを設定すると、本製品は認証フローを自動的に処理します。トークンや認証の詳細を手動で管理する必要がないため、このAuthScheme は特にヘッドレスマシンにとって役立ちます。

SAP Gateway Destination の作成方法について、詳しくはSAP Gateway Destination の作成を参照してください。

接続プロパティ

最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。

接続の管理

SAP Gateway への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理を参照してください。

Excel Add-In for SAP Gateway