Навигация:  Traffic Inspector SDK > WWW сервер > ASP.NET

 

Для хостинга ASP.NET приложений используется .NET Framework версии 2.0. Поддержка компонентов более старших версий не тестировалась.

 

Для выполнения ASP.NET приложений в Traffic Inspector предусмотрен отдельный процесс TIASPNETHostServer.exe. Он запускает  приложения .NET Framework и передает им для обработки HTTP запросы с веб сервера.

 

Каждое ASP.NET приложение имеет свой корневой раздел. Этот раздел описывается в списке разделов WWW сервера и для него включается опция Конфигурировать как ASP.NET сайт. Сразу после этого, спустя 1-2 секунды, сервер запустит хостинг этого приложения. Если это произошло успешно, в консоли в списке разделов для колонки ASP.NET появится имя приложения, иначе будет выведено сообщение об ошибке.

 

Конфигурацию приложения определяют два файла, размещаемых в его корне - web.config и global.asax. Первый файл обязателен, второй опционален.

 

Иерархия приложений.

 

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

 

 

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

 

Отладка ASP.NET приложений.

 

Для отладки приложения, написанного в Visual Studio, используйте операцию Attach to process из меню отладки. Имя процесса - TIASPNETHostServer.exe. Для выхода из отладки используйте Detach. Если по какой-то причине прервете процесс TIASPNETHostServer.exe, то службу Traffic Inspector придется перезапустить.

 

Данные проекта ASP.NET можно менять динамически, не останавливая службу Traffic Inspector. После изменения файлов кода приложения хостинг ASP.NET увидит эти изменения, перезагрузит приложение, при этом браузеру будет возвращена ошибка 503. Запрос после этого следует повторить. Если хостинг не применил изменения, то приложение раздела можно перезагрузить с консоли программы.

 

Особенности реализации ASP.NET.

 

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

 

 

Особенности конфигурации web.config.

 

Для интеграции с Traffic Inspector в файле web.config надо описать некоторые модули, а также там есть другие важные настройки.

 

Ниже приводится пример фрагмента этого файла -

 

<configuration>

 <system.web>

         <httpModules>

                 <add name="TIIdentityModule" type="TrafInsp.TIIdentityModule"/>

         </httpModules>

         <compilation>

                 <assemblies>

                         <add assembly="TIAspNet, Version=1.0.0.0, Culture=neutral,  PublicKeyToken=B0DFFE2005488D0A"/>

                         <add assembly="Interop.TrafInsp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=B0DFFE2005488D0A"/></assemblies>

         </compilation>

         <authentication mode="None"/>

         <authorization>

                 <allow roles="Администраторы"/>

                 <deny users="?"/>

         </authorization>

         <anonymousIdentification enabled="false"/>

         <sessionState mode="InProc"/>

 </system.web>

</configuration>

 

Подключение сборки TIAspNet для приложения обеспечивает ему доступ к API. Этот модуль также содержит класс TIIdentityModule, задача которого трансляция данных авторизации различным классам ASP.NET, использующим данные авторизации, например, для разграничения прав. См. пример ниже.

 

Сборка Interop.TrafInsp содержит описание COM API Traffic Inspector.

 

Обе этих сборки находятся в GAC, они туда помещаются при установке Traffic Inspector.

 

Элемент <sessionState mode="InProc"/>  опционален. По умолчанию это включено . Не следует делать mode="off", это отключит важный внутренний функционал ASP.NET и нарушит полноценное использование сессий для этого приложения. В этом элементе конфигурации можно переопределить таймаут сессий.

 

В этом примере приведено использование авторизации для разграничения прав средствами ASP.NET.

 

Строчка <anonymousIdentification enabled="false"/> запрещает анонимный доступ, доступ разрешен только для членов группы Администраторы. Отметим, что именно это поддерживается подключением класса TIIdentityModule.

 

В файл конфигурации также можно добавить описание приложения -

 

 <appSettings>

   <add key="AppInfo" value="Мое приложение"/>

 </appSettings>

 

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

 

Программное окружение ASP.NET приложения.

 

Приложению доступны многие переменные окружения через Request.ServerVariables. Доступны как стандартные переменные, так и некоторые другие. Вот список стандартных, выданных тестовой страничкой по SSL запросу -

 

 

Через модуль TIAspNet приложению доступно следующее -

 

 

В документе приведен экспорт публичного интерфейса модуля TIAspNet.

 

 

 

 

---

Текущая страница справки: http://help.smart-soft.ru/doc20/index.html?sdk_asp_net.htm

Сайт разработчиков Traffic Inspector