Параметры и пароли

Текстовая информация о конфигурации, которая хранится внутри пускачей, которые созданы пользователем, является большей частью статической (редко изменяемой) и неконфиденциальной (не секретной). Для конфиденциальной информации (которая не должна содержаться в пускачах или в тексте команд, скриптов и плугин) или для очень динамически изменяющейся информации (которая вызывает необходимость редактировать много пускачей и очень часто) имеется специальный механизм, который называется "параметры/пароли":

когда конфигурация пускача должна содержать кусок конфиденциальной информации (например, пароль) рекомендуется хранить эту информацию как Proxy32 пароль. В этом случае пароль будет храниться в отдельном защищенном хранилище вместо того, чтобы его можно было видеть открытым текстом внутри команд, скриптов и PLUGIN.
когда конфигурация пускача содержит информацию, которую пользователь должен изменять перед каждым выполнением пускача (например, имя директории, которая используется в команде, которая распечатывает имена всех файлов в заданной директории) рекомендуется хранить эту информацию как Proxy32 параметр. В этом случае пользователь не должен редактировать пускач перед каждым выполнением, а только вводить новые значения параметра в диалог при каждом выполнении пускача.
Когда некоторый кусок информации, (например, IP адрес сервера, имя пользователя или пароль) используются в большом числе пускачей, то вместо того, чтобы впечатывать эту информацию буквально в каждый пускач рекомендуется держать такую информацию внутри PROXY32 параметра или PROXY32 пароля. В этом случае, если указанный кусок информации должен быть изменен, пользователь дожен редактировать значение одного Proxy32 параметра или пароля, вместо того, чтобы редактировать конфигурацию большого числа пускачей, которые могут использовать этот кусок информации.

В общем, если у Вас есть конфиденциальный, очень динамичный или очень широко повторно используемый кусок информации, который находится в конфигурации пускача, сохраните этот кусок информации, как Proxy32 параметр или пароль.

Proxy32 параметры и пароли появляются в тексте созданных пользователем пускачей, а также в текстовых файлах, на которые ссылаются пускачи SCRIPT/I-SCRIPT. Параметры и пароли появляются как специальные таги (, ), которые помещаются в то место, куда должен вставляться содержащийся в них текст. Пользователь может задать текстовое значение, ассоциированное с каждым именованным тагом (PROXYPARM или PROXYPASSWORD), используя графический редактор параметров в оболочке PROXY32. Пары текстовых строчек (Имя, Значение) для каждого PROXYPARM или PROXYPASSWORD хранятся в памяти параметров Proxy32, а также, если пользователь запросит это, они сохраняются в файл параметров proxy-parms.txt. Когда пользователь запрашивает выполнение пускача, все именованные таги (PROXYPARMs and PROXYPASSWORDs) в конфигурации этого пускача заменяются их значениями перед тем, как пускач выполняется. Если именованный таг не имеет назначенного ему текстового значения, пользователь получит диалог ввода параметров и паролей, чтобы он мог ввсести текстовые значения, которые нужны, чтобы завершить подстановку перед выполнением пускача.

Не существует каких-то отдельных кнопок или опций в меню для того, чтобы создать параметр. Вместо этого параметр создается в тот момент, когда Proxy32 сканирует текст конфигурации уже существующего пускача, чтобы найти в нем именованные таги PROXYPARM или PROXYPASSWORD. Имеется две возможные причины, почему Proxy32 будет искать именованные таги в тексте конфигурации пускача:

пользователь запросил выполнение пускача и Proxy32 должна подставить значения вместо всех именованных тагов для того, чтобы пускач можно было выполнять. Proxy32 выдает пользователю диалог ввода параметров, в котором пользователь может задать значения всех именованных тагов, а затем нажать кнопку OK, чтобы подтвердить подстановку заданных параметров и выполнение пускача;
пользователь явно запросил Proxy32, чтобы он просканировал один пускач, или поддерево пускачей, или все дерево пускачей, собрал все именованные таги, которые содержатся в них, и позволил пользователю задать значения и атрибуты всех этих тагов с помощью специального диалога редактирования параметров.

