Microsoft MVP성태의 닷넷 이야기
VC++: 73. IIS - ISAPI 필터 제작하는 방법 [링크 복사], [링크+제목 복사],
조회: 28574
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

IIS - ISAPI 필터 제작하는 방법

오랜만에 ISAPI 필터를 잠깐 들여다 봤는데요. 제작 방법은 다음의 온라인 문서에서 볼 수 있습니다.

Creating Simple ISAPI Filters
; https://learn.microsoft.com/en-us/previous-versions/iis/6.0-sdk/ms525035(v=vs.90)

C 소스코드는 대충 다음과 같이 구성하고,

#define _WIN32_WINNT 0x0400

#include <windows.h>
#include <httpfilt.h>

#define BUFFER_SIZE 2048

BOOL WINAPI GetFilterVersion(PHTTP_FILTER_VERSION pVer)
{
    pVer->dwFilterVersion = HTTP_FILTER_REVISION;
    lstrcpy(pVer->lpszFilterDesc, "...desc...");
    pVer->dwFlags = SF_NOTIFY_ORDER_HIGH | SF_NOTIFY_PREPROC_HEADERS;

    return TRUE;
}

DWORD WINAPI HttpFilterProc(PHTTP_FILTER_CONTEXT pfc, DWORD NotificationType, LPVOID pvNotification )
{
    if (NotificationType == SF_NOTIFY_PREPROC_HEADERS)
    {
       // ...
    }

    return SF_STATUS_REQ_NEXT_NOTIFICATION;
}

GetFilterVersion, HttpFilterProc 함수를 def 파일로 export 해주면 됩니다.

LIBRARY "...yours..."

EXPORTS
    HttpFilterProc
    GetFilterVersion

남은 것은 등록 과정인데요. 예전에는 IIS 관리자에서 직접 ISAPI 모듈을 등록해 주어야 했는데, 이제는 web.config에 등록하는 것이 가능해서 해당 DLL 모듈을 IIS 전역적으로 로드하지 않게 만들 수 있습니다. 이로 인해 얻게 되는 부수적인 효과는 잠김 현상이 줄어듦으로써 테스트가 좀 더 쉬워졌다는 점입니다. (심지어 IIS Express에서도 ISAPI 필터가 지원되기 때문에 테스트가 더욱 쉬워졌습니다. ^^)

web.config에 변경되는 부분은 다음의 문서에서 설명하고 있습니다.

ISAPI Filters <isapiFilters>
; https://learn.microsoft.com/en-us/iis/configuration/system.webServer/isapiFilters/

그래서 테스트 하려는 ISAPI DLL 파일의 경로를 다음과 같이 web.config에 명시하면 해당 Web Application만 ISAPI를 로드하게 됩니다.

<?xml version="1.0" encoding="utf-8"?>

<configuration>
  <system.web>
    <compilation debug="true" targetFramework="4.5" />
    <httpRuntime targetFramework="4.5" />
  </system.web>

    <system.webServer>
        <isapiFilters>
            <filter
               name="HeaderFilter"
               enabled="true"
               enableCache="false"
               path="D:\Debug\InterceptHeader.dll" />
        </isapiFilters>
    </system.webServer>

</configuration>




하지만, 직접 해보면 web.config 등록 이후 모든 웹 요청이 다음과 같은 메시지를 떨어뜨리면서 실패하는 현상을 겪게 됩니다.

Error 500.19 - Internal Server Error

The requested page cannot be accessed because the related configuration data for the page is invalid.

Detailed Error Information:

Module
IIS Web Core

Notification
Unknown

Handler
ExtensionlessUrl-Integrated-4.0

Error Code
0x80070021

Config Error This configuration section cannot be used at this path. This happens when the section is locked at a parent level. Locking is either by default (overrideModeDefault="Deny"), or set explicitly by a location tag with overrideMode="Deny" or the legacy allowOverride="false".

Config File
\\?\D:\WebApplication1\web.config

Requested URL
http://localhost:46931/

Physical Path
D:\WebApplication1

Logon Method
Not yet determined

Logon User
Not yet determined

Request Tracing Directory
d:\Documents\IISExpress\TraceLogFiles\WEBAPPLICATION1(22)

