[C#] ASP.NET 4.0 레거시 코드 web.config 파일 분석

ASP.NET 4.0 코드를 처음 접했을때 느낀 생소함과 이를 하나씩 이해하며 풀어가는 과정을 기록으로 남기고자 합니다.

프로젝트 분석을 하면서 가장 먼저 마주한 과제는 web.config 파일이었습니다. 그 중요성에 대해서는 익히 들어왔지만, 실제로 처음 파일을 살펴봤을 때는 각 설정 항목이 무엇을 의미하고, 어떻게 작동하는지 파악하는 데 생각보다 많은 시간이 필요했습니다. 

설정 파일 하나를 이해하는 데 시간을 쏟는 것이 비효율적으로 보일 수도 있지만, 실제로는 이 작업이 이후 리팩토링이나 버전 업그레이드 작업에서 애플리케이션의 전체적인 구조와 동작 방식을 이해하는 데 중요한 초석이 된다고 생각합니다.

이 글에서는 애플리케이션 실행에 필요한 여러 구성 요소와 환경 설정을 정의하는 web.config 파일의 구조와 역할에 대해 상세히 정리해 보도록 하겠습니다.

 

---

ASP.NET 설정 파일의 주요 구성 요소와 특징

1. 데이터베이스 연결 정보와 네트워크 경로 설정이 포함
2. 대용량 요청과 긴 세션 유지를 위한 설정
3. 보안 설정으로 서버 헤더 정보를 제거하고 요청 크기 제한을 설정
4. 에러 처리 시 사용자 정의 페이지로 리다이렉트되며, 디버그 시 로컬에서만 상세 정보 확인이 가능
5. 글로벌 설정으로 UTF-8 인코딩 및 특정 컨트롤/네임스페이스를 활용하도록 설정

 

---

1. 데이터베이스 연결 설정 (<connectionStrings>) 

<connectionStrings> 섹션은 ASP.NET 애플리케이션이 데이터베이스와 통신하기 위한 연결 정보를 정의하는 부분입니다.

이 섹션은 데이터베이스 서버와 애플리케이션 간의 연결 설정을 중앙 집중화하여 관리하며, 데이터베이스 접근을 효율적이고 안정하게 처리하는 데 사용됩니다.

코드 구조 및 설명: 

<connectionStrings>
    <add 
        name="DBConnectionString" 
        connectionString="Data Source=10.1.1.100;Initial Catalog=HyonieDB2;Persist Security Info=True;User ID=HyonieDB2;Password=abcd1234" 
        providerName="System.Data.SqlClient" />
</connectionStrings>

 

속성	설명	예시 값
name	연결 문자열의 이름으로, 애플리케이션 코드에서 참조	DBConnectionString
connectionString	데이터베이스 연결에 필요한 정보를 포함한 문자열	아래 구성 요소 참조
Data Source	데이터베이스 서버의 IP 주소 또는 이름	여기서는 데이터베이스 서버가 10.1.1.100 IP 주소에 위치
Initial Catalog	연결할 데이터 베이스의 이름	HyonieDB2
Persist Security Info	연결을 유지하는 동안 인증 정보를 저장할지 여부를 설정.	True 로 설정하면 연결을 유지하는 동안 보안 정보를 유지
User ID	데이터베이스 접속에 사용할 사용자 계정.	HyonieDB2
Password	사용자 계정의 비밀번호	abcd1234
providerName	- 연결에 사용할 데이터 제공자(Data Provider)를 정의 - 여기서는 SQL Server와 통신하는 .NET 제공자인 System.Data.SqlClient를 사용.	System.Data.SqlClient

 

 

---

 

2. 웹 설정(<system.web>)

 

아래는 일반적인 설정 항목과 그 역할에 대한 설명입니다.

항목	설명	예시 값
httpRuntime	- executionTimeout: 요청 실행 최대 시간(초 단위) 설정 - maxRequestLength: 요청 크기 제한	3600초 = 1시간, 1048576 KB = 약 1 GB
roleManager	롤(Role) 기반 인증을 활성	enabled="true"
sessionState	세션 유지 시간(분 단위) 설정	20000분 = 약 13.9일
trace	페이지 출력 추적 설정	pageOutput="true", enabled="false"
globalization	요청 및 응답의 문자 인코딩 설정	UTF-8
compilation	애플리케이션이 사용하는 .NET Framework버전 지정	4.0
pages	- controlRenderingCompatibilityVersion: 페이지 렌더링 호환성 설정 - clientIDMode: 서버 컨트롤 ID 자동 생성 - enableViewStateMac: ViewState 검증 설정	3.5, AutoID, true/ false
	- controls: 추가 컨트롤 설정 (예: AJAX 도구) - namespaces: 사용자 정의 네임스페이스 추가	AjaxControlToolkit , ExtensionMethods
customErrors	사용자의 정의 오류 페이지 설정	Error.html

 

 

 

 

---

 

3. 웹 서버 설정 (<system.webServer>)

 

<system.webServer> 섹션은 웹 서버에서의 요청 처리와 관련된 설정을 정의하며, 보안 및 성능 최적화에 중요한 역할을 합니다.

아래는 주요 설정 항목과 그 역합입니다:

항목	설명	예시 값
requestFiltering	maxAllowedContentLength: 요청 허용 크기를 바이트 단위로 설정하여 업로드 제한을 관리.	약 200MB (204857600)
httpErrors	- 로컬 환경에서만 상세한 오류 정보를 제공 (DetailedLocalOnly).	DetailedLocalOnly
modules	- 모든 요청에 대해 관리 모듈 실행 활성화 (runAllManagedModulesForAllRequests="true").	true
	- SecurityHttpModule: 특정 헤더를 제거하여 보안을 강화하는 사용자 정의 모듈 추가.
httpProtocol	- customHeaders: 서버 응답에서 불필요한 정보를 제거하여 보안을 강화.	X-Powered-By 제거

 

주요 설정 요약

1. requestFiltering: 클라이언트 요청의 크기를 제한함으로써, 비정상적으로 큰 요청으로부터 서버를 보호합니다.
2. httpErrors: 로컬 개발환경에서는 상세한 오류 정보를 제공하지만, 운영 환경에서는 단순 오류 메시지를 출력하여 민감한 정보를 숨깁니다.
3. modules: 모든 요청에 대해 지정된 모듈을 실행하며, 보안 강화를 위해 불필요한 HTTP 헤더를 제거하는 사용자 정의 모듈을 추가합니다.
4. httpProtocol: 서버 응답 헤더에서 X-Powered-By와 같은 정보 노출을 제거하여 서버의 기술 스택을 감춥니다.

 

---

 

4. 앱 설정 (<appSettings>)

 

<appSettings> 섹션은 애플리케이션 전역에서 사용할 수 있는 설정 값을 정의하는 공간입니다. 이 섹션은 주로 애플리케이션 구성에 필요한 경로나 환경 정보를 관리하며, 코드를 수정하지 않고도 설정을 쉽게 변경할 수 있도록 돕습니다.

<appSettings>
    <add key="hyonie_Image_Path" value="@\\<ServrAddress>\path\to\images" />
</appSettings>

 

속성	설명	예시 값
key	hyonie_Image_Path 라는 설정 키에 이미지 저장 경로가 할당	hyonie_Image_Path
value	설정 키에 할당된 값으로, 네트워크 경로나 기타 데이터를 정의합니다.	네트워크 경로(@)사용 <ServrAddress>\path\to\images

 

 

 

이와 같이 web.config 파일은 애플리케이션 핵심 설정을 중앙에서 관리하며, 데이터베이스 서버 정보가 변경되더라도, web.config 파일만 수정하면 애플리케이션 전체에 변경 사항이 반영됩니다.