URI(Uniform Resource Identifier)를 사용하여 최종 사용자를 위한 웹 또는 이메일 링크를 생성할 수 있습니다. 최종 사용자는 해당 링크를 클릭하여 HTML Access를 시작하고, 서버에 연결하며, 특정 구성 옵션으로 원격 데스크톱 또는 게시된 애플리케이션을 시작할 수 있습니다.

다음 정보의 일부 또는 전체를 제공하는 URI를 구성하여 이러한 링크를 생성해야 최종 사용자가 정보를 제공할 필요가 없어집니다.

  • 서버 주소
  • 서버의 포트 번호
  • Active Directory 사용자 이름
  • RADIUS 또는 RSA SecurID 사용자 이름(Active Directory 사용자 이름과 다른 경우)
  • 도메인 이름
  • 원격 데스크톱 또는 게시된 애플리케이션 디스플레이 이름
  • 세션 탐색, 재설정, 로그아웃, 시작 등의 작업

URI 사양

필요한 구문에는 서버를 지정하는 경로 부분과 필요한 경우 사용자, 원격 데스크톱 또는 게시된 애플리케이션, 작업 또는 구성 옵션을 지정하는 쿼리가 포함됩니다.

HTML Access를 시작하기 위한 URI를 생성하려면 다음 구문을 사용합니다. 

https://authority-part[/?query-part]
authority-part
서버 주소를 지정하고 필요한 경우 기본값이 아닌 포트 번호를 지정합니다. 서버 이름은 DNS 구문에 따라야 합니다.

포트 번호를 지정하려면 다음 구문을 사용하십시오. 

server-address:port-number
query-part
사용할 구성 옵션이나 수행할 작업을 지정합니다. 쿼리는 대소문자를 구분하지 않습니다. 여러 쿼리를 사용하려면 쿼리 사이에 앰퍼샌드(&)를 사용합니다. 쿼리가 서로 충돌할 경우, 목록의 마지막 쿼리가 사용됩니다. 다음 구문을 사용하십시오. 
query1=value1[&query2=value2...]