После того, как пользователь задал и подтвердил значение для именованного тага, он сохраняется в памяти Proxy32 (в так называемом глобальном списке параметров) как пара текстовых строк (имя, значение) и несколько атрибутов, ассоциированных с этой парой. Имеется три атрибута:

указанная пара представляет параметр или пароль. Если это был PROXYPASSWORD таг, пара помечается как пароль, а если это был PROXYPARM, то пара помечается как простой параметр (не пароль). Если пара помечена как пароль, то текст значения отображается точками во всех диалогах, где его можно редактировать. Кроме того, этот текст шифруется, если он сохраняется на диск по заказу пользователя для последующего использования. Существует два механизма шифрования пароля при записи на диск. При простом шифровании текст пароля смешивается с постоянным числом, чтобы его нельзя было читать из файла, но при этом чужой файл паролей может быть загружен в любую версию программы PROXY32 любым пользователем и чужие пароли будут доступны для использования. При более безопасном шифровании все пароли при записи на диск смешиваются со специальным главным паролем, который пользователь задает как ключ для защиты всех остальных паролей. Главный пароль никогда не сохраняется на диске и запрашивается у пользователя только тогда, когда программа Proxy32 должна открыть или сохранить файл с паролями. Другой пользователь не сможет открыть чужой файл с паролями, если он не знает главный пароль, которым этот файл был защищен.
указанная пара должна быть сохранена на диск при закрытии программы Proxy32. Если этот атрибут установлен, то эта пара вместе с ее атрибутами сохраняется в текстовый файл proxy-parms.txt, когда программа Proxy32 закрывается. При старте программы Proxy32 она загружает эти пары вместе с их атрибутами из текстового файла proxy-parms.txt, так что эти пары опять присутствуют в так называемом глобальном списке параметров.
нужно ли просить пользователя модифицировать или подтверждать значение параметра каждый раз, когда он должен подставляться при выполнении пускача. Если пускач содержит много параметров и все эти параметры не помечены как параметры, которые требуют подтверждения при каждом использовании, то при выполнении такого пускача диалог ввода и подтверждения параметров не выдается пользователю, а все параметры подставляются с теми значениями, которые уже хранятся в глобальном списке параметров. Если хотя бы один из параметров, который содержится в конфигурации пускача, помечен как параметр, который требует подтверждения при каждом использовании, то при выполнении такого пускача пользователю выдается диалог ввода параметров, в котором он может подтвердить или модифицировать значения подставляемых параметров перед выполнением пускача.

Когда Proxy32 находит именованные таги в конфигурации пускача или в связанном с ним текстовом файле скрипта, то он проверяет, содержится ли соответствующий (с тем же именем и такого же типа - пароль или простой параметр) параметр в глобальном списке параметров в памяти программы Proxy32. Если он найден в списке, то его значение и атрибуты отображаются в диалоге ввода параметров или в диалоге редактирования параметров, когда эти диалоги выдаются пользователю.

Когда новое дерево пускачей загружается в Proxy32, то пускачи на этом дереве могут содержать большое количество именованных тагов, которые никогда не использовались в этой конкретной инсталляции Proxy32 и поэтому они не присутствуют в глобальном списке параметров в памяти Proxy32. Пользователь может запросить в меню в окне дерева пускачей, чтобы Proxy32 просканировал все дерево пускачей, собрал все именованные таги с этого дерева и показал их в диалоге редактирования параметров для того, чтобы пользователь мог задать их значения и атрибуты. После того, как пользователь задал их значения и атрибуты он может нажать кнопку OK, чтобы или слить список вновь найденных параметров с уже имеющимся глобальным списком параметров в памяти Proxy32 или полностью заменить имеющийся глобальный список параметров на список вновь найденных параметров. Вторая опция называется tidy (почистить), поскольку она удаляет из глобального списка параметров все параметры, которые не содержатся на текущем дереве пускачей, и поэтому они бесполезны. А первая опция называется сканировать и она добавляет новые параметры к глобальному списку параметров в памяти для использования с новым деревом, но она сохраняет и те параметры, которые были до этого в глобальном списке. Опция tidy полезна, когда пользователь заменяет дерево пускачей полностью, так что параметры, которые использовались в старом дереве пускачей больше не нужны и их нет смысла продолжать хранить в глобальном списке в памяти или в файле на диске. Опция сканирования полезна тогда, когда пользователь загружает новое дерево пускачей из файла, но при этом вставляет его как поддерево внутрь дерева пускачей, которое он уже имеет. В этом случае нужно просто добавить к глобальному списку набор новых параметров, которые используются в новом свежезагруженном дереве пускачей.

