Установка JC-WebClient под Microsoft Windows¶

Типы инсталляторов¶

Дистрибутив JC-WebClient SDK включает в себя либо один инсталлятор – системный, либо два – системный и инсталлятор приложения.

Для первичной установки JC-WebClient необходим запуск системного инсталлятора. Он устанавливает приложение JC-WebClient и выполняет настройку системы (ниже описано подробнее, какие вносятся изменения). Системный инсталлятор требует прав локального администратора, так как вносит изменения в политики безопасности ОС Microsoft Windows.

Инсталлятор приложения устанавливает только само приложение JC-WebClient и не вносит изменений в настройки ОС, поэтому не требует прав локального администратора.

Если дистрибутив содержит оба инсталлятора, это означает, что эта версия JC-WebClient не вносит изменений в настройки системы, а только обновляет само приложение. В этом случае для обновления можно использовать любой из этих инсталляторов. Системный инсталлятор выполнит полное обновление: как самого приложения, так и настроек системы. Инсталлятор приложения обновит только приложение, не затрагивая настроек системы. Поэтому, если наличие прав локального администратора нежелательно, то для обновления можно использовать инсталлятор приложения. Если ограничений на работу с правами администратора в системе нет, то можно использовать системный инсталлятор.

Описание работы системного инсталлятора¶

В процессе установки JC-WebClient системный инсталлятор:

Устанавливает приложение JC-WebClient

В директорию Program Files (x86)\JC-WebClient устанавливается приложение JC-WebClient.

Устанавливает правило брандмауэра, ограничивающее доступ к приложению JC-WebClient

Сетевой доступ к приложению JC-WebClient разрешён только с локального IP-адреса 127.0.0.1 и порта 24738. Тем самым обеспечивается защита от несанкционированного доступа к токену через приложение JC-WebClient из внешней сети.

Устанавливает сертификат УЦ, необходимый для корректной работы приложения

При установке JC-WebClient устанавливается самоподписанный корневой сертификат условного УЦ (выпущен на срок 10 лет). Он помещается в хранилище доверенных корневых центров сертификации локального компьютера.

Браузер Mozilla Firefox использует не системные, а собственные хранилища личных и корневых доверенных сертификатов УЦ. Поэтому самоподписанный сертификат условного УЦ дополнительно помещается в список центров сертификации Mozilla Firefox. Если браузер Mozilla Firefox был установлен уже после установки JC-WebClient, то для поддержки этого браузера потребуется повторный запуск системного инсталлятора.

Устанавливает локальные политики для корректной работы браузера Microsoft Internet Explorer

Производятся следующие изменения в настройках:

• Для зоны “Интернет” включается настройка: Доступ к источникам данных за пределами доменов ( Свойства браузера -> Безопасность -> Интернет -> Другой ).
• Запрещается добавление любого сайта в список режима совместимости (раздел Параметры просмотра в режиме совместимости ).
• Выключается настройка Отображать сайты интрасети в режиме совместимости (раздел Параметры просмотра в режиме совместимости ).

Если пользователем ПК или администратором домена, в котором работает пользователь, для браузера IE установлены политики более высокого уровня (приоритетные), которые противоречат перечисленным выше 3-м политикам, то для корректной работы JC-WebClient следует привести более приоритетные политики в соответствие тем, которые приведены выше.

Если политика безопасности IE для среды, в которой работает пользователь, запрещает включать настройку Доступ к источникам данных за пределами доменов для зоны “Интернет”, то для корректной работы JC-WebClient следует включить эту настройку для зоны “Надёжные сайты” и поместить в эту зону web-порталы, которые работают с JC-WebClient.

Устанавливает сервис мониторинга, запускает его от имени учётной записи system

Сервис мониторинга, выполненный в виде службы ОС, контролирует работу локального web-сервера:

• Запускает локальный web-сервер при загрузке ОС.
• Контролирует целостность локального web-сервера.
• Перезапускает локальный web-сервер в случае нештатных ситуаций/сбоев в ОС.

