次の方法で共有

チュートリアル: CRM プラグイン登録ツールを使用した Azure 対応プラグインの登録

  • [アーティクル]

 

公開日: 2016年11月

対象: Dynamics CRM 2015

このチュートリアルでは、プラグイン登録ツールを使用して、Microsoft Azure Active Directory アクセス制御サービス (ACS) を構成し、サービス エンドポイントの手順を登録する方法について説明します。 構成すると、 Microsoft Dynamics CRM 2015 および Microsoft Dynamics CRM Online は、現在の操作の実行コンテキストを Microsoft Azure ソリューションのエンドポイントに投稿できるようになります。 このチュートリアルでは、このステップを登録して、Account エンティティ向けの CreateRequest メッセージの実行コンテキストを Microsoft Azure サービス バス に投稿します。

このチュートリアルを開始する前に、次の前提条件を満たしておく必要があります。

ステップ

このチュートリアルには次の手順が含まれます。

  1. Microsoft Dynamics CRM Server に接続する

  2. サービス エンドポイント構成の作成

  3. ACS の構成

  4. イベントのサービス エンドポイントの手順を登録する

  5. エンドポイント登録のテスト

Microsoft Dynamics CRM Server に接続する

プラグイン登録ツールを使用して Microsoft Dynamics 365 サーバーに接続するには、次の手順に従います。

  1. Plug-in Registration ツールを実行します。

  2. [新しい接続の作成] を選択します。

  3. [ログイン] ダイアログ ボックスで、サービス エンドポイントを登録する Microsoft Dynamics 365 サーバーに対応する、展開の種類のラジオボタンを選択します。[設置型]ラジオ ボタンには、IFD の展開が含まれます。[オンライン]ボタンはMicrosoft Dynamics CRM OnlineのWindows Liveプロバイダー用です。[Office 365] ボタンは、Microsoft Dynamics CRM OnlineのMicrosoft Online Servicesプロバイダー用です。

    オンライン展開のログイン フォーム

    オンライン展開のログイン フォーム
    設置型展開のログイン ウィンドウ

    設置型展開のログイン フォーム

  4. **[使用可能な組織の一覧を常に表示する]チェックボックスをオンにする場合、[ログイン]**を選択した後、所属している組織の一覧が表示されます。 これにより、サービス エンドポイントを登録する組織を選択することができます。 選択しない場合は、既定の組織が使用されます。

  5. サーバーおよびログインのアカウントに関する指示される情報を入力し、**[ログイン]**を選択します。

サービス エンドポイント構成の作成

Microsoft Azure サービス エンドポイントを登録するには、次の手順に従います。

  1. サービス エンドポイントを登録する組織のタブを選択します。

  2. タブのツールバーで、[登録]、[新しいサービス エンドポイントの登録] を順に選択します。

  3. 次の図とその下の表を参考にして、[サービス エンドポイントの登録] ダイアログ ボックスに、該当のソリューションの関連情報を入力します。 指定する契約は、ソリューションのリスナー アプリケーションによって使用されているものと同じ契約である必要があります。

    サービス エンドポイントの作成

    UI 要素

    description

    名前 (フィールド)

    サービス エンドポイントの登録名です。

    説明 (フィールド)

    このエンドポイント登録の説明です。

    ソリューション名前空間 (フィールド)

    ソリューションのサービス名前空間の名前です。

    パス (フィールド)

    プロジェクトのパスです。 たとえば、サービス エンドポイントの URL が https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo の場合、パスは TwoWayService/Demo になります。

    契約 (ドロップダウン メニュー)

    エンドポイント契約です。 リスナー アプリケーションは、送信されたメッセージの読み取りにこの契約を使用する必要があります。 詳細については、「Microsoft Azure ソリューション用リスナーの記述」を参照してください。

    要求 (ドロップダウン メニュー)

    Microsoft Azure に送信する要求です。 標準の要求には [なし] を使用します。 ログオン ユーザーに関する追加情報を送信するには、[UserId] または [UserInfo] を指定します。

    フェデレーション モード (チェックボックス)

    フェデレーション モードを使用するには、このボックスをオンにします。

    ID (フィールド)

    エンドポイント構成の ID を使用して自動的に入力される、書き込み不可フィールドです。

    ACS の保存と構成 (ボタン)

    入力した構成を保存し、ACS の構成プロセスを自動化します。 トピック「チュートリアル: Microsoft Dynamics CRM 2015 との統合用のMicrosoft Azure ACS の構成」で説明した内容を対話的に実行する手段を提供します。

    認証の保存と検証 (ボタン)

    入力した構成を保存し、ACS が正しく構成されているかどうかを検証します。

    [保存] (ボタン)

    入力した構成を保存し、ダイアログを閉じます。

  4. まだ ACS 統合を Microsoft Dynamics 365 に構成していない場合に、プラグイン登録ツールでその構成を行うには、[ACS の保存と構成] を選択し、このチュートリアルの次のセクションの手順に従います。ACS を既に構成している場合は、[認証の保存と検証] または [保存] を選択して、「イベントのサービス エンドポイントの手順を登録する」の手順を実行します。