Config Source:
12: <system.webServer>
13: <isapiFilters>
14: <filter


More Information:
This error occurs when there is a problem reading the configuration file for the Web server or Web application. In some cases, the event logs may contain more information about what caused this error.

If you see the text "There is a duplicate 'system.web.extensions/scripting/scriptResourceHandler' section defined", this error is because you are running a .NET Framework 3.5-based application in .NET Framework 4. If you are running WebMatrix, to resolve this problem, go to the Settings node to set the .NET Framework version to ".NET 2". You can also remove the extra sections from the web.config file.


오류 원인은 간단합니다. 기본적으로는 전역 config 설정에서 ISAPI 필터를 추가하는 것이 금지되어 있기 때문입니다. 이것을 해제하려면 applicationHost.config의 내용을 변경해야 하는데 IIS의 경우 다음의 경로에 있는 파일을 편집하면 됩니다.

C:\Windows\System32\inetsrv\config\applicationHost.config

위의 파일을 관리자 권한으로 실행시킨 메모장에서 열어 다음의 내용을 찾아 Deny에서 Allow로 변경하면 됩니다.

<sectionGroup name="system.webServer">
    ...[생략]...
    <section name="isapiFilters" allowDefinition="MachineToApplication" overrideModeDefault="Allow" />
    ...[생략]...

주의할 것은 IIS Express의 경우 사용하는 applicationHost.config 파일의 위치가 다르다는 점입니다. IIS Express는 원본 applicationHost.config 파일을 다음의 경로에 유지하고 있다가,

"C:\Program Files (x86)\IIS Express\AppServer\applicationhost.config"

윈도우에 로그인한 계정에서 최초 IIS Express를 구동하는 시점에 다음의 경로에 복사본을 생성하고 그것을 기반으로 동작합니다. (Visual Studio에서 실행된 경우 이렇게 복사해서 동작하는 것이 기본입니다.)

%userprofile%\documents\iisexpress\config\applicationhost.config

따라서, "%userprofile%\documents\iisexpress\config\applicationhost.config" 파일이 있다면 이걸 수정해 줘야 하고, 없다면 "C:\Program Files (x86)\IIS Express\AppServer\applicationhost.config" 파일을 수정해 주면 됩니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 1/3/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2013-12-16 01시59분
[ryujh] 안녕하세요.

ISAPI 필터와 HTTP 모듈이 같은(비슷한?) 개념으로 알고 있는데

ISAPI 필터만 가능한 것과 사용해야할 경우 등이 무엇입니까?
반대로 HTTP 모듈만 가능한 것과 사용해야할 경우도 입니다.

파일업로드 관련 기능에서 HTTP 모듈을 구현한 적은 있는데 ISAPI 필터로 바꾼다면 이점이 있다고 보시는지요?

ISAPI 필터를 사용할 수 밖에 없을 때 유지보수라도 필요하니 배워야 할 것 같습니다. 요즘은 개발보다 유지보수를 하고 있는 중입니다.

이상입니다.
[guest]
2013-12-16 10시30분
사실 IIS 7부터 Integrated 모드가 나오면서 ISAPI 필터의 장점이 많이 사라졌습니다. 현재 남은 결정적인 이점이라면 IIS 6에서도 가능하다는 것인데 Windows Server 2003에 대한 서비스 기간 만료 시점이 다가오면서 그나마도 없어질 듯합니다. 파일 업로드 모듈을 굳이 ISAPI로 바꿀 필요는 없어보입니다. ^^ 그리고, ISAPI는 Server Extension과 Filter로 나뉘는데, 말씀하신 파일 업로드 모듈은 Filter가 아닌 Server Extension에 해당합니다.

정리하면, 범용적인 목적의 필터가 필요한 제품을 만드는 경우가 아니고 자사의 솔루션에 넣을 요량이라면 HTTP 모듈이 더 바람직합니다.
정성태

