АдминистрированиеИнформационнаяБаза.СтрокаПараметровВнешнегоУправленияСеансами

Свойства · ExternalSessionManagementConnectionString

Тип: Строка. Свойство предназначено для внешнего управления сеансами. В качестве значения используется строка параметров веб сервиса внешнего управления сеансами в формате: <Имя параметра>=<Значение> через символ ';' (точка с запятой). Если <Значение> содержит пробелы или символы ';', то строку значения параметра следует заключать в кавычки ("). При этом каждый из символов кавычки ("), присутствующий в строке <Значение>, должен быть экранирован (""). Параметры: - wsdl – URL-адрес для получения wsdl веб-сервиса; - ns – пространство имен веб-сервиса; - srvc – имя веб-сервиса; - port – имя порта веб-сервиса. Например: wsdl=http://server/034983/ws/esc.1cws?wsdl;ns=http://www.sessioncontrol.org;srvc=ExternalSessionControl;port=ExternalSessionControlSoap.

Полное описание, параметры и ограничения

АдминистрированиеИнформационнаяБаза.СтрокаПараметровВнешнегоУправленияСеансами (AdministrationInfoBase.ExternalSessionManagementConnectionString)

АдминистрированиеИнформационнаяБаза (AdministrationInfoBase)

СтрокаПараметровВнешнегоУправленияСеансами (ExternalSessionManagementConnectionString)

Доступен, начиная с версии 8.3.14.

Использование:
Чтение и запись.
Описание:
Тип: Строка.
Свойство предназначено для внешнего управления сеансами.
В качестве значения используется строка параметров веб сервиса внешнего управления сеансами в формате:
<Имя параметра>=<Значение> через символ ';' (точка с запятой).
Если <Значение> содержит пробелы или символы ';', то строку значения параметра следует заключать в кавычки ("). При этом каждый из символов кавычки ("), присутствующий в строке <Значение>, должен быть экранирован ("").
Параметры:
- wsdl – URL-адрес для получения wsdl веб-сервиса;

- ns – пространство имен веб-сервиса;

- srvc – имя веб-сервиса;

- port – имя порта веб-сервиса.
Например:
wsdl=http://server/034983/ws/esc.1cws?wsdl;ns=http://www.sessioncontrol.org;srvc=ExternalSessionControl;port=ExternalSessionControlSoap.
Доступность:

Тонкий клиент, сервер, толстый клиент, интеграция.

Использование в версии:

Доступен, начиная с версии 8.3.14.

Методическая информация

Практические примеры

Проверить ссылки на два профиля и обязательное внешнее управление

Разбираем противоположный смысл пустых обычного и безопасного профилей, ищем зарегистрированные имена и читаем настройки управления сеансами без обращения к веб-сервису.

Где и как запускать

Полный модуль собственной управляемой формы. Только чтение явно выбранной УчебнаяБаза85 в УчебныйКластер85 через loopback ras; запуск в 1С и соединение здесь не выполнялись.

