모델 기반 앱에 연결

Unified Service Desk 클라이언트는 Unified Service Desk 엔터티와 구성 데이터를 배포한 Microsoft Dataverse 인스턴스에 연결하는 데 사용할 수 있는 에이전트 응용 프로그램입니다. 클라이언트 응용 프로그램을 통해 로그인할 때 Dataverse 인스턴스에서 Unified Service Desk 구성을 읽고 그에 따라 응용 프로그램에서 컨트롤과 기능을 노출합니다.

Unified Service Desk에 로그인

로그인 대화 상자에 값을 미리 채우거나 로그인 대화 상자를 표시하지 않고 사용자를 자동으로 로그인하는 등 로그인 환경을 구성하려면 로그인 정보 구성으로 이동합니다.

1. 데스크톱에서 응용 프로그램 바로 가기를 두 번 클릭하여 Unified Service Desk 클라이언트를 시작합니다.

2. Unified Service Desk 로그인 대화 상자에서 인증 정보를 제공하여 Dataverse 서버에 연결합니다.

   

   • Dataverse의 경우 Microsoft 365를 선택합니다.

   • Dynamics 365 Customer Engagement (on-premises) 배포의 경우 온프레미스를 선택하고 다음과 같은 인증 소스에서 선택합니다.

     • Active Directory. 네트워크를 통해 내부적으로 Customer Engagement (on-premises)에 연결하고 인터넷을 통해 Dataverse에 연결하지 않았으면 이 인증 소스를 선택합니다.

     • 인터넷 연결 배포(IFD). 인터넷을 통해 Customer Engagement (on-premises)에 연결하려면 이 인증 소스를 선택합니다.

     • OAuth. OAuth 개방형 프레임워크를 지원하는 Windows Server 이외의 보안 토큰 서비스(STS)를 사용하여 Customer Engagement (on-premises)에 연결하려면 이 인증 소스를 선택합니다.

   • 여러 조직이 있고 Unified Service Desk가 배포된 조직을 선택하려는 경우 사용 가능한 조직 목록 표시 확인란을 선택하고 로그인을 선택합니다.

3. 여러 조직이 있는 경우 연결하려는 조직을 선택합니다.

4. Unified Service Desk 시작 화면이 나타납니다. 화면은 백그라운드에서 클라이언트가 읽고 있는 구성 데이터에 대한 정보를 표시합니다. 그런 다음 주 창에 Dataverse 서버 자격 증명을 입력하라는 메시지가 나타납니다. 자격 증명을 입력한 다음 Unified Service Desk 클라이언트 응용 프로그램에 로그인합니다.

   Unified Service Desk 클라이언트를 시작하여 다시 로그인할 때마다 연결 정보를 다시 제공할 필요가 없습니다. 사용자 자격 증명은 Windows 자격 증명 관리자에 저장되고 기타 연결 정보는 C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>의 Default_USD.config 파일에 저장되며 후속 로그인 활동에 사용됩니다.

   로그인하는 연결 정보를 변경하려는 경우 시작 화면에서 자격 증명 변경을 선택합니다. 다른 자격 증명을 입력할 수 있는 초기 로그인 대화 상자가 표시됩니다.

   

로그인 정보 구성

필요하면 관리자는 사용자가 지정된 Dataverse 인스턴스에 연결할 수 있도록 로그인 대화 상자에 값(사용자 이름과 암호 제외)을 미리 채워 Unified Service Desk에 대한 로그인 환경을 구성하거나 자동으로 서명하도록 구성할 수 있습니다. 로그인 대화 상자를 표시하지 않고 사용자의 Active Directory 자격 증명을 기반으로 온프레미스 Dataverse 인스턴스로 사용자를 전환합니다.

로그인 정보를 구성하려면 클라이언트 설치 디렉터리(일반적으로 c:\Program Files\Microsoft Dynamics CRM USD\USD)에서 사용할 수 있는 UnifiedServiceDesk.exe.config 파일을 사용합니다.

1. 관리자로 메모장을 실행하십시오.

