macOS DSN の構成

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

macOS の最小バージョン

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

ドライバーのライセンス

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

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

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

Square への接続

LocationId プロパティを設定して、デフォルトのビジネスロケーションを指定します。あるいは、クエリの検索条件にLocationId を設定します。

Id を取得するには、認証後にLocations テーブルをクエリします。

Square への認証

パーソナルアクセストークンを使用してSquare への認証を行うか、OAuth 標準を使用できます。パーソナルトークンを使用して、自分のデータにアクセスしたりサンドボックスを介してテストしたりします。OAuth を使って、他のユーザーが自身のデータにアクセスできるようにします。

パーソナルアクセストークン

OAuthAccessToken 接続プロパティをパーソナルトークンに設定します。これは、以下の手順に従って取得できます。

Developer Dashboard に移動して作成ガイドのOAuth アプリの作成を参照してください。
アプリが作成されると、トークンは［Credentials］タブにリストされます。

Square サンドボックス

Connect API のバージョン2では、サンドボックス環境でのテストが可能です。サンドボックスで作成されたトランザクションは、カードネットワークには送信されず、カードに課金されることはありません。

サンドボックスに接続するには、OAuthAccessToken をサンドボックスのアクセストークンに設定します。これは、標準のパーソナルアクセストークンと一緒に使用できます。

Developer Dashboard に移動して作成ガイドのOAuth アプリの作成を参照してください。
アプリが作成されると、サンドボックストークンは［Credentials］タブにリストされます。

OAuthAccessToken に加えて、Schema を"V2"、UseSandbox を"True" に設定します。

OAuth

OAuth では、認証ユーザーがブラウザを使用してSquare と対話する必要があります。ユーザー資格情報の接続プロパティを設定せずに接続できます。接続すると、本製品はデフォルトブラウザでSquare OAuth エンドポイントを開きます。ログインして、本製品にアクセス許可を与えます。本製品がOAuth プロセスを完了します。

Note：本製品はすでにSquare にOAuth アプリケーションとして登録されており、埋め込みのOAuthClientId およびOAuthClientSecret を自動的に使用して接続します。独自のカスタムOAuth アプリを使用したい場合は、OAuth アプリの作成を参照してこれらの接続プロパティを取得してください。

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

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

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

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