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 구성을 읽고 그에 따라 응용 프로그램에서 컨트롤과 기능을 노출합니다.

이 항목의 내용

Unified Service Desk에 로그인

로그인 정보 구성

로그인 문제 해결

Unified Service Desk에 로그인

로그인 대화 상자에 값이 미리 입력되거나 로그인 대화 상자에 표시하지 않고 사용자가 자동으로 로그인하도록 로그인 환경을 구성하려면 로그인 정보 구성를 참조하십시오.

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

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

    Unified Service Desk 클라이언트 로그인 화면

    • Microsoft Dynamics 365(온라인)에 대해 Office 365를 선택합니다.

    • 온-프레미스 배포의 경우 온-프레미스를 선택하고 다음 인증 소스에서 선택합니다.

      • 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 자격 증명 관리자에 저장되고 기타 연결 정보는 c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD의 Default_USD.config 파일에 저장되며 후속 로그인 활동에 사용됩니다.

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

Unified Service Desk 자격 증명 변경 화면

로그인 정보 구성

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

참고

Unified Service Desk 로그인 대화 상자에 나타나는 필드는 추가 또는 제거할 수 없습니다. 사용자가 로그인하려고 할 때 필드에 나타나는 값만 지정할 수 있습니다. 하지만 사용자는 로그인하기 전에 Unified Service Desk 로그인 대화 상자에서 미리 입력된 값을 변경할 수 있습니다.

로그인 정보를 구성하려면 클라이언트 설치 디렉터리(일반적으로 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. 각 키에 대해 적절한 값을 제공합니다. 로그인 대화 상자에서 개별 필드에 각 키를 매핑합니다. 다음 표는 올바른 키 값을 보여줍니다.

    CrmDeploymentType

    Prem 또는 O365

    온-프레미스 또는 Dynamics 365의 인터넷 연결 배포(IFD)에 연결하는 경우 Prem을 사용해야 하며 Dynamics 365(온라인)에 연결하는 경우 O365를 사용해야 합니다.

    CrmUseSSL

    True 또는 False

    CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.

    CrmOrg

    Dynamics 365 조직 이름 지정

    CrmPort

    Dynamics 365 포트 번호 지정

    CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.

    CrmServerName

    Dynamics 365 서버 이름 지정

    CrmDeploymentType 키에서 Prem을 지정한 경우에만 이 키를 적용할 수 있습니다.

    UseDefaultCreds

    True 또는 False

    참고

    온-프레미스 Dynamics 365 설치 (<add key="CrmDeploymentType" value="Prem" />) 및 Active Directory 인증 (<add key="AuthHomeRealm" value="Active Directory" />)의 경우 이 키의 값을 True로 설정하면 로그인 대화 상자를 표시하지 않고도 사용자는 지정된 Dynamics 365 서버 조직에 직접 로그인할 수 있습니다.

    CacheCredentials

    True 또는 False

    참고

    Unified Service Desk 클라이언트를 시작할 때마다 연결 대화 상자가 표시되도록 하려면 이 키의 값을 False로 설정합니다. 기본적으로 클라이언트는 마지막 연결 정보를 캐시하고 사용자가 취소하고 다른 연결을 지정하지 않는 한 다음에 Dynamics 365 서버에 연결을 설정할 때 이 정보를 사용합니다.

    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을 지정한 경우에만 이 키를 적용할 수 있습니다.

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

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

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

      2. 사용자 컴퓨터의 로밍 사용자 프로필에서 Unified Service Desk 로그인 정보를 제거합니다. 사용자가 한 번 이상 이 컴퓨터에서 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 파일에 지정된 값을 표시하고 c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD 디렉터리에 연결 정보(사용자 이름과 암호는 제외, 이 정보는 Windows 자격 증명 관리자에 저장됨)를 저장할 Default_USD.config 파일도 만듭니다. 그런 후에 클라이언트 응용 프로그램은 Default_USD.config 파일을 사용하여 로그인 정보를 표시하거나 Unified Service Desk에 자동으로 로그인합니다.

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

    Unified Service Desk 2.0

    © 2016 Microsoft. 모든 권리 보유. 저작권 정보