Unified Service Desk クライアントを使用して Dynamics 365 インスタンスへ接続

 

公開日: 2016年11月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

Unified Service Desk クライアントは、Unified Service Desk エンティティと構成データが展開された Microsoft Dynamics 365 インスタンスへの接続に使用できるエージェント アプリケーションです。 クライアント アプリケーションでサインインする際に、Dynamics 365インスタンスのUnified Service Desk構成を読み取り、それに応じて、コントロールおよび機能をアプリケーションに公開します。

このトピックの内容

統合サービス デスクへのサインイン

サインイン情報の構成

サインインの問題のトラブルシューティング

統合サービス デスクへのサインイン

サインイン ダイアログ ボックス内の事前入力値、またはサインイン ダイアログ ボックスを表示しないで自動的にサインインするユーザーなどの、サインインのエクスペリエンスを設定するには、サインイン情報の構成を参照してください。

1. デスクトップ上のアプリケーション ショートカットをダブルクリックすることにより、Unified Service Deskクライアントを開始します。

2. Unified Service Desk のサインイン ダイアログ ボックスで、Dynamics 365 サーバーに接続するための認証の詳細を提供します。

   

   • Microsoft Dynamics 365 (オンライン) の場合、[Office 365] を選択します。

   • 設置型展開では、次の [Authentication Sources] (認証元) から [設置型] を選択します。

     • [Active Directory]。 社内ネットワークを介して Dynamics 365 (設置型) に接続している場合は、この認証元を選択します。インターネットを介して Microsoft Dynamics 365 に接続しないでください。

     • [インターネットに接続する展開 (IFD)]。 インターネットを介して Dynamics 365 (設置型) に接続している場合は、この認証元を選択します。

     • [OAuth]。Windows Server ではなく、OAuth オープン フレームワークをサポートするセキュリティ トークン サービス (STS) を使って Dynamics 365 (設置型) に接続している場合は、この認証元を選択します。

   • 組織が複数あり、Unified Service Desk を展開する組織を選択する場合は、[使用可能な組織の一覧を表示する] チェック ボックスをオンにしてから、[ログイン] をクリックします。

3. 複数の組織がある場合は、接続する組織を選択します。

4. Unified Service Desk スプラッシュ スクリーンが表示されます。 この画面は、バック グラウンドでクライアントによって読み取られる構成データに関する情報を表示します。 次に、メイン ウィンドウが表示され、Dynamics 365サーバーの資格情報を入力するように求められます。 資格情報を入力し、Unified Service Deskクライアント アプリケーションにサインインします。

Unified Service Desk クライアントを開始して再びサインインする必要があるときはいつでも、接続情報を再び提供する必要はありません。 ユーザーの資格情報は安全に Windows Credential Manager に保管され、他の接続情報は c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD にある Default_USD.config ファイルに保管され、次のサインイン活動で使用されます。

サインインの接続情報を変更する場合は、スプラッシュスクリーンの資格情報の変更をクリックします。 初期のサインイン ダイアログ ボックスが表示されるので、そこで別の資格情報を入力することができます。

サインイン情報の構成

必要に応じて、管理者は Unified Service Desk のサインイン エクスペリエンスを構成し、サインイン ダイアログ ボックス (ユーザー名とパスワードを除く) 内に値を事前入力できます。そのため、ユーザーは指定した Dynamics 365 インスタンスに接続したり、サインイン ダイアログ ボックスを表示したりせずに、Active Directory 資格情報に基づいて設置型 Dynamics 365 インスタンスに自動的にサインインするユーザーを設定することができます。

注意

Unified Service Desk サインイン ダイアログ ボックスのフィールドは、追加または削除することができません。 ユーザーがサインインを試みたときにフィールド内に表示される値のみを指定できます。 ただし、ユーザーはサインインする前に、Unified Service Desk サインイン ダイアログ ボックス内に事前入力される値を変更できます。

サインイン情報を構成するには、UnifiedServiceDesk.exe.config ファイルを使用します。このファイルはクライアント インストール ディレクトリ (通常は c:\Program Files\Microsoft Dynamics CRM USD\USD) にあります。

1. メモ帳 を管理者として実行します。

2. メモ帳 で、UnifiedServiceDesk.exe.config ファイルをクライアント インストール ディレクトリ (通常は c:\Program Files\Microsoft Dynamics CRM USD\USD) から開きます。

3. 次のキーを、UnifiedServiceDesk.exe.config ファイルの <appSettings> ノードの下に追加します。

   <add key="CrmDeploymentType" value="<DEPLOYMENT_TYPE>" />
   <add key="CrmUseSSL" value="<VALUE>" />
   <add key="CrmOrg" value="<ORG_NAME>" />
   <add key="CrmPort" value="<PORT_NUMBER>" />
   <add key="CrmServerName" value="<CRM_SERVER_NAME>" />
   <add key="UseDefaultCreds" value="<VALUE>" />
   <add key="CacheCredentials" value="<VALUE>" />
   <add key="CrmOnlineRegion" value="<CRM_ONLINE_REGION>" />
   <add key="AuthHomeRealm" value="<VALUE>" />
   <add key="AskForOrg" value="<VALUE>" />
   <add key="CrmDomain" value="<DOMAIN_NAME>" />
   

