Привет! Я — Саша Басун, инженер направления пользовательских ИТ-сервисов в «Петрович-Тех». Сегодня я пришёл к вам с историей о том, как вывод значения ключа из реестра Windows может упростить обработку заявок в отделе технической поддержки.
Если коротко: помощь со стороны нашей техподдержки нередко начиналась с мема «Давайте поможем Даше найти Internet-ID на рабочем столе». Тут нет-нет, да все стадии от гнева до принятия пройти придётся. В итоге после заявки, которая пришла уже мне, родилось маленькое, но изящное решение на C#.
Я вообще люблю проблемы, которые в океане глобальных процессов теряются настолько, что плавают примерно в районе дна Марианской впадины. То со сканером в Kyocera разберусь, то пойму как запускать скрипты в FortiClient, то в Windows любой тип ссылок с любым приложением свяжу. А теперь под руки попалась задача с RMS Host.
Что такое RMS
RMS (Remote Manipulator System) — программа для удалённого администрирования. Проще говоря — аналог TeamViewer, Anydesk и подобных решений. На фоне ассортимента можно долго дискутировать, достаточно ли хорош RMS или нет.
Но меня устраивает. Базовые функции для администрирования у него есть: удалённое управление, просмотр, удалённый запуск командной строки, передача файлов, чат с пользователем.
У RMS есть два популярных клиентских приложения — агент и хост. И в плане интерфейса с агентом проблем нет. Запускаешь, на экране отображается ID и пароль. Сообщаешь данные техподдержке. А вот к хосту есть вопросик. И сразу даже не скажешь: это баг или фича?
В чём проблема?
С точки зрения администрирования RMS Host удобен тем, что после установки на ПК он запускается в виде службы. В отличии от агента тут работает интеграция с Active Directory. Казалось бы, подключайся по IP или имени ПК, и будет тебе счастье. Но бывают случаи, когда подключиться получается только по Internet-ID.
Я уже говорил, что в агенте с этим всё наглядно и понятно. А чтобы вывести на экран Internet-ID в хосте, нужно немножко пострадать.
Для сисадмина или сотрудника техподдержки логика действий понятна: нужно открыть трей, нажать правой кнопкой мыши на иконку хоста, выбрать пункт «Настройка Internet-ID соединения». И вот заветные цифры перед нами. А вот как это выглядит при работе с пользователями.
«Нажмите на стрелочку вверх, она возле часов. В правом нижнем углу (это если у пользователя панель задач по умолчанию снизу). На крышу домика похоже ещё», — в ход идут любые эпитеты.
После того, как мы нашли трей, начинаем искать хост. «У вас там должен быть RMS Host. У него значок голубенький. Или ещё может быть красным или серым. Наведите на иконку, там имя приложения появится», — у хоста цвет иконки зависит от состояния работы. Отлично, хост мы нашли. Просим нажать на него правой кнопкой мыши и выбрать нужный пункт.
Это хороший навык для специалиста: уметь объяснять сложные вещи простыми словами. Но когда в течение месяца у техподдержки несколько тысяч заявок, каждое объяснение в сумме начинает отнимать приличное количество времени.
Поиск решения
На форуме программы я искал решение в надежде, что получить значение Internet-ID можно при помощи какого-нибудь ключа. И в более свежих версиях такой ключ появился — «-printid». Проблема только в том, что для выполнения этой операции требуются права администратора. А в домене, как вы понимаете, у пользователя таких прав нет.
Всё на том же форуме я нашёл более ранний ответ, который гласил, что подобной функции в приложении нет. А сам Internet-ID хранится в реестре в XML формате. Окей, раз он там хранится, давайте его оттуда и вытащим.
Упрощаем жизнь
Параметры RMS Host хранятся в ветке HKEY_LOCAL_MACHINE\SOFTWARE\TektonIT\RMS Host\Host\Parameters, а сам Internet-ID находится в одноименном бинарном ключе.
Никаких препятствий тут особо нет, так как права на чтение разделов и ключей и реестра у пользователя есть. Фактически нам нужно проделать три действия:
Перевести значение ключа в XML формат
Спарсить Internet-ID из тега <internet_id></internet_id>
Вывести полученный результат сотруднику на экран.
Достать значение из ключа реестра можно разными способами, но для удобства пользователей на помощь пришли C# и Windows Forms. Скомпилированное приложение весит крохи, а благодаря NET Framework запускается без сторонних библиотек.
Первым делом в проекте создаём форму, в которую добавляем textbox и присваиваем ей имя. Например, textBoxInternetId. Далее в редакторе формы прописываем следующий код:
Form1.cs
using Microsoft.Win32;
using System;
using System.Text;
using System.Windows.Forms;
using System.Xml;
namespace RMSID
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
private void Form1_Load(object sender, EventArgs e)
{
// Вызываем наш основной метод для чтения данных
GetRMSInternetID();
}
private void GetRMSInternetID()
{
// Ветка реестра, где находятся настройки программы
const string RMSsubKeyPath = @"SOFTWARE\TektonIT\RMS Host\Host\Parameters";
// Ключ, где хранится Internet-ID
const string RMSInternetIDKey = "InternetId";
try
{
// Открываем ветку реестра
using (RegistryKey baseKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry64))
using (RegistryKey key = baseKey.OpenSubKey(RMSsubKeyPath))
{
if (key != null)
{
// Получаем значение ключа
object valueObj = key.GetValue(RMSInternetIDKey);
if (valueObj is byte[] binaryData && binaryData.Length > 0)
{
// Обработка BOM (Byte Order Mark)
byte[] bomUtf8 = { 0xEF, 0xBB, 0xBF };
byte[] dataToDecode = binaryData;
if (binaryData.Length >= 3 &&
binaryData[0] == bomUtf8[0] &&
binaryData[1] == bomUtf8[1] &&
binaryData[2] == bomUtf8[2])
{
dataToDecode = new byte[binaryData.Length - 3];
Array.Copy(binaryData, 3, dataToDecode, 0, dataToDecode.Length);
}
// Декодирование и парсинг XML
string xmlString = Encoding.UTF8.GetString(dataToDecode);
XmlDocument doc = new XmlDocument();
doc.LoadXml(xmlString);
// Извлечение значения <internet_id>
XmlNode internetIdNode = doc.SelectSingleNode("//internet_id");
if (internetIdNode != null)
{
// Отображаем результат в текстовом поле
textBoxInternetId.Text = internetIdNode.InnerText;
}
else
{
// Если вдруг тег <internet_id> не найден
textBoxInternetId.Text = "Элемент <internet_id> не найден.";
}
}
else
{
// если в ветке реестра нет ключа InternetId.
// Можно написать ошибку, но я оставил поле пустым.
textBoxInternetId.Text = $"";
}
}
else
{
textBoxInternetId.Text = $"Ветка реестра '{RMSsubKeyPath}' не найдена.";
}
}
}
catch (Exception ex)
{
textBoxInternetId.Text = $"Ошибка: {ex.Message}";
}
}
}
}
Запускаем, проверяем. И вот результат:
Распространяем программу на рабочие столы, например, через групповую политику. Теперь сотрудников можно просить запустить «ярлык» на рабочем столе. И ничего не нужно искать в трее.
Наслаждаемся результатом
Маленькая утилита позволила облегчить жизнь и пользователям, и сотрудникам техподдержки. На смену вопросам, объяснениям и коммуникационным барьерам пришло маленькое приложение, которое находится на видном месте и запускается по двойному клику мыши.
Очень люблю, когда несколько строчек кода экономят силы, время и нервы. Надеюсь, это решение или похожее на него в скором будущем появится в самом RMS. Если есть замечания или предложения по коду — пишите в комментариях.
Спасибо!