ACS の構成

Microsoft Azure Active Directory アクセス制御サービス (ACS) を構成するには、以下の手順に従います。

  1. [ACS の保存と構成] を選択すると、[ACS 構成] ダイアログ ボックスが表示されます。 次の表を参照して、適切なデータ値をフォーム フィールドに入力します。

    フィールド名

    説明

    管理キー

    ソリューションの管理キーです。 このキー値は、Azure 管理ポータル から取得できます。

    サービス バス名前空間の管理キーを取得します

    1. Azure ポータルにサインインします。

    2. 左側のウィンドウで、[サービス バス] を選択し、一覧のターゲット名前空間を選択します。

    3. ページの下部で、[接続情報] を選択します。

    4. [接続情報にアクセスする] ダイアログ ボックスに、[既定のキー] が表示されます。 これは、管理キーです。

    注意

    対称キーを変更した場合は、既定のキーの代わりにそのキーを [管理キー] に入力します。 そうしなかった場合、“ACS50012: 認証に失敗しました” というような説明の付いたエラーが表示されることがあります。

    証明書ファイル

    Microsoft Dynamics 365 との統合を Microsoft Azure に構成するために使用された公開証明書ファイルです。

    Microsoft Dynamics CRM 2015 および Microsoft Dynamics CRM Online 2015 更新プログラム の場合は、サーバーからこの証明書をダウンロードできます。Microsoft Dynamics 365 Web アプリケーションで、[設定] > [カスタマイズ] を選択し、[開発者リソース] を選択します。 下記のリンクのMicrosoft Azure サービス バス発行者証明書を使用して、証明書ファイルをダウンロードして保存します。

    発行者名

    発行者の名前です。 この名前は、Microsoft Dynamics 365 を Microsoft Azure 統合用に構成するために使用されたのと同じ名前である必要があります。 前の説明で述べた [開発者リソース] Web ページから発行者名を取得できます。

    詳細については、「Azure と Microsoft Dynamics CRM 2015 との統合の構成」を参照してください。

  2. ACSの構成を選択します。 フォームの出力領域に、構成プロセスのログが表示されます。

  3. 閉じるを選択します。

  4. [サービス エンドポイントの登録] ダイアログ ボックスで、[認証の保存と検証] を選択します。 検証が完了したら、ダイアログ ボックスを閉じることができます。

イベントのサービス エンドポイントの手順を登録する

サービス エンドポイントのイベントのための手順を登録するには、次の手順に従います。

  1. ツールのツリー ビューで、先の手順で登録したサービス エンドポイントを選択します。

  2. [登録] メニューに移動し、[新しい手順の登録] を選択します。

  3. 次の図のように、[新しい手順の登録] ダイアログ ボックスにアカウント作成イベントの情報を入力します。

    サービス エンドポイントの手順の作成

  4. [新しい手順の登録] を選択します。

これで、Microsoft Dynamics 365 はアカウントが作成されるたびに実行コンテキストを含んだ現在のメッセージをサービス バスに投稿するようになります。 送信は非同期で実行され、すぐには実行されません。

エンドポイント登録のテスト

エンドポイントを登録した後、それをテストできます。 プラグインからのサービス バス送信が実行されるには、ターゲット エンドポイント上でリスナーが実行されているか、またはキューが利用可能になっている必要があります。

  1. サービス エンドポイントを登録したのと同じ組織に対して Microsoft Dynamics 365 Web アプリケーションを開きます。

  2. 作成 ボタンを ボタンの作成 クリックし、取引先企業を選択します。

  3. [取引先企業名] フィールドに取引先企業名 (例: Adventure Works Cycle) を入力し、[保存して閉じる] を選択します。

  4. Microsoft Azure サービス バス 送信が実行されるまで 10 秒ほど待ちます。

  5. [設定] > [システム ジョブ] を選択します。

  6. サービス エンドポイントに対して指定したのと同じ名前のシステム ジョブを開きます。 ステータスをチェックして、送信が成功、待機、失敗のいずれの状態かを確認します。

必要な場合は、エンドポイントの登録を解除できます。解除するには、ツールのツリー ビューでエンドポイントを選択し、[登録を解除] を選択します。

関連項目

Microsoft Dynamics CRM 2015 の Azure 拡張機能
Microsoft Dynamics CRM との Azure 統合
Active Directory およびクレームベース認証

© 2017 Microsoft. All rights reserved. 著作権