Привет! Я — Саша Басун, инженер направления пользовательских ИТ-сервисов в «Петрович-Тех». Сегодня я пришёл к вам с историей о том, как вывод значения ключа из реестра 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 находится в одноименном бинарном ключе.

Никаких препятствий тут особо нет, так как права на чтение разделов и ключей и реестра у пользователя есть. Фактически нам нужно проделать три действия:

  1. Перевести значение ключа в XML формат

  2. Спарсить Internet-ID из тега <internet_id></internet_id>

  3. Вывести полученный результат сотруднику на экран.

Достать значение из ключа реестра можно разными способами, но для удобства пользователей на помощь пришли 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. Если есть замечания или предложения по коду — пишите в комментариях. 

Спасибо!