При установке и регистрации Антифрод-терминала в ОС Co-installer установит в соответствующей ветке реестра флаг EscapeCommandEnable в значение 1. В качестве примера ниже приведена эта ветка реестра для Microsoft Windows 7:

Диагностирует, свободен ли порт 24738

Локальный web-сервер работает на порту 24738. Если порт занят, то будет выведено соответствующее сообщение, а установка отменена.

По нашей оценке, вероятность того, что указанный порт будет занят на клиентском ПК, ничтожно мала. Однако такая проверка была все равно включена в ПО для диагностики возможной проблемы в условиях реальной эксплуатации. Массовая эксплуатация продукта либо подтвердит нашу оценку, либо выявит необходимость поддержки работы по нескольким портам. В случае выявления необходимости работы по нескольким портам ПО JC-WebClient будет доработано.

Описание работы инсталлятора приложения¶

При установке с помощью инсталлятора приложения происходит только установка в директорию Program Files (x86)\JC-WebClient приложения JC-WebClient.exe . Никакие изменения в настройки системы не вносятся.

Порядок установки JC-WebClient на ОС Microsoft Windows¶

Установка JC-WebClient с помощью системного инсталлятора¶

Если установка JC-WebClient происходит на компьютере с ОС Microsoft Windows XP, то следует установить обновление для ОС KB967048. Файл с обновлением находится в каталоге Патчи и исправления для ОС\Updates\XP дистрибутива, либо его можно скачать по следующей ссылке: https://support.microsoft.com/ru-ru/kb/967048.

Если в качестве клиентской ОС используются Microsoft Windows 7 или 8 и в процессе работы возникают проблемы с подсистемой USB-CCID, то следует установить хотфикс KB2800095 – файл для установки находится в каталоге Патчи и исправления для ОС\Hotfix или его можно скачать по ссылке http://support2.microsoft.com/hotfix/KBHotfix.aspx?kbnum=2800095&kbln=en-us.

Далее приводится последовательность действий для установки клиента под ОС Microsoft Windows с использованием системного инсталлятора.

Запустите инсталлятор JC-WebClient-x.x.x.xxx.msi (где x.x.x.xxx — номер релиза). Если появится окно с предупреждением системы безопасности, подтвердите, что хотите запустить это приложение.

В окне приветствия программы установки нажмите Далее.

Примите условия лицензионного соглашения, установив соответствующий флажок, и нажмите Далее.

При необходимости измените конечную папку установки и нажмите Далее.

Нажмите кнопку Установить.

Если был запущен системный инсталлятор, система попросит вас подтвердить установку от имени администратора. Подтвердите свои действия. Установка может занять несколько минут. Дождитесь её завершения.

В последнем окне программы установки с сообщением об её успешном завершении нажмите Готово.

Клиент установлен. С этого момента ваша система должна успешно распознавать электронные ключи при работе с web-приложениями, поддерживающими JC-WebClient.

Обновление JC-WebClient с помощью инсталлятора приложения¶

Далее приводится последовательность действий для обновления клиента под ОС Microsoft Windows с использованием инсталлятора приложения.

Запустите инсталлятор JC-WebClient-Update-x.x.x.xxx (где x.x.x.xxx — номер версии). Если появится окно с предупреждением системы безопасности, подтвердите, что вы хотите запустить это приложение.

Примите условия лицензионного соглашения, установив соответствующий флажок, и нажмите Установить.

В последнем окне программы установки с сообщением об её успешном завершении нажмите Готово.

Установка JC-WebClient в “тихом” режиме¶

Можно выполнить установку JC-WebClient в “тихом” режиме. В этом случае окно установщика не появляется и от пользователя не требуется каких-то действий в процессе установки.

Чтобы установить JC-WebClient в “тихом” режиме следует открыть консоль с правами администратора и выполнить следующую команду:

где x.x.x.xxx — номер версии JC-WebClient.