... 76  [77]  78  79  80  81  82  83  84  85  86  87  88  89  90  ...
NoWriterDateCnt.TitleFile(s)
12011정성태8/27/201926229사물인터넷: 57. C# - Rapsberry Pi Zero W와 PC 간 Bluetooth 통신 예제 코드파일 다운로드1
12010정성태8/27/201919160VS.NET IDE: 138. VSIX - DTE.ItemOperations.NewFile 메서드에서 템플릿 이름을 다국어로 설정하는 방법
12009정성태8/26/201919989.NET Framework: 858. C#/Windows - Clipboard(Ctrl+C, Ctrl+V)가 동작하지 않는다면?파일 다운로드1
12008정성태8/26/201919658.NET Framework: 857. UWP 앱에서 SQL Server 데이터베이스 연결 방법
12007정성태8/24/201918264.NET Framework: 856. .NET Framework 버전을 올렸을 때 오류가 발생할 수 있는 상황
12006정성태8/23/201921735디버깅 기술: 129. guidgen - Encountered an improper argument. 오류 해결 방법 (및 windbg 분석) [1]
12005정성태8/13/201919353.NET Framework: 855. 닷넷 (및 VM 계열 언어) 코드의 성능 측정 시 주의할 점 [2]파일 다운로드1
12004정성태8/12/201927623.NET Framework: 854. C# - 32feet.NET을 이용한 PC 간 Bluetooth 통신 예제 코드 [14]
12003정성태8/12/201919754오류 유형: 564. Visual C++ 컴파일 오류 - fatal error C1090: PDB API call failed, error code '3'
12002정성태8/12/201919111.NET Framework: 853. Excel Sheet를 WinForm에서 사용하는 방법 - 두 번째 이야기 [5]
12001정성태8/10/201924320.NET Framework: 852. WPF/WinForm에서 UWP의 기능을 이용해 Bluetooth 기기와 Pairing하는 방법 [1]
12000정성태8/9/201923739.NET Framework: 851. WinForm/WPF에서 Console 창을 띄워 출력하는 방법파일 다운로드1
11999정성태8/1/201917993오류 유형: 563. C# - .NET Core 2.0 이하의 Unix Domain Socket 사용 시 System.IndexOutOfRangeException 오류
11998정성태7/30/201920106오류 유형: 562. .NET Remoting에서 서비스 호출 시 SYN_SENT로 남는 현상파일 다운로드1
11997정성태7/30/201920393.NET Framework: 850. C# - Excel(을 비롯해 Office 제품군) COM 객체를 제어 후 Excel.exe 프로세스가 남아 있는 문제 [2]파일 다운로드1
11996정성태7/25/201923398.NET Framework: 849. C# - Socket의 TIME_WAIT 상태를 없애는 방법파일 다운로드1
11995정성태7/23/201927124.NET Framework: 848. C# - smtp.daum.net 서비스(Implicit SSL)를 이용해 메일 보내는 방법 [2]
11994정성태7/22/201921820개발 환경 구성: 454. Azure 가상 머신(VM)에서 SMTP 메일 전송하는 방법파일 다운로드1
11993정성태7/22/201916508오류 유형: 561. Dism.exe 수행 시 "Error: 2 - The system cannot find the file specified." 오류 발생
11992정성태7/22/201918614오류 유형: 560. 서비스 관리자 실행 시 "Windows was unable to open service control manager database on [...]. Error 5: Access is denied." 오류 발생
11991정성태7/18/201915671디버깅 기술: 128. windbg - x64 환경에서 닷넷 예외가 발생한 경우 인자를 확인할 수 없었던 사례
11990정성태7/18/201917913오류 유형: 559. Settings / Update & Security 화면 진입 시 프로그램 종료
11989정성태7/18/201916760Windows: 162. Windows Server 2019 빌드 17763부터 Alt + F4 입력시 곧바로 로그아웃하는 현상
11988정성태7/18/201919279개발 환경 구성: 453. 마이크로소프트가 지정한 모든 Root 인증서를 설치하는 방법
11987정성태7/17/201925183오류 유형: 558. 윈도우 - KMODE_EXCEPTION_NOT_HANDLED 블루스크린(BSOD) 문제 [1]
11986정성태7/17/201916933오류 유형: 557. 드라이브 문자를 할당하지 않은 파티션을 탐색기에서 드라이브 문자와 함께 보여주는 문제
... 76  [77]  78  79  80  81  82  83  84  85  86  87  88  89  90  ...