Подготовка

  1. Нужен отдельный собственный серверный стенд 1С 8.5.1.1343 без рабочих баз. Администратор должен заранее установить сервер, запустить совместимый ras и создать кластер с точным именем УчебныйКластер85. Код ничего не устанавливает и не регистрирует.

  2. Запускайте обработку в собственной пустой учебной конфигурации с именем метаданных УчебнаяКонфигурацияСинтаксиса. Серверное выполнение должно находиться на той же машине, что собственный ras: код разрешает только 127.0.0.1. Это адрес сервера выполнения, не обязательно компьютера тонкого клиента.

  3. ПортRAS возьмите из фактического запуска своего ras, не из порта ragent или рабочего процесса. Например, 1545 подходит только если именно этот порт настроен на вашем стенде. Используйте законные учётные данные своего агента и своего кластера; пустые допустимы только для намеренно настроенного учебного стенда без соответствующих администраторов.

  4. В первый раз оставьте ИдентификаторКластера пустым: появится JSON только с кластерами УчебныйКластер85. Скопируйте настоящий UUID из результата, вновь введите очищенные пароли и повторите команду. Кластер выбирается одновременно по UUID и точному учебному имени; чужой кластер не принимается.

  5. Выполняйте каждый урок отдельно. JSON формируется в памяти и показывается только на своей форме; код не сохраняет файлы, не пишет настройки кластера, не прерывает сеансы и не запускает команды ОС. Он выполняет сетевое обращение к своему локальному ras только если вы сами запустите его на подготовленном стенде.

  6. Здесь подключение к ras и запуск в 1С не выполнялись. Проверены тексты, сигнатуры и привязки к локальной справке 8.5.1.1343. Пройдите контрольные действия сами только на своём учебном стенде.

  7. Штатными средствами заранее зарегистрируйте в своём УчебныйКластер85 только собственную УчебнаяБаза85 с этой учебной конфигурацией. Код не создаёт базу, СУБД, пользователя, профиль или разрешение.

  8. В управляемой форме обработки создайте ПортRAS — Число без дробной части; ИмяАгента, ПарольАгента, ИдентификаторКластера, ИмяАдминистратораКластера, ПарольАдминистратораКластера, ИдентификаторУчебнойБазы, ИмяАдминистратораБазы, ПарольАдминистратораБазы, JSONРезультат — Строка. У JSONРезультат длина 0.

  9. Выведите реквизиты на форму. Для всех трёх полей паролей включите Режим пароля, не сохраняйте их в истории и настройках; JSONРезультат — многострочное поле просмотра. Создайте команду ПолучитьУчебныйСнимок и вставьте весь приведённый модуль формы.

  10. Первый запуск с пустым UUID кластера возвращает только каталог УчебныйКластер85. Второй с настоящим UUID кластера и пустым UUID базы — только каталог УчебнаяБаза85. Третий — с обоими подтверждёнными UUID и законными учётными данными пользователя-администратора своей базы.

  11. Учётные данные агента, администратора кластера и пользователя информационной базы — три разные пары. Не подставляйте имя кластера вместо логина. После каждого результата или ошибки все три пароля очищаются, для повторного запроса введите их заново.

  12. Списки разрешений, роли и модули проверяются только как настройки. COM, внешние приложения, файлы, криптография и внешние веб-сервисы в примерах не запускаются. Снимок в памяти не проверяет фактический доступ или отказ.

&НаКлиенте
Процедура ПолучитьУчебныйСнимок(Команда)
    Попытка
        JSONРезультат = УчебныйСнимокНаСервере(ПортRAS, ИмяАгента, ПарольАгента,
            ИдентификаторКластера, ИмяАдминистратораКластера, ПарольАдминистратораКластера,
    ИдентификаторУчебнойБазы, ИмяАдминистратораБазы, ПарольАдминистратораБазы);
    Исключение
        JSONРезультат = "Снимок не получен. Проверьте собственный стенд, порт, UUID кластера и базы, учебные имена и права администраторов. Подробную серверную ошибку исследуйте в отладчике без публикации учётных данных.";
    КонецПопытки;
    ПарольАгента = "";
    ПарольАдминистратораКластера = "";
    ПарольАдминистратораБазы = "";
КонецПроцедуры