Консоль обязательно должна быть открыта с правами администратора. Сделать это можно, например, так: воспользовавшись поиском (кнопка Пуск > Найти) по слову cmd , в результатах поиска щелкнуть правой кнопкой мыши на найденную утилиту Командная строка и в контекстном меню выбрать Запуск от имени администратора.

Установка в “тихом” режиме возможна и при обновлении JC-WebClient с помощью инсталлятора приложения. Команда для выполнения в консоли в этом случае следующая (другое название файла установщика):

При установке обновления с помощью инсталлятора приложения консоль можно открывать с правами обычного пользователя, не администратора.

Если необходимо установить JC-WebClient удаленно на множество компьютеров в сети, то рекомендуется делать это через групповые политики – подробное описание см. на сайте Microsoft. В этом случае установка также будет проходить в “тихом” режиме незаметно для пользователей.

Класс WebClient

Если необходимо только запросить файл с определенного URI (Uniform Resource Identifier — унифицированный идентификатор ресурса), то простейшим в использовании классом .NET, который подходит для этого, будет System.Net.WebClient. Этот исключительно высокоуровневый класс предназначен для выполнения базовых операций с помощью всего одной или двух команд. В настоящее время в .NET Framework поддерживаются URI, начинающиеся с идентификаторов http:, https: и file:.

Важно отметить, что термин URL (Uniform Resource Locator — универсальный локатор ресурсов) больше не используется в новых технических спецификациях, а вместо него отдается предпочтение URI. URI имеет приблизительно тот же смысл, что и URL, но немного более общий, потому что в URL не подразумевается обязательное применение одного из знакомых протоколов, таких как HTTP или FTP.

Загрузка файлов

Для загрузки файлов с использованием WebClient доступны два метода. Выбор метода зависит от того, как должно обрабатываться содержимое файла. Если необходимо просто сохранить файл на диске, следует применять метод DownloadFile(). Этот метод принимает два параметра: URI файла и местоположение (путь и имя файла) для сохранения запрошенных данных:

Часто приложение должно обрабатывать данные, извлеченные с веб-сайта. Это обеспечивает метод OpenRead(), возвращающий ссылку на Stream, которую можно использовать для извлечения данных в память:

В следующем примере демонстрируется применение метода WebClient.OpenRead(). Содержимое загруженной страницы будет отображено в элементе управления TextBox. Для начала создайте новый проект как стандартное приложение WPF и добавьте элемент управления TextBox по имени txb. В начало файла к списку директив using потребуется добавить ссылки на пространства имен System.Net и System.IO. Затем добавьте обработчик клика по кнопке:

В этом примере класс StreamReader из пространства имен System.IO подключается к сетевому потоку. Это позволяет получить данные из потока в виде текста, используя высокоуровневые методы вроде ReadLine(). На рис. показаны результаты запуска этого кода:

Класс WebClient также включает в себя метод OpenWrite(). Этот метод возвращает записываемый поток для отправки данных по определенному URI. При этом можно указать метод, который должен использоваться для отправки данных на хост, по умолчанию это POST.

Выгрузка файлов

В классе WebClient также имеются методы UploadFile() и UploadData(). Они используются, когда нужно отправить HTML-форму или выгрузить на сервер целый файл. UploadFile() выгружает файл в указанное местоположение по указанному имени локального файла, в то время как UploadData() выгружает двоичные данные, представленные в виде массива байт, по указанному URI (есть также метод DownloadData(), предназначенный для извлечения массива байтов из URI).

Хотя класс WebClient очень прост в использовании, он обладает весьма ограниченными возможностями. В частности, невозможно передавать регистрационные данные для аутентификации — одна из проблем, связанных с загрузкой данных, состоит в том, что лишь относительно немного сайтов принимают файлы без аутентификации.

Приступая к работе с веб-клиентом Get started with the web client

