Установка прав ПО (rtRes)#

Утилита rtRes.exe предназначена для установки прав эксплуатации ПО IngortechSCADA.

Предупреждение

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

Список программ поддерживающих этот функционал описан в разделе Ограничение прав.

Типы прав#

Утилита позволяет установить, проверить наличие и удалить права для выполнения следующих операций:

  • Право запуска программы

    Проверяется при запуске программы.

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

  • Право доступа к конфигурированию (настройкам программы)

    Проверяется перед отображением диалога конфигурирования в программах.

    Диалог конфигурирования будет отображен только если проверка доступа не установлена или был введен верный текст доступа.

  • Доступ к завершению программы

    Проверяется перед завершением программы.

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

Алгоритм проверки прав#

  • При выполнении соответствующей операции проверяется наличие информации доступа требуемого для выполнения операции типа. При старте программы - информации доступа к запуску и т.д.

  • В случае если информация доступа не обнаружена, программа продолжит операцию (при старте программы - запуск и т.д.).

  • В случае если информация обнаружена, то выдается диалог запроса подтверждения.

    В этом диалоге пользователь должен ввести текст подтверждения доступа.

  • В случае отмены ввода или неправильного ввода выполняемая операция будет отменена (при старте программы - она не будет запущена, при конфигурировании - диалог настроек не будет отображен, при завершении программы - она продолжит выполнение).

Предупреждение

  1. Все попытки доступа сохраняются в лог файле выполняемой программы с тегом «ACCESS ATTEMPT».

  2. Текст проверки доступа разных типов независим и может быть различным для разных типов доступа для одной и той же программы.

  3. Проверка осуществляется только для тех программ и для тех типов доступа, для которых предварительно установлен текст доступа.

Установка и изменения текста доступа#

Для установки, удаления и изменения текста предназначена утилита rtRes.exe. Это утилита командной строки, которая исполняется в окне консоли с помощью ключей командной строки.

При запуске утилиты без параметров или с ключом «/?», она выведет справочную информацию.

USAGE: rtRes <commands> [<options>] <executable>
 Commands:
   -<S>et=<text>  - set access text
   -<C>check      - check if access text is set
   -<D>el         - delete access text
 Options:
   -<T>ext=<text> - old access text
   -type=<type> - set access text type
 Access text types can be:
   CFG            - configuration acces
   START          - start acces
   CLOSE          - programm termination acces

   USAGE: rtRes <commands> [<options>] <executable>

Команды

-<S>et=<text>

Устанавливает текст доступа

-<C>check

Проверяет факт наличия текста доступа

-<D>el

Удаляет текст доступа

Параметры

-<T>ext=<text>

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

-type=<type>

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

Типы доступа:

  • CFG – Доступ к конфигурированию

  • START – Доступ к запуску

  • CLOSE – Доступ к завершению программы

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

Предупреждение

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

ЗАМЕЧАНИЯ

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

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

    Для этого необходимо добавить к командной строке программы ключ «-text=<text>» и, вместо «<text>» указать старый используемый текст доступа.

  • Если программа содержит текст доступа и он не был указан или указан неверно, то операция выполнена не будет.

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

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

  • Если программа не содержит информации доступа указанного типа, то установить ее можно без указания старой информации.

  • Название типа доступа не может быть сокращено и должно быть указано точно.

ПРИМЕРЫ

  • Начальная установка информации доступа к запуску программы .. code:

    rtRes.exe -s=access_text -type=START rtConfig.exe
    Executable: rtConfig.exe
    Operation with: STARTUP access text
    Access text was set to: access_text
    

    Устанавливает текст «access_text» как текст доступа к запуску программы «rtConfig.exe».

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

    Результат проверки операции будет сохранен в лог файле программы.

    • Неправильный ввод - отказ в запуске.

      Программа: D:\MYWIN\RTS\rtConfig.exe
      Версия: 03-11-2004 19:16:35
      ------------------------------------------
      Получение транспорта...
      ACCESS ATTEMPT: Type: [Проверка доступа к программе], Res: Wrong access text specified: "other text"
      
    • Правильный ввод - программа запущена.

      Программа: D:\MYWIN\RTS\rtConfig.exe
      Версия: 03-11-2004 19:16:35
      ------------------------------------------
      Получение транспорта...
      ACCESS ATTEMPT: Type: [Проверка доступа к программе], Res: Was successfully granted
      
  • Установка текста доступа к конфигурации

    rtRes.exe -s=access_text -type=CFG rtConfig.exe
    Executable: rtConfig.exe
    Operation with: CONFIG access text
    Access text was set to: access_text
    

    Устанавливает текст «access_text» как текст доступа к конфигурированию программы «rtConfig.exe».

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

  • Модификация текста доступа

    rtRes.exe -s=tt -text=access_text -type=CFG rtConfig.exe
    Executable: rtConfig.exe
    Operation with: CONFIG access text
    Access text was set to: tt
    

    Устанавливает текст «tt» вместо уже установленного текста «access_text» как текст доступа к конфигурированию программы «rtConfig.exe».

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

    rtRes.exe -s=tt -type=CFG rtConfig.exe
    Executable: rtConfig.exe
    Operation with: CONFIG access text
    ABORT: You must specify old access text
    StdError: The handle is invalid.
    
  • Попытка установить текст доступа с указанием неверного старого текста.

    rtRes.exe -s=tt -text=access_text -type=CFG rtConfig.exe
    Executable: rtConfig.exe
    Operation with: CONFIG access text
    ABORT: Access to text is denied
    StdError: The handle is invalid.
    
  • Удаление текста доступа.

    Удаление текста конфигурирования.

    rtRes.exe -d -text=tt -type=CFG rtConfig.exe
    Executable: rtConfig.exe
    Operation with: CONFIG access text
    Access text was deleted successfully.
    

    Удаление текста запуска.

    rtRes.exe -d -text=access_text -type=START rtConfig.exe
    Executable: rtConfig.exe
    Operation with: STARTUP access text
    Access text was deleted successfully.