2. 메모장에서 클라이언트 설치 디렉터리(일반적으로 C:\Program Files\Microsoft Dynamics CRM USD\USD)에서 UnifiedServiceDesk.exe.config 파일을 엽니다.

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. 각 키에 대해 적절한 값을 제공합니다. 각 키는 로그인 대화 상자의 개별 필드에 매핑됩니다. 다음 표는 올바른 키 값을 보여줍니다.

   Key	값
   CrmDeploymentType	Prem 또는 O365 Customer Engagement (on-premises)에 연결하는 경우 Prem을 사용해야 하며 Dataverse에 연결하는 경우 O365를 사용해야 합니다.
   CrmUseSSL	True 또는 False CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.
   CrmOrg	Dataverse 조직 이름을 지정하십시오.
   CrmPort	Dataverse 포트 번호를 지정하십시오. CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.
   CrmServerName	Dataverse 서버 이름을 지정하십시오. CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.
   UseDefaultCreds	True 또는 False 참고: Customer Engagement (on-premises) 설치(<add key="CrmDeploymentType" value="Prem" />)와 Active Directory 인증(<add key="AuthHomeRealm" value="Active Directory" />)의 경우 이 키 값을 True로 설정하여 로그인 대화 상자를 표시하지 않고 사용자를 지정된 Dataverse 서버나 조직으로 직접 로그인하게 할 수 있습니다.
   CacheCredentials	True 또는 False 참고: Unified Service Desk 클라이언트를 열 때마다 연결 대화 상자가 표시되도록 하려면 이 키의 값을 False로 설정합니다. 기본적으로 클라이언트는 마지막 연결 정보를 캐시하고 다음에 Dataverse 서버에 연결을 설정할 때 이 정보를 사용합니다(사용자가 취소하고 다른 연결을 지정하지 않는 한).
   CrmOnlineRegion	NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND 또는 NorthAmerica2 온라인 지역을 알 수 없는 경우 value="" 값은 비워 둡니다. CrmDeploymentType 키에서 O365을 지정한 경우에만 이 키를 적용할 수 있습니다.
   AuthHomeRealm	Active Directory 또는 Internet-facing deployment(IFD) CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.
   AskForOrg	True 또는 False 로그인 대화 상자에서 사용 가능한 조직 목록 표시 확인란이 선택되었는지를 나타냅니다.
   CrmDomain	Windows 도메인의 이름을 지정하십시오. CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.

5. UnifiedServiceDesk.exe.config 파일을 저장합니다.

6. 로그인 정보를 구성하려는 각 사용자의 컴퓨터에서 다음을 수행합니다.

   1. 기존 파일을 대체하려면 클라이언트 설치 디렉터리(일반적으로 C:\Program Files\Microsoft Dynamics CRM USD\USD)에 방금 수정한 UnifiedServiceDesk.exe.config 파일을 복사합니다.

   2. 사용자 컴퓨터의 로밍 사용자 프로필에서 Unified Service Desk 로그인 정보를 제거합니다. 사용자가 한 번 이상 이 컴퓨터에서 Unified Service Desk에 로그인한 경우 C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk 디렉터리에 Default_USD.config 및 Default_USD 파일이 만들어집니다. 변경 내용을 적용하려면 UnifiedServiceDesk.exe.구성 파일에서 구성 설정에 대한 이러한 두 파일을 모두 삭제해야 합니다.

   사용자가 자신의 컴퓨터에서 Unified Service Desk 응용 프로그램을 시작하는 경우:

   • 로그인 대화 상자는 UnifiedServiceDesk.exe.구성 파일에 지정된 값을 표시하고 C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk 디렉터리에 연결 정보(사용자 이름과 암호는 제외, 이 정보는 Windows 자격 증명 관리자에 저장됨)를 저장할 Default_USD.구성 파일도 만듭니다. 그런 후에 클라이언트 응용 프로그램은 Default_USD.config 파일을 사용하여 로그인 정보를 표시하거나 Unified Service Desk에 자동으로 로그인합니다.

   • Active Directory 인증을 사용한 Customer Engagement (on-premises) 설치 시, 대화 상자를 표시하지 않고 사용자가 자동으로 로그인하도록 구성한 경우(<add key="UseDefaultCreds" value="True" />), 로그인 대화 상자가 표시되지 않지만 C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk 디렉터리에 연결 정보(사용자 이름과 암호는 제외)를 저장할 Default_USD.구성 파일이 만들어집니다. 그런 후에 클라이언트 응용 프로그램은 Default_USD.config 파일을 사용하여 Unified Service Desk에 자동으로 로그인합니다.

기본 로그인 정보를 수정해야 하는 경우 1단계 ~ 6단계를 반복해야 합니다.

로그인 문제 해결

Unified Service Desk는 Dataverse에 로그인하는 동안 발생할 수 있는 오류를 기록하는 로깅 지원을 제공합니다. Login_ErrorLog.log 로그 파일은 클라이언트 응용 프로그램에서 사용자가 처음으로 어떤 문제에 부딪혔을 때 C:\Users\<USER_NAME>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>에 생성됩니다. 그 후로 로그 파일은 향후 로그인 문제에 대한 정보를 기록하는 데 사용됩니다. 이 정보는 클라이언트 응용 프로그램에서 Dataverse에 로그인과 관련한 문제를 해결하는 데 유용할 수 있습니다.

참조 항목

Unified Service Desk의 액세스 관리
Unified Service Desk 사용법 알아보기
Unified Service Desk 구성 연습
관리 개요