Матчингом приложения называется процесс определения целевого приложения ESSO Агентом.

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

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

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

СИНТАКСИС

<matchingDetails>
   <components>
      <component type=”тип компонента” componentId=”ID компонента”>
         <componentWeb>
            <url isRegex=”флаг регулярного выражения”>URL страницы</url>
         </componentWeb>
      </component>
      <component type=”тип компонента” componentId=”ID компонента”>
         <componentWin32>
            <paths>
               <path>путь к файлу 1</path>
               …
               <path>путь к файлу N</path>
            </paths>
            <crcs>
               <crc fileSizeBytes=”размер файла 1 в байтах”>CRC файла 1</crc>
               …
               <crc fileSizeBytes=”размер файла N в байтах” >CRC файла N</crc>
            </crcs>
            <fileDescription>Описание исполняемого файла </fileDescription>
         </componentWin32>
      </component>
   </components>
</matchingDetails>

ПАРАМЕТРЫ

<matchingDetails>
Структура описывает параметры матчинга приложения.

<components>
Структура описывает компоненты приложения.

Некоторые приложения имеют несколько представлений пользовательского интерфейса - как правило, это представления в виде Win32- и Web-приложений (например, веб-службы электронной почты). Представление пользовательского интерфейса в терминологии Indeed-Id называется компонентом приложения.

Компоненты приложения можно реадактировать в ESSO Консоли (создавать и удалять компоненты через ESSO Консоль нельзя).

<component>
Структура описывает компонент приложения.

Атрибуты
type
Тип компонента приложения приложения.

Представление в виде Win32-приложения называется Win32-компонентом приложения. Представление в виде Web-приложения называется Web-компонентом приложения.

Возможные значения:

CFormData::mtWin32   Win32-компонент приложения
CFormData::mtWeb      Web-компонент приложения

componentId
Идентификатор компонента приложения.

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

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

<formData id="{74034A01-12DA-424F-B081-BB88F8010BE0}" filledWndMarkDeletionTime="fwmdtOnFillingFinished">
   <matching matchingType="CFormData::mtWin32">
      <matchingWin32 className="#32770" [b]componentId="&lt;Win32Component&gt;"[/b]>
      ...
      </matchingWin32>
   </matching>
   …
</formData> 

Идентификатор может содержать специальные символы, для задания которых используются сущности, определенные в формате XML, а именно:

Символ    Сущность
        <           &lt;
        >           &gt;
        &           &amp;
        "            &quot;
        '            &apos;

Пример:
<component type="CFormData::mtWeb" componentId="&lt;Web Component&gt;">... </component>

Приведенное описание определяет компонент с имененем <Web Component>.

Идентификатор компонента отображается в ESSO Консоли в настройках приложения.

<componentWeb>
Структура описывает Web-компонент приложения.

<url>
URL страницы Web-приложения.

Задает адрес, по которому будет выполняться матчинг Web-приложения.

Значение может быть задано в виде текста или регулярного выражения (определяется флагом isRegex).

Атрибуты
isRegex
Флаг представления URL страницы в виде регулярного выражения.

Возможные значения:
0 - URL определяется текстом;
1 - URL определяется регулярным выражением.

<componentWin32>
Структура описывает Win32-компонент приложения.

<paths>
Структура задает пути исполняемых файлов компонентов приложения.

Матчинг компонентов приложения выполняется по заданным путям.

Параметр опциональный. Значение по умолчанию: пусто (нет путей).

<path>
Путь исполняемого файла компонента приложения для матчинга.

<crcs>
Структура задает контрольные суммы исполняемых файлов компонентов приложения.

Значения структуры представлены парами <CRC, размер файла>.

Параметр опциональный. Значение по умолчанию: пусто (нет пар <CRC, размер файла>).

<crc>
Контрольная сумма исполняемого файла компонента приложения. Получить значение контрольной суммы для файла можно с помощью утилиты IndeedID.App.Info.exe (поставляется в составе дистрибутива Indeed-Id).

Атрибуты
fileSizeBytes
Размер исполняемого файла компонента приложения.

Получить размер файла можно с помощью утилиты IndeedID.App.Info.exe (поставляется в составе дистрибутива Indeed-Id).

<fileDescription>
Описание исполняемого файла, указанное в его свойствах (в Version Info).

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

Описание параметров матчинга Win32- и Web-компонентов приложения:

<matchingDetails>
   <components>

      <component type="CFormData::mtWin32" componentId="&lt;Win32Component&gt;">
         <componentWin32>
            <paths>
               <path>%ProgramFiles%\Indeed-Id\Enterprise SSO\IndeedID.SSO.Test.App.exe</path>
               <path>C:\IndeedID.SSO.Test.App.exe</path>
            </paths>
            <crcs>
               <crc fileSizeBytes="270848">4135804682</crc>
            </crcs>
            <fileDescription>Indeed-ID SSO test application</fileDescription>
         </componentWin32>
      </component>

      <component type="CFormData::mtWeb" componentId="WebComponent">
         <componentWeb>
            <url isRegex="1">(.*)\\IndeedID\.SSO\.web\.Test\.App\\(.*)\.htm.*</url>
         </componentWeb>
      </component>

   </components>
</matchingDetails>

Описание форм входа для Win32- и Web-компонентов приложения (описания форм разблокировки и смены пароля аналогичны):

<opLogon failureReaction="frRematchTargetForm" rematchAttemptsLimit="2">
   <forms>
      <formData id="{BC52204D-6573-418A-ABE3-2200910AC97B}" filledWndMarkDeletionTime="fwmdtOnFillingFinished">
         <matching matchingType="CFormData::mtWin32">
            <matchingWin32 className="#32770" componentId="&lt;Win32Component&gt;">
            ...
            </matchingWin32>
         </matching>
      </formData>

      <formData id="{C3EBEB43-3561-4DD6-8A15-0E5F7E26756A}" filledWndMarkDeletionTime="fwmdtOnFillingFinished">
         <matching matchingType="CFormData::mtWeb">
            <matchingWeb componentId="WebComponent">
            ...
            </matchingWeb>
         </matching>
      </formData>

   </forms>
</opLogon>

В приведенном примере матчинг Win32-компонента приложения выполняется по двум путям (%ProgramFiles%\Indeed-Id\Enterprise SSO\IndeedID.SSO.Test.App.exe, C:\IndeedID.SSO.Test.App.exe), контрольной сумме, размеру и описанию исполняемого файла приложения. К компоненту привязана форма входа.

Матчинг Web-компонента приложения выполняется по URL-адресу страницы, соответсвующему заданному регулярному выражению. К компоненту привязана форма входа.