&НаСервереБезКонтекста
Функция УчебныйСнимокНаСервере(ПортRAS, ИмяАгента, ПарольАгента,
    ИдентификаторКластера, ИмяАдминистратораКластера, ПарольАдминистратораКластера,
    ИдентификаторУчебнойБазы, ИмяАдминистратораБазы, ПарольАдминистратораБазы)
    Если ТипЗнч(ПортRAS) <> Тип("Число") Тогда
        ВызватьИсключение "Порт ras должен быть числом";
    КонецЕсли;
    Если ПортRAS <> Цел(ПортRAS) Или ПортRAS < 1 Или ПортRAS > 65535 Тогда
        ВызватьИсключение "Недопустимый порт собственного ras";
    КонецЕсли;
    ТекстовыеПараметры = Новый Массив;
    ТекстовыеПараметры.Добавить(ИмяАгента);
    ТекстовыеПараметры.Добавить(ПарольАгента);
    ТекстовыеПараметры.Добавить(ИдентификаторКластера);
    ТекстовыеПараметры.Добавить(ИмяАдминистратораКластера);
    ТекстовыеПараметры.Добавить(ПарольАдминистратораКластера);
    ТекстовыеПараметры.Добавить(ИдентификаторУчебнойБазы);
    ТекстовыеПараметры.Добавить(ИмяАдминистратораБазы);
    ТекстовыеПараметры.Добавить(ПарольАдминистратораБазы);
    Для Каждого ТекстовыйПараметр Из ТекстовыеПараметры Цикл
        Если ТипЗнч(ТекстовыйПараметр) <> Тип("Строка") Тогда
            ВызватьИсключение "Учётные данные и UUID должны быть строками";
        КонецЕсли;
    КонецЦикла;
    Агент = Новый АдминистрированиеСервера("127.0.0.1", ПортRAS);
    Агент.ВыполнитьАутентификацию(ПарольАгента, ИмяАгента);
    Кластеры = Агент.ПолучитьКластеры();
    Если ПустаяСтрока(СокрЛП(ИдентификаторКластера)) Тогда
        Каталог = Новый Массив;
        Для Каждого Найденный Из Кластеры Цикл
            Если Найденный.Имя = "УчебныйКластер85" Тогда
                СтрокаКаталога = Новый Структура;
                СтрокаКаталога.Вставить("UUID", Строка(Найденный.ИдентификаторКластера));
                СтрокаКаталога.Вставить("Имя", Найденный.Имя);
                Каталог.Добавить(СтрокаКаталога);
            КонецЕсли;
        КонецЦикла;
        Возврат СериализоватьСвойСнимок(Новый Структура("УчебныеКластеры", Каталог));
    КонецЕсли;
    Кластер = Неопределено;
    Совпадений = 0;
    Для Каждого Найденный Из Кластеры Цикл
        Если НРег(Строка(Найденный.ИдентификаторКластера)) = НРег(СокрЛП(ИдентификаторКластера))
            И Найденный.Имя = "УчебныйКластер85" Тогда
            Кластер = Найденный;
            Совпадений = Совпадений + 1;
        КонецЕсли;
    КонецЦикла;
    Если Совпадений <> 1 Тогда
        ВызватьИсключение "Нужен один собственный учебный кластер с подтверждённым UUID";
    КонецЕсли;
    Кластер.ВыполнитьАутентификацию(ИмяАдминистратораКластера, ПарольАдминистратораКластера);
    Снимок = Новый Структура;
    Снимок.Вставить("UUIDКластера", Строка(Кластер.ИдентификаторКластера));
    Снимок.Вставить("ИмяКластера", Кластер.Имя);
    Базы = Кластер.ПолучитьИнформационныеБазы();
    Если ПустаяСтрока(СокрЛП(ИдентификаторУчебнойБазы)) Тогда
        КаталогБаз = Новый Массив;
        Для Каждого КандидатБазы Из Базы Цикл
            Если ТипЗнч(КандидатБазы) <> Тип("АдминистрированиеИнформационнаяБаза") Тогда
                ВызватьИсключение "Ожидалось описание информационной базы";
            КонецЕсли;
            Если КандидатБазы.Имя = "УчебнаяБаза85" Тогда
                ЗаписьКаталога = Новый Структура;
                ЗаписьКаталога.Вставить("UUID", Строка(КандидатБазы.ИдентификаторИнформационнойБазы));
                ЗаписьКаталога.Вставить("Имя", КандидатБазы.Имя);
                КаталогБаз.Добавить(ЗаписьКаталога);
            КонецЕсли;
        КонецЦикла;
        Снимок.Вставить("УчебныеБазы", КаталогБаз);
        Возврат СериализоватьСвойСнимок(Снимок);
    КонецЕсли;
    База = Неопределено;
    СовпаденийБазы = 0;
    Для Каждого КандидатБазы Из Базы Цикл
        Если ТипЗнч(КандидатБазы) <> Тип("АдминистрированиеИнформационнаяБаза") Тогда
            ВызватьИсключение "Ожидалось описание информационной базы";
        КонецЕсли;
        Если КандидатБазы.Имя = "УчебнаяБаза85"
            И НРег(Строка(КандидатБазы.ИдентификаторИнформационнойБазы)) = НРег(СокрЛП(ИдентификаторУчебнойБазы)) Тогда
            База = КандидатБазы;
            СовпаденийБазы = СовпаденийБазы + 1;
        КонецЕсли;
    КонецЦикла;
    Если СовпаденийБазы <> 1 Тогда
        ВызватьИсключение "Нужна одна собственная УчебнаяБаза85 с подтверждённым UUID";
    КонецЕсли;
    База.ВыполнитьАутентификацию(ИмяАдминистратораБазы, ПарольАдминистратораБазы);
    Снимок.Вставить("UUIDБазы", Строка(База.ИдентификаторИнформационнойБазы));
    Снимок.Вставить("ИмяБазы", База.Имя);
    Основной = База.ПрофильБезопасности;
    Безопасный = База.ПрофильБезопасностиБезопасногоРежима;
    Снимок.Вставить("ОбычныйПрофиль", Основной);
    Снимок.Вставить("ПрофильБезопасногоРежима", Безопасный);
    Профили = Кластер.ПолучитьПрофилиБезопасности();
    Если ПустаяСтрока(Основной) Тогда
        Снимок.Вставить("ОбычныйРежим", "Профиль не указан: полные права на внешнюю активность по справке");
    Иначе
        Снимок.Вставить("СовпаденийОбычногоПрофиля", ЧислоПрофилейСИменем(Профили, Основной));
    КонецЕсли;
    Если ПустаяСтрока(Безопасный) Тогда
        Снимок.Вставить("БезопасныйРежим", "Профиль не указан: полный запрет внешней активности в безопасном режиме по справке");
    Иначе
        Снимок.Вставить("СовпаденийБезопасногоПрофиля", ЧислоПрофилейСИменем(Профили, Безопасный));
    КонецЕсли;
    ЕстьПараметры = Не ПустаяСтрока(База.СтрокаПараметровВнешнегоУправленияСеансами);
    Снимок.Вставить("ОбязательноВнешнееУправление", База.ОбязательноеИспользованиеВнешнегоУправленияСеансами);
    Снимок.Вставить("СтрокаПараметровЕсть", ЕстьПараметры);
    Если База.ОбязательноеИспользованиеВнешнегоУправленияСеансами Тогда
        Снимок.Вставить("ПриНедоступностиСервиса", "По справке начало сеанса не выполняется; доступность сервиса этим кодом не проверяется");
    Иначе
        Снимок.Вставить("ПриНедоступностиСервиса", "По справке начало сеанса выполняется; это не отменяет другие причины отказа");
    КонецЕсли;
    Если База.ОбязательноеИспользованиеВнешнегоУправленияСеансами И Не ЕстьПараметры Тогда
        Снимок.Вставить("НужнаПроверкаНастроек", "Обязательность включена, строка параметров пуста; проверьте свой стенд штатными средствами");
    КонецЕсли;
    Возврат СериализоватьСвойСнимок(Снимок);
