ODBC Driver for eBay Analytics

Build 24.0.9062

macOS DSN の構成

このセクションでは、macOS でODBC 接続をセットアップしDSN を設定する方法を示します：

macOS の最小バージョン

CData ODBC Driver for eBay Analytics 本製品 にはmacOS Sierra (10.12) 以上が必要です。

ドライバーのライセンス

端末で次のコマンドを実行して、本製品 のライセンスを取得します。評価版をアクティベートするには、<key> の入力を省略してください。 

cd "/Applications/CData ODBC Driver for eBay Analytics/bin"
sudo ./install-license.sh <key>

名前とパスワードを入力するよう求められます。これらは、あなたの名前とマシンのパスワードを指します。

eBay Analytics への接続

eBay Analytics への接続を確立し、OAuth 2.0認証方法でのみ認証することができます。eBay Analytics API では、リクエストの認可に、認証コード付与フローで作成されたアクセストークンが必要です。

eBay Analytics への認証

eBay Analytics はOAuth 認証のみをサポートします。AuthScheme は、すべてのOAuth フローでOAuth に設定する必要があります。

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

デスクトップアプリケーション経由で認証するには、カスタムOAuth アプリケーションの作成が必要です。詳しくは、カスタムOAuth アプリの作成 を参照してください。

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

以下を設定して、接続してください。

  • OAuthClientId：アプリケーションの登録時に割り当てられたApp Id（クライアントId）に設定。
  • OAuthClientSecret：アプリケーションの登録時に割り当てられたCert Id（クライアントシークレット）に設定。
  • RuName：'Application access' セクションのOAuth アプリケーションのリダイレクトURL名に設定。
  • CallbackURL（オプション）：OAuth アプリケーションの認証済みURL がhttps://oauth.cdata.com/oauth/ に設定されている場合はローカルのリダイレクトURL（例：http://localhost:33333）に設定し、他のリダイレクトURL を使用している場合は実際のURL に設定。
  • （オプション）UseSandbox：Sandbox 環境に接続している場合は、これをTrue に設定。
接続すると、本製品 はデフォルトブラウザでeBay Analytics のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

ヘッドレスマシン

ヘッドレスマシンのユーザーアカウントでOAuth を使用するようにドライバーを設定するには、インターネットブラウザに対応した別の端末で認証する必要があります。

  1. 以下のオプションから選択します。
    • オプション1：後述の「Verifier code を取得および交換」に従い、OAuthVerifier 値を取得します。
    • オプション2：インターネットブラウザに対応したマシンに本製品 をインストールし、後述の「OAuth 設定を転送」の説明に従い、通常のブラウザベースのフローで認証後にOAuth 認証値を転送します。
  2. 次に、ヘッドレスマシンからアクセストークンを自動的にリフレッシュするように本製品 を設定します。

オプション1：Verifier code を取得および交換

Verifier code を取得するには、OAuth Authorization URL で認証する必要があります。

インターネットブラウザに対応したマシンから認証してOAuthVerifier 接続プロパティを取得する方法は次のとおりです。

  1. 次のプロパティを設定します。
    • InitiateOAuth：OFF に設定。
    • OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId に設定。
    • OAuthClientSecret：アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
    • RuName：'Application access' セクションのOAuth アプリケーションのリダイレクトURL 名に設定。
    次に、適切なCallbackURL を指定してGetOAuthAuthorizationURL ストアドプロシージャを呼び出します。ストアドプロシージャによって返されたURL をブラウザで開きます。
  2. ログインして、本製品 にアクセス許可を与えます。すると、リダイレクトURI にリダイレクトされます。リダイレクトURI にはcode というパラメータが付加されます。このパラメータの値を控えておきます。後ほどこれをOAuthVerifier 接続プロパティに設定します。
次に、OAuth verifier code をOAuth リフレッシュトークンおよびアクセストークンと交換する必要があります。

ヘッドレスマシンでは、次の接続プロパティを設定してOAuth 認証値を取得します。

  • InitiateOAuth：REFRESH に設定。
  • OAuthClientId：キーセットのApp ID (Client ID) に設定します。
  • OAuthClientSecret：キーセットのCert ID (Client Secret) に設定します。
  • RuName：'Application access' セクションのOAuth アプリケーションのリダイレクトURL 名に設定。
  • OAuthVerifier：verifier code に設定。
  • OAuthSettingsLocation：暗号化されたOAuth 認証値を指定された場所に永続化。

接続をテストしてOAuth 設定ファイルを生成し、以下のプロパティを再設定して接続します。

  • InitiateOAuth：REFRESH に設定。
  • OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId に設定。
  • OAuthClientSecret：アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
  • OAuthSettingsLocation：暗号化されたOAuth 認証値を含む場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所が本製品 に読み書きのアクセス許可を与えることを確認してください。

オプション2：OAuth 設定を転送

ヘッドレスマシンでの接続に先立ち、インターネットブラウザに対応したデバイスでドライバーとの接続をインストールし、作成する必要があります。

  1. インターネットブラウザのあるマシンに本製品 をインストールし、次の接続プロパティを設定した後に接続します。
    • OAuthSettingsLocation：書き込み可能な場所に設定。
    • OAuthClientId：キーセットのApp ID (Client ID) に設定します。
    • OAuthClientSecret：キーセットのCert ID (Client Secret) に設定します。
    • RuName：'Application access' セクションのOAuth アプリケーションのリダイレクトURL 名に設定。
    • （オプション）CallbackURL：OAuth アプリケーションの認証済みURL がhttps://oauth.cdata.com/oauth/ に設定されている場合はローカルのリダイレクトURL（例：http://localhost:33333）に設定し、他のリダイレクトURL を使用している場合は実際のURL に設定。
  2. 認証する接続をテストします。生成された認証値は、OAuthSettingsLocation で指定された場所に暗号化されて書き込まれます。接続テストに成功したら、OAuth 設定ファイルをヘッドレスマシンにコピーします。ヘッドレスマシンで、次の接続プロパティを設定し、データに接続します。
    • InitiateOAuth：REFRESH に設定。
    • OAuthSettingsLocation：OAuth 設定ファイルの場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所が本製品 に読み書きのアクセス許可を与えることを確認してください。

ドライバーのアンインストール

ドライバーをアンインストールする最も簡単な方法は、ターミナルを開いて、インストールディレクトリにあるuninstall.sh スクリプトを実行します。次に例を示します。 

cd "/Applications/CData ODBC Driver for eBay Analytics"
sudo ./uninstall.sh

Note：このスクリプトはインストールディレクトリから実行される必要があります。

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9062