쿼리 부분을 생성할 때는 다음 지침을 따라야 합니다.

  • 지원되는 쿼리를 하나 이상 사용하지 않을 경우 기본 VMware Horizon 웹 포털 페이지가 표시됩니다.
  • 쿼리 부분에서는 일부 특수 문자가 지원되지 않으며 해당 문제에 대해 URL 인코딩 형식을 사용해야 합니다. 즉, 파운드 기호(#)에는 %23을, 퍼센트 기호(%)에는 %25를, 앰퍼샌드(&)에는 %26을, at 기호(@)에는 %40을, 백슬래시(\)에는 %5C를 사용해야 합니다.

    URL 인코딩에 대한 자세한 내용은 http://www.w3schools.com/tags/ref_urlencode.asp를 참조하십시오.

  • 쿼리 부분의 비 ASCII 문자는 우선 UTF-8[STD63]에 따라 인코딩되어야 하며 해당 UTF-8 시퀀스의 각 8진수는 URI 문자로 표현되도록 퍼센트로 인코딩되어야 합니다.

    ASCII 문자 인코딩에 대한 자세한 내용은 http://www.utf8-chartable.de/의 URL 인코딩 참조를 참고하십시오.

지원되는 쿼리

이 항목에서는 HTML Access에 지원되는 쿼리를 나열합니다. 여러 유형의 클라이언트(예: 데스크톱 클라이언트 및 모바일 클라이언트)에 사용할 URI를 생성하는 경우 각 유형의 클라이언트 시스템에 관한 가이드 문서를 참조하십시오.

작업
표 1. 작업 쿼리와 함께 사용할 수 있는 값
값 설명
browse 지정된 서버에서 호스트된 사용 가능한 원격 데스크톱 및 게시된 애플리케이션 목록을 표시합니다. 이 작업을 사용하면서 원격 데스크톱 또는 게시된 애플리케이션을 지정할 필요는 없습니다.
start-session 지정된 원격 데스크톱 또는 게시된 애플리케이션을 시작합니다. 작업 쿼리가 제공되지 않고 원격 데스크톱 또는 게시된 애플리케이션 이름이 제공되는 경우, start-session이 기본 작업입니다.
reset 지정된 원격 데스크톱을 종료하고 다시 시작합니다. 저장하지 않은 데이터는 손실됩니다. 원격 데스크톱 재설정은 PC에 있는 재설정 버튼을 누르는 것과 같습니다. 이 작업은 게시된 애플리케이션에 유효하지 않습니다.
logoff 원격 데스크톱의 게스트 운영 체제에서 사용자를 로그아웃시킵니다. 이 작업은 게시된 애플리케이션에 유효하지 않습니다.
restart 사용자가 다시 시작 작업 요청을 확인한 후 기본 원격 데스크톱을 종료하고 다시 시작합니다. 이 작업은 게시된 애플리케이션에 유효하지 않습니다.
applicationId
게시된 애플리케이션 표시 이름입니다. 표시 이름은 애플리케이션 풀이 생성될 때 Horizon Console에서 지정한 이름입니다. 표시 이름에 공백이 포함되어 있으면 브라우저는 %20을 사용하여 공백을 나타냅니다.
args
게시된 애플리케이션이 시작될 때 추가할 명령줄 인수를 지정합니다. 구문 args= 값을 사용합니다. 여기서 값은 문자열입니다. 다음 문자에는 % 인코딩을 사용하십시오.
  • 콜론(:)에는 %3A를 사용합니다.
  • 백슬래시(\)에는 %5C를 사용합니다.
  • 공백( )에는 %20을 사용합니다.
  • 큰따옴표 표시(”)에는 %22를 사용합니다.

예를 들어 Notepad++ 애플리케이션에 대해 파일 이름 "My new file.txt"를 지정하려면 %22My%20new%20file.txt%22를 사용합니다.

desktopId
원격 데스크톱 표시 이름입니다. 표시 이름은 데스크톱 풀이 생성될 때 Horizon Console에서 지정한 이름입니다. 표시 이름에 공백이 포함되어 있으면 브라우저는 %20을 사용하여 공백을 나타냅니다.
domainName
원격 데스크톱 또는 게시된 애플리케이션에 연결 중인 사용자와 연결된 NETBIOS 도메인 이름입니다. 예를 들어 mycompany.com 대신 mycompany를 사용합니다.
tokenUserName
RSA 또는 RADIUS 사용자 이름입니다. RSA 또는 RADIUS 사용자 이름이 Active Directory 사용자 이름과 다른 경우에만 이 쿼리를 사용합니다. 이 쿼리를 지정하지 않고 RSA 또는 RADIUS 인증이 필요한 경우, Windows 사용자 이름을 사용합니다.
userName
원격 데스크톱 또는 게시된 애플리케이션에 연결 중인 Active Directory 사용자입니다. 사용자 이름은 다음 형식 중 하나로 표시할 수 있습니다.
  • userName
  • domainName%5CuserName
  • UPN(사용자 계정 이름) 즉, userName@domainName
unauthenticatedAccessEnabled
이 옵션을 true로 설정하면 인증되지 않은 액세스 기능이 기본적으로 사용되도록 설정됩니다. HTML Access가 시작되고 익명 사용자 계정이 표시됩니다. 구문 예는 unauthenticatedAccessEnabled=true입니다.
unauthenticatedAccessAccount
인증되지 않은 액세스 기능이 사용되도록 설정되면 사용할 계정을 설정합니다. 인증되지 않은 액세스가 비활성화되면 이 쿼리는 무시됩니다. anonymous1 사용자 계정을 사용할 때의 구문 예는 unauthenticatedAccessAccount=anonymous1입니다.
webviewMode
이 옵션을 true로 설정하면 원격 세션이 웹 보기 모드에서 시작합니다. 웹 보기 모드에서는 HTML Access 사이드바가 숨겨집니다. 웹 보기 모드를 사용하면 특정 타사 모바일 애플리케이션에서 다음을 수행할 수도 있습니다.
  • 소프트 키보드에서 원격 데스크톱으로 이벤트 보내기
  • HTML Access에서 모바일 애플리케이션 인터페이스를 사용하여 네이티브 터치 모드와 트랙패드 터치 모드 간을 전환합니다.

URI 구문 예

다음의 각 URI 예에는 최종 사용자가 URI 링크를 클릭할 경우 나타나는 내용에 대한 설명이 이어집니다. 쿼리는 대/소문자를 구분하지 않습니다. 예를 들어 domainName 또는 domainname을 사용할 수 있습니다. 

  1. https://horizon.mycompany.com/?domainName=finance&userName=fred

    HTML Access가 시작되며 horizon.mycompany.com 서버에 연결됩니다. 로그인 상자에서 사용자 이름 텍스트 상자에 fred라는 이름이 채워지고 도메인 텍스트 상자는 finance로 채워집니다. 사용자는 암호만 제공해야 합니다. 

  2. https://horizon.mycompany.com/?userName=finance%5Cfred

    HTML Access가 시작되며 horizon.mycompany.com 서버에 연결됩니다. 로그인 상자에서 사용자 이름 텍스트 상자에 finance\fred라는 이름이 채워집니다. 사용자는 암호만 제공해야 합니다. 

  3. https://horizon.mycompany.com/?userName=fred@finance

    HTML Access가 시작되며 horizon.mycompany.com 서버에 연결됩니다. 로그인 상자에서 사용자 이름 텍스트 상자에 fred@finance라는 이름이 채워집니다. 사용자는 암호만 제공해야 합니다. 

  4. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=start-session

    HTML Access가 시작되며 horizon.mycompany.com 서버에 연결됩니다. 로그인 상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인이 성공적으로 수행되면 클라이언트는 디스플레이 이름이 기본 데스크톱인 원격 데스크톱에 연결되고 사용자는 게스트 운영 체제에 로그인됩니다. 

  5. https://horizon.mycompany.com/?applicationId=Notepad&action=start-session

    HTML Access가 시작되며 horizon.mycompany.com 서버에 연결됩니다. 로그인 상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 성공적으로 로그인한 후에 메모장 애플리케이션이 시작됩니다. 

  6. https://horizon.mycompany.com:7555/?desktopId=Primary%20Desktop

    예를 들어 서버의 기본 포트가 아닌 7555를 사용하는 것을 제외하면 이 URI는 이전 예와 동일한 효과가 있습니다. 기본 포트는 443입니다. 원격 데스크톱 식별자가 제공되므로 start-session 작업이 URI에 포함되지 않아도 원격 데스크톱이 시작됩니다. 

  7. https://horizon.mycompany.com/?applicationId=Primary%20Application&desktopId=Primary%20Desktop

    이 URI는 게시된 애플리케이션 및 원격 데스크톱 둘 다를 지정합니다. 게시된 애플리케이션과 원격 데스크톱을 모두 지정하면 원격 데스크톱만 시작됩니다.

  8. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=reset

    HTML Access가 시작되며 horizon.mycompany.com 서버에 연결됩니다. 로그인 상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인에 성공하면 Primary Desktop(기본 데스크톱)에 대한 재설정 작업을 확인하라는 대화상자가 클라이언트에 표시됩니다.

    참고: 이 작업은 최종 사용자가 시스템을 재설정할 수 있도록 관리자가 허용한 경우에만 사용할 수 있습니다. 
  9. https://horizon.mycompany.com/?My%20Notepad++?args=%22My%20new%20file.txt%22

    서버 horizon.mycompany.com에서 My Notepad++를 열고 애플리케이션 시작 명령에 My new file.txt 인수를 전달합니다. 파일 이름은 공백을 포함하므로 큰따옴표로 묶입니다. 

  10. https://horizon.mycompany.com/?Notepad++%2012?args=a.txt%20b.txt

    서버 horizon.mycompany.com에서 Notepad++ 12를 열고 애플리케이션 시작 명령에 a.text b.txt 인수를 전달합니다. 인수가 큰따옴표로 묶여 있지 않기 때문에 파일 이름이 공백으로 구분되며, Notepad++에서 두 파일이 따로 열립니다.

    참고: 명령줄 인수를 사용하는 방식은 애플리케이션마다 다를 수 있습니다. 예를 들어 워드패드에 인수 a.txt b.txt를 전달하면 워드패드에서 a.txt 파일 하나만 열립니다. 
  11. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=restart

    HTML Access가 시작되며 horizon.mycompany.com 서버에 연결됩니다. 로그인 상자에 사용자에게 사용자 이름, 도메인 이름 및 암호를 묻는 메시지가 표시됩니다. 로그인에 성공하면 Primary Desktop(기본 데스크톱)에 대한 다시 시작 작업을 확인하라는 대화상자가 클라이언트에 표시됩니다.

    참고: 이 작업은 최종 사용자가 시스템을 다시 시작할 수 있도록 관리자가 허용한 경우에만 사용할 수 있습니다. 
  12. https://horizon.mycompany.com/?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous_user1

    HTML Access가 시작되고 anonymous_user1 계정을 사용하여 horizon.mycompany.com 서버에 연결됩니다.

HTML 코드 예

URI를 사용하여 이메일 또는 웹 페이지에 포함할 하이퍼텍스트 링크 및 버튼을 만들 수 있습니다. 다음 예는 첫 번째 URI 예를 사용하여 Test Link라는 하이퍼텍스트 링크와 TestButton이라는 버튼을 코딩하는 방법을 보여줍니다. 

<html>
<body>

<a href="https://horizon.mycompany.com/?domainName=finance&userName=fred">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'https://horizon.mycompany.com/?domainName=finance&userName=fred'"></form> <br>

</body>
</html>