КонецФункции

&НаСервереБезКонтекста
Функция СериализоватьСвойСнимок(Снимок)
    Писатель = Новый ЗаписьJSON;
    Писатель.УстановитьСтроку();
    ЗаписатьJSON(Писатель, Снимок);
    Возврат Писатель.Закрыть();
КонецФункции
&НаСервереБезКонтекста
Функция ЧислоПрофилейСИменем(Профили, ИмяПрофиля)
    Совпадений = 0;
    Для Каждого ЗаписьПрофиля Из Профили Цикл
        Если ТипЗнч(ЗаписьПрофиля) <> Тип("АдминистрированиеПрофильБезопасности") Тогда
            ВызватьИсключение "Ожидалось описание профиля безопасности";
        КонецЕсли;
        Если ЗаписьПрофиля.Имя = ИмяПрофиля Тогда
            Совпадений = Совпадений + 1;
        КонецЕсли;
    КонецЦикла;
    Возврат Совпадений;
КонецФункции

Разбор по шагам

  1. До подключения проверяется имя учебной конфигурации, целочисленный диапазон порта и строковые типы всех восьми текстовых аргументов.

  2. Сначала выбирается кластер по имени и UUID, затем база по своему отдельному имени и UUID. Пустой UUID даёт учебный каталог, не выбор первого элемента.

  3. Аутентификация агента и кластера не подменяет пользователя базы. После точного выбора выполняется отдельная аутентификация в собственной базе.

  4. Результат строится из простых значений, массивов и структур. UUID и даты представлены текстом; пароли и сырые серверные ошибки в JSON не попадают.

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

  6. Для непустого имени считаем совпадения среди фактических профилей кластера. Имя в свойстве базы само по себе не доказывает существование профиля.

  7. Счётчик совпадений показывает 0, 1 или больше; не выбирает первый объект. Он не проверяет фактическое применение профиля к коду.

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

  9. СтрокаПараметровВнешнегоУправленияСеансами может содержать URL и параметры. Выводится только её непустота; строка не разбивается по каждому разделителю и WSDL не загружается.