Веб-клиент удаленного рабочего стола позволяет использовать совместимый веб-браузер для удаленного доступа к ресурсам вашей организации (приложениям и рабочим столам), опубликованным администратором. Вы сможете взаимодействовать с удаленными приложениями и рабочими столами как на локальном компьютере, где бы вы ни находились, без необходимости переключаться на другие ПК. The Remote Desktop web client lets you use a compatible web browser to access your organization’s remote resources (apps and desktops) published to you by your admin. You’ll be able to interact with the remote apps and desktops like you would with a local PC no matter where you are, without having to switch to a different desktop PC. Как только ваш администратор настроит удаленные ресурсы, достаточно будет вашего домена, имени пользователя, пароля и URL-адреса, отправленного вам администратором, а также поддерживаемого веб-браузера, чтобы приступить к работе. Once your admin sets up your remote resources, all you need are your domain, user name, password, the URL your admin sent you, and a supported web browser, and you’re good to go.

Хотите узнать о новых выпусках веб-клиента? Curious about the new releases for the web client? Ознакомьтесь с разделом Что нового в возможностях веб-клиента удаленного рабочего стола? Check out What’s new for Remote Desktop web client?

Что потребуется для использования веб-клиента What you’ll need to use the web client

• Для веб-клиента вам потребуется ПК под управлением Windows, macOS, ChromeOS или Linux. For the web client, you’ll need a PC running Windows, macOS, ChromeOS, or Linux. В настоящее время мобильные устройства не поддерживаются. Mobile devices are not supported at this time.
• Современный браузер, такой как Microsoft Edge, Internet Explorer 11, Google Chrome, Safari или Mozilla Firefox (версии 55.0 или более поздних версий). A modern browser like Microsoft Edge, Internet Explorer 11, Google Chrome, Safari, or Mozilla Firefox (v55.0 and later).
• URL-адрес, который вам отправил администратор. The URL your admin sent you.

Версия веб-клиента для Internet Explorer на данный момент не поддерживает звук. The Internet Explorer version of the web client does not have audio at this time. В Safari может отображаться серый экран, если несколько раз изменить размер окна браузера или переключить полноэкранный режим. Safari may display a gray screen if the browser is resized or enters fullscreen multiple times.

Начало работы с клиентом удаленного рабочего стола Start using the Remote Desktop client

Чтобы войти в клиент, перейдите на URL-адрес, который ваш администратор отправил вам. To sign in to the client, go to the URL your admin sent you. На странице входа введите имя домена и пользователя в формате DOMAIN\username , укажите пароль, а затем выберите Войти. At the sign in page, enter your domain and user name in the format DOMAIN\username , enter your password, and then select Sign in.

Входя в веб-клиент, вы подтверждаете, что компьютер соответствует политике безопасности вашей организации. By signing in to the web client, you agree that your PC complies with your organization’s security policy.

После входа в клиент вы перейдете на вкладку Все ресурсы, которая содержит все опубликованные для вас элементы, упорядоченные в свертываемых группах, например «Рабочие ресурсы». After you sign in, the client will take you to the All Resources tab, which contains all items published to you under one or more collapsible groups, such as the «Work Resources» group. Вы увидите несколько значков, представляющих приложения, рабочие столы или папки, содержащие несколько приложений или рабочих столов, к которым администратор предоставил доступ рабочей группе. You’ll see several icons representing the apps, desktops, or folders containing more apps or desktops that the admin has made available to the work group. Вы сможете вернуться на эту вкладку в любое время, чтобы запустить дополнительные ресурсы. You can come back to this tab at any time to launch additional resources.

Чтобы начать использовать приложение или рабочий стол, выберите элемент, который вы хотите использовать, введите имя пользователя и пароль, используемые для входа в веб-клиент, при появлении соответствующего запроса, а затем выберите Отправить. To start using an app or desktop, select the item you want to use, enter the same user name and password you used to sign in to the web client if prompted, and then select Submit. Возможно, появится диалоговое окно согласия на доступ к локальным ресурсам, таким как буфер обмена и принтер. You might also be shown a consent dialog to access local resources, like clipboard and printer. Вы можете не перенаправлять их или выбрать вариант Разрешить, чтобы использовать параметры по умолчанию. You can choose to not redirect either of these, or select Allow to use the default settings. Дождитесь, когда веб-клиент установит соединение, и затем используйте ресурс обычным образом. Wait for the web client to establish the connection, and then start using the resource as you would normally.

