Linux DSN の構成

このセクションでは、以下のいくつかのLinux ディストリビューションでODBC 接続をセットアップしDSN を設定する方法を説明します：Ubuntu のようなDebian ベースのシステム、Red Hat Enterprise Linux (RHEL)、CentOS、およびFedora のようなRed Hat Linux プラットフォーム。

Linux の最小バージョン

Red Hat ベースおよびDebian ベースシステムでサポートされる最小バージョンは以下のとおりです。


OS	Min. Version
Ubuntu	11.04
Debian	7
RHEL	6.9
CentOS	6.9
Fedora	13
SUSE	12.1

ドライバー依存関係のインストール

必要な依存関係をインストールするには、次のコマンドをルートとしてまたはsudo で実行します。

Debian/Ubuntu:

apt-get install libc6 libstdc++6 zlib1g libgcc1

RHEL/CentOS/Fedora:
```
yum install glibc libstdc++ zlib libgcc
```

本製品が必要とする対応ライブラリは以下のとおりです。


Debian/Ubuntu Package	RHEL/CentOS/Fedora Package	File
libc6	glibc	linux-vdso.1
libc6	glibc	libm.so.6
libc6	glibc	librt.so.1
libc6	glibc	libdl.so.2
libc6	glibc	libpthread.so.0
libc6	glibc	libc.so.6
libc6	glibc	ld-linux-x86-64.so.2
libstdc++6	libstdc++	libstdc++.so.6
zlib1g	zlib	libz.so.1
libgcc1	libgcc	libgcc_s.so.1

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

標準のパッケージ管理システムを使用してドライバーをインストールできます。

Ubuntu のようなDebian ベースのシステムでは、次のコマンドをroot またはsudo で実行します。

dpkg -i /path/to/driver/setup/DynamicsCRMODBCDriverforUnix.deb

RPM パッケージ形式をサポートするシステムでは、次のコマンドをroot またはsudo で実行します。

rpm -ivh /path/to/driver/DynamicsCRMODBCDriverforUnix.rpm

ドライバーのライセンス

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

cd /opt/cdata/cdata-odbc-driver-for-dynamicscrm/bin/
sudo ./install-license.sh <key>

ドライバーマネージャー経由の接続

ドライバーマネージャーはドライバーをロードし、アプリケーションからドライバーに関数呼び出しを渡します。本製品をドライバーマネージャーに登録して、ドライバーマネージャーのコンフィギュレーションファイルにDSN を定義する必要があります。

本製品のインストールでは、本製品をunixODBC ドライバーマネージャーに登録し、システムDSN を作成します。UnixODBC ドライバーマネージャーは、Python やその他多くのアプリケーションから使用できます。アプリケーションに別のドライバーマネージャーが組み込まれている可能性があります。

DSN の作成

unixODBC をインストールしてDSN を設定するには、unixODBC の使用を参照してください。OBIEE、Informatica、およびSAS に接続するDSN を作成するには、DataDirect ドライバーマネージャーの使用を参照してください。

Microsoft Dynamics CRM への接続

接続するには、Url に組織のルートURL を設定し、User、Password、およびCRMVersion を設定します。

オンプレミスCRM への認証

オンプレミスCRM の場合、追加で認証メソッドを選択します。デフォルトで、本製品は、Windows（NTLM）認証を使います。Kerberos delegation などの他の認証タイプを使うには、AuthScheme を設定します。次は接続文字列の例です。

AuthScheme=Auto;Url=https://myOrg.crm.dynamics.com/;User=username;Password=password;CRM Version='CRM2011+'"

Internet Facing Deployments

IFD を使用するDynamics CRM では、InternetFacingDeployment をtrue に設定します。次は接続文字列の例です。

AuthScheme=Auto;Url=https://myOrg.crm.dynamics.com/;User=username;Password=password;InternetFacingDeployment=True;CRM Version='CRM2011+'"

AzureAD

Microsoft Dynamics CRM はAzureAD をサポートしています。AzureAD を使用して認証するには、カスタムアプリを作成してOAuthClientId、OAuthClientSecret を取得し、カスタムのAzureAD 資格情報を使用する必要があります。これらのプロパティに加えて、CallbackURL を設定します。

OAuth 認証スキームを強制するためには、AuthScheme をOAuth に設定します。

OAuth アプリケーション作成後、次の接続プロパティを設定します。

AuthScheme：OAuth に設定。
OAuthClientId：アプリケーション設定のコンシューマーキーに設定。
OAuthClientSecret（オプション）：アプリケーション設定のコンシューマーシークレットに設定。
ADFSServer：デプロイメントのADFS に設定。

接続すると、本製品はデフォルトブラウザでAzureAD エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。本製品が以下のAzureAD プロセスを完了します。

コールバックURL でアクセストークンおよびADFSServer を設定し、認証リクエストを行います。
接続設定にOAuth 値を保存します。これらの値は接続間で永続化されます。
返されたリフレッシュトークンと有効なアクセストークンとを交換します。

次はInternet Facing Deployments 用の接続文字列の例です。

AuthScheme=OAuth;Url=https://myOrg.crm.dynamics.com/;CRM Version=CRM2011+;InitiateOAuth=GETANDREFRESH;CallbackUrl=http://localhost:33333;OAuthClientId=ClientID;ADFSServer=https://auth.adfs.com/;"

次はオンライン環境用の接続文字列の例です。

AuthScheme=OAuth;Url=https://myOrg.crm.dynamics.com/;CRM Version=CRMOnline;InitiateOAuth=GETANDREFRESH;CallbackUrl=http://localhost:33333;OAuthClientId=ClientID;AzureTenant=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;"

Kerberos

Kerberos で認証する方法についての詳細は、Kerberos の使用を参照してください。

OAuth 値のリフレッシュ

本製品は、ブラウザベースのOAuth 認証交換中に取得されたテンポラリーOAuth アクセストークンをリフレッシュできます。デフォルトでは、本製品は暗号化されたトークンを、DSN に対応するodbc.ini ファイルに保存します。System DSN の場合、このodbc.ini ファイルへのアクセスを制限できます。

トークンの自動交換を有効にするには、本製品にシステムodbc.ini への書き込みアクセス権を与えます。

OAuth 認証の依存関係のインストール

OAuth 認証標準は、認証するユーザーにWeb ブラウザを使用したMicrosoft Dynamics CRM との通信を要求します。最初のOAuth インタラクションがドライバーがインストールされている同じマシン上で行われる場合（例えばデスクトップアプリケーションの場合）、本製品はデフォルトブラウザを立ち上げるxdg-open プログラムにアクセスする必要があります。

この依存関係を満たすには、パッケージマネージャーに対応するパッケージをインストールします。


Debian/Ubuntu Package	RHEL/CentOS/Fedora Package	File
xdg-utils	xdg-utils	xdg-open

ドライバーエンコーディングの設定

ODBC ドライバーは、ODBC ドライバーマネージャーで使用するエンコーディングを指定する必要があります。デフォルトでは、Unix 用のCData ODBC ドライバーはunixODBC と互換性のあるUTF-16 を使用するように設定されていますが、他のドライバーマネージャーでは代替エンコーディングが必要な場合があります。

また、ANSI ODBC API を使用するアプリケーションからODBC ドライバーを使用している場合は、ANSI コードページを設定する必要があります。例えば、ANSI アプリケーションに日本語の文字をインポートするには、設定ファイル'/opt/cdata/cdata-odbc-driver-for-dynamicscrm/lib/cdata.odbc.dynamicscrm.ini' でコードページを指定できます。

[Driver]
AnsiCodePage = 932

ODBC Driver for Microsoft Dynamics CRM