Как проверить результат

  1. В результате должны быть именно подтверждённые UUID и имена своего учебного кластера и базы, а не первый зарегистрированный объект.

  2. Неверный UUID, чужое имя, неверный тип аргумента или порт вне диапазона должны дать безопасное сообщение; ни одна команда изменения кластера или базы не вызывается.

  3. После любого исхода три поля паролей пустые. Проверяйте только на отдельном собственном стенде: запуск в 1С здесь не выполнялся.

  4. Сверьте имена со штатными настройками. Для каждого непустого назначенного имени ожидается одно совпадение, а 0 требует проверки регистрации.

  5. Для уже пустых двух назначений тексты должны отличаться: обычный режим — полная внешняя активность, безопасный — полный запрет.

  6. Если обязательность включена при пустой строке параметров, появляется предупреждение. Результат не содержит URL, учётных данных веб-сервиса или доказательства его доступности.

Ожидаемый результат

Показана асимметрия двух профилей и влияние обязательности управления сеансами, без изменения назначений или вызова сервиса.

На что обратить внимание

  1. 127.0.0.1 относится к машине серверного исполнения формы, не обязательно к ПК тонкого клиента. Не заменяйте адрес рабочим сервером.

  2. Имена — защитные учебные маркеры, UUID — подтверждённые идентификаторы. Код не устанавливает ras, не выбирает первого кандидата и не регистрирует недостающие объекты.

  3. Чтение настроек не является проверкой доступа, работоспособности СУБД, выполнения задания или отсутствия других способов получения лицензии.

  4. Ни Записать, ни Удалить, ни прекращение сеанса, ни создание ресурса не вызываются. Изменения для самостоятельных сравнений допускаются только штатными средствами собственного учебного стенда.

  5. Статическая сверка и успешная сборка справочника не означают реальное подключение: тексты примеров в 1С не запускались.

  6. Пустое имя профиля и несуществующее непустое имя — разные случаи. Наличие профиля не доказывает правильность разрешений или готовность безопасного режима.

  7. Значения параметров сервиса могут содержать точки с запятой и кавычки. Простое СтрРазделить по каждому разделителю не является корректным парсером этой строки.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.