Кроме того имеется опция EDIT, которая просто загружает содержимое глобального списка параметров из памяти в диалог редактирования параметров, чтобы пользователь мог их редактировать.

Еще имеется опция SEARCH, которая отбирает из глобального списка параметров только те параметры, имя которых содержит заданный образец поиска, а затем загружает отобранные параметры в диалог редактирования параметров, чтобы пользователь мог их редактировать. Первые 4-е опции связаны с редактированием параметров.

А следующие опции связаны с экспортом и импортом параметров в файл или из файла. Кроме того, имеются опции в меню "Параметры", также, как и предыдущие 4-е опции, которые называются scan, tidy, edit, search: - добавить новые параметры из файла к глобальному списку; - обновить из файла значения и атрибуты тех параметров, которые уже существуют в глобальном списке; - добавить новые параметры из файла к глобальному списку и обновить из файла значения и атрибуты тех параметров, которые уже существуют в глобальном списке; - сохранить глобальный список параметров в файл; - сохранить глобальный список параметров в файл, но при этом не шифровать пароли, а сохранять их открытым текстом; - добавить новые параметры из файла к глобальному списку и обновить из файла значения и атрибуты тех параметров, которые уже существуют в глобальном списке, но при этом не пытаться расшифровывать пароли, а загружать их так, как будто в файле они хранятся открытым текстом (эта опция служит для считывания файлов, которые сохранены с помощью предыдущей опции).

В меню Загрузить/Сохранить в окне дерева пускачей имеются следующие три опции:

удалить все параметры из глобального списка, а потом загрузить содержимое списка из выбранного файла параметров;
добавить новые параметры из файла к глобальному списку и обновить из файла значения и атрибуты тех параметров, которые уже существуют в глобальном списке (дупликат просто с другим названием и в другом месте);
сохранить глобальный список параметров в файл (это тоже дупликат опции, приведенной выше).

Оба диалога (и диалог ввода параметров и диалог редактирования параметров) имеют кнопки для экспорта и импорта содержимого диалога в файл или из файла, а также опции включения и выключения шифрования паролей при экспорте и импорте, опция очистки содержимого диалога при загрузке из файла, опция добавления новых параметров при загрузке из файла и опция обновления существующих параметров при загрузке из файла.

Параметры бывают именованные (PROXYPARM И PROXYPASSWORD). Все, что описано выше - это описание именованных параметров.

Кроме этого существуют параметры, которые имеют фиксированное заранее заданное имя в Proxy32 (например, или ) и используются для подстановки в текст конфигурации пускача информации о текущих параметрах инсталляции программы Proxy32, а также о текущих параметрах терминала и о текущих параметрах компьютера. Например, вместо параметра в текст конфигурации пускача подставляется путь к стартовой директории программы Proxy32, а вместо параметра подставляется число колонок во встроенном терминале, который является активным в настоящий момент.

Кроме этого существуют позиционные параметры - . Позиционные параметры могут появляться только в текстовых файлах, на которые ссылаются пускачи скриптов (SCRIPT и I-SCRIPT). Значения позиционных параметров задаются пользователем, когда он создает пускач для скрипта. Использование позиционных параметров со скриптами позволяет использовать один и тот же текстовый файл скрипта с различными параметрами, если пользователь создаст много пускачей, каждый из которых запускает один и тот же скрипт, но подставляет в него разный набор параметров.