Когда вы закончите, можно завершить сеанс, выбрав кнопку Выход на панели инструментов в верхней части экрана или закрыв окно браузера. When you’re finished, you can end your session by either selecting the Sign Out button in the toolbar at the top of your screen or closing the browser window.

Сочетания клавиш для веб-клиента Web client keyboard shortcuts

В следующей таблице описаны альтернативные сочетания клавиш для использования стандартных сочетаний клавиш Windows в удаленном сеансе. The following table describes alternate key combinations to inject standard Windows shortcut keys in the remote session.

Сочетание клавиш Shortcut key	Описание Description
(Windows) CTRL+ALT+END (Windows) Ctrl+Alt+End (MacOS) FN+CTRL+OPTION+DELETE (MacOS) fn+control+option+delete	Внедряет CTRL+ALT+DEL в удаленном сеансе. Inject Ctrl+Alt+Del in the remote session.
ALT+F3 Alt+F3	Внедряет клавишу Windows в удаленном сеансе. Injects Windows key in the remote session.

Печать из веб-клиента удаленного рабочего стола Printing from the Remote Desktop web client

Выполните следующие действия, чтобы распечатать что-либо из веб-клиента. Follow these steps to print from the web client:

1. Начните процесс печати обычным образом для приложения, из которого что-то нужно распечатать. Start the printing process as you would normally for the app you want to print from.
2. Когда будет предложено выбрать принтер, выберите Виртуальный принтер удаленного рабочего стола. When prompted to choose a printer, select Remote Desktop Virtual Printer.
3. Выбрав параметры, нажмите кнопку Печать. After choosing your preferences, select Print.
4. В браузере будет создан PDF-файл задания печати. Your browser will generate a PDF file of your print job.
5. Вы можете открыть PDF-файл и напечатать его содержимое на локальном принтере или сохранить его на компьютере для последующего использования. You can choose to either open the PDF and print its contents to your local printer or save it to your PC for later use.

Копирование и вставка из веб-клиента удаленного рабочего стола Copy and paste from the Remote Desktop web client

Веб-клиент в настоящее время поддерживает копирование и вставку только для текста. The web client currently supports copying and pasting text only. Файлы невозможно копировать или вставлять через веб-клиент. Files can’t be copied or pasted to and from the web client. Кроме того, можно использовать только CTRL+C и CTRL+V для копирования и вставки текста. Additionally, you can only use Ctrl+C and Ctrl+V to copy and paste text.

Использование редактора методов ввода (IME) в удаленном сеансе Use an Input Method Editor (IME) in the remote session

Выполните следующие действия, чтобы использовать редактор метода ввода для ввода сложных символов в удаленном сеансе: Follow these steps to use an Input Method Editor to enter complex characters in the remote session:

1. Щелкните значок шестеренки на панели навигации, чтобы открыть боковую панель Параметры. Select the gear icon in the navigation bar to open the Settings side panel.
2. Установите для переключателя Включить редактор метода ввода в значение Вкл. Set the Enable Input Method Editor switch to On.
3. Выберите предпочитаемую раскладку клавиатуры IME в раскрывающемся меню. Select your preferred IME keyboard layout in the dropdown menu.

В удаленном сеансе должен быть установлен и включен редактор метода ввода. You must have an Input Method Editor installed and enabled in the remote session.

Помощь в работе с веб-клиентом Get help with the web client

Если у вас возникла проблема, которую не удается устранить, используя сведения из этой статьи, вы можете получить помощь по работе с веб-клиентом, написав на адрес, указанный на странице отзывов веб-клиента. If you’ve encountered an issue that can’t be solved by the information in this article, you can get help with the web client by raising feedback on the web client’s Feedback page.