4. 各キーに適切な値を指定します。 各キーは、サインイン ダイアログ ボックスの別々のフィールドにマップします。 次の表に、有効なキーの値を示します。

   キー	値
   CrmDeploymentType	Prem または O365 Prem は、Dynamics 365 の設置型または インターネットに接続する展開 (IFD)に接続する場合に使用する必要があります。O365 は、Dynamics 365 (オンライン) に接続する場合に使用する必要があります。
   CrmUseSSL	True または False このキーは、Prem を CrmDeploymentType キーで指定した場合にのみ適用されます。
   CrmOrg	Dynamics 365 組織名を指定する
   CrmPort	Dynamics 365 ポート番号を指定する このキーは、Prem を CrmDeploymentType キーで指定した場合にのみ適用されます。
   CrmServerName	Dynamics 365 サーバー名を指定する このキーは、Prem を CrmDeploymentType キーで指定した場合にのみ適用されます。
   UseDefaultCreds	True または False 注意 設置型 Dynamics 365 のインストール (<add key="CrmDeploymentType" value="Prem" />) および Active Directory 認証 (<add key="AuthHomeRealm" value="Active Directory" />) の場合、サインイン ダイアログ ボックスを表示することなく、指定した Dynamics 365 サーバーまたは組織に直接サインインするユーザーに対し、このキーを True に設定します。
   CacheCredentials	True または False 注意 Unified Service Desk クライアントが起動するたびに接続ダイアログ ボックスを表示するようにするには、このキーの値を False に設定します。 既定では、クライアントは最後の接続情報を取得し、ユーザーがキャンセルして別の接続を指定しない限り、Dynamics 365 サーバーに接続を確立するため、次回それを使用します。
   CrmOnlineRegion	NorthAmerica、EMEA、APAC、SouthAmerica、Oceania、JPN、CAN、IND、または NorthAmerica2 Online 地域を知らない場合、次の値を空のままにします: value="" このキーは、O365 を CrmDeploymentType キーで指定した場合にのみ適用されます。
   AuthHomeRealm	Active Directory、または Internet-facing deployment(IFD)。 このキーは、Prem を CrmDeploymentType キーで指定した場合にのみ適用されます。
   AskForOrg	True または False 使用可能な組織の一覧を表示するチェック ボックスが、サインイン ダイアログ ボックスで選択されているかどうかを示します。
   CrmDomain	Windows ドメインの名前です。 このキーは、Prem を CrmDeploymentType キーで指定した場合にのみ適用されます。

   5. UnifiedServiceDesk.exe.config ファイルを保存します。

   6. サインイン情報を構成したいユーザーの各コンピューター上で、以下の操作を実行します。

      1. 今修正した UnifiedServiceDesk.exe.config ファイルをクライアント インストール ディレクトリ (通常は c:\Program Files\Microsoft Dynamics CRM USD\USD) にコピーして、既存のファイルと置換します。

      2. ユーザーのコンピューター上の移動ユーザー プロファイルから、Unified Service Desk サインイン情報を削除します。 ユーザーが自分のコンピューターから少なくとも 1 度 Unified Service Desk にサインインしている場合、以下のファイルが c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD ディレクトリに作成されます: Default_USD.config および Default_USD。 有効にするために、UnifiedServiceDesk.exe.config 内の構成設定用のこれら両方のファイルを削除する必要があります。

   ユーザーが自分のコンピューター上で Unified Service Desk アプリケーションを開始するとき、以下が実行されます。

   • サインイン ダイアログ ボックスには UnifiedServiceDesk.exe.config ファイルで指定した値が表示され、Default_USD.config ファイルを c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD ディレクトリに作成し、接続情報を保管します (ユーザー名とパスワードを除く。これは Windows Credential Manager に保管されます)。 その後、クライアント アプリケーションは Default_USD.config ファイルを使用して、サインイン情報を表示するか、Unified Service Desk に自動的にサインインします。

   • 設置型 Dynamics 365 を Active Directory 認証でインストールする場合、サインイン ダイアログ ボックスを表示せずにユーザーが自動的にサインインするよう構成済みの場合 (<add key="UseDefaultCreds" value="True" />)、サインイン ダイアログ ボックスは表示されませんが、Default_USD.config ファイルが c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD ディレクトリに作成されて、接続情報を保管します (ユーザー名とパスワード以外)。 その後、クライアント アプリケーションは Default_USD.config ファイルを使用して Unified Service Desk に自動的にサインインします。

   既定のサインイン情報を変更する必要がある場合は、手順 1-6 を繰り返す必要があります。

   サインインの問題のトラブルシューティング

   Unified Service Deskは、Microsoft Dynamics 365にサインインするときに発生するエラーをログ記録するサポートを提供します。 ログ ファイル、Login_ErrorLog.logは、最初にクライアント アプリケーションでサインイン問題が発生したときにc:\Users\<USER_NAME>\AppData\Roaming\Microsoft\UnifiedServiceDesk\*<Version>*に作成されます。 その後、ログ ファイルは、次にサインインに関する問題が発生するときに、その情報を記録するために使用されます。 この情報は、クライアント アプリケーションからMicrosoft Dynamics 365へのサインインに関する問題のトラブルシューティングに役立てることができます。

   注意

   Unified Service Desk はまた、別のログ ファイル、UnifiedServiceDesk.log を、クライアント アプリケーションでの操作のエラーをログ記録するのと同じ場所に、作成します。 ログ ファイルは、最初にクライアント アプリケーションで問題が発生したときに作成されます。詳細:Unified Service Desk でのクライアント診断ログの構成

   関連項目

   統合サービス デスクのセキュリティ
   統合サービス デスクの使用について
   Unified Service Desk の構成チュートリアル
   統合サービス デスクの運営および管理

   Unified Service Desk 2.0

   © 2016 Microsoft. All rights reserved. 著作権