ASP.NET을 사용하여 만든 XML Web services에 대한 구성 옵션

아티클
01/05/2008

웹 서비스 구성은 모든 ASP.NET Web 응용 프로그램에 사용되는 것과 동일한 모델을 따릅니다. ASP.NET 구성은 강력하면서 확장 가능한 XML 기반의 텍스트 파일 구성 아키텍처입니다. 간단히 말해서 구성 파일은 Microsoft .NET Framework의 특정 기술 기능에 대한 구성 옵션을 나타내는 XML 요소 집합입니다. 웹 서비스의 경우 구성 옵션은 구성 파일의 webServices XML 요소 내에 표시됩니다. 웹 서비스에서 사용할 수 있는 전체 구성 옵션 목록은 <webServices> 요소를 참조하십시오.

메시징 프로토콜 및 서비스 도움말 페이지 구성

웹 서비스에 대한 메시징 프로토콜 및 서비스 도움말 페이지는 구성 파일의 <webServices> 요소 아래에 있는 <protocols> 요소 XML 요소에서 구성할 수 있습니다. 구성은 각 설정에 대해 <protocols>의 <add> 요소 및 <protocols>의 <remove> 요소를 추가하여 구성 파일의 범위에서 해당 설정을 사용할 수 있는지를 지정함으로써 이루어집니다. add 요소는 구성 파일 범위에서 해당 설정에 대한 지원을 명시적으로 추가하고, remove 요소는 구성 계층에서 추가된 상위 지원을 제거합니다. 예를 들어, Machine.config 파일에서 add 요소를 사용하여 컴퓨터 수준에서 프로토콜 설정을 추가한 다음 Web.config 파일에서 remove 요소를 사용하여 웹 응용 프로그램에 대해 해당 설정을 제거할 수 있습니다. add 및 remove 요소의 구문은 다음과 같습니다.

<{add|remove} name="protocol name" />

add 및 remove 요소의 name 특성에는 다음과 같은 옵션이 있습니다.

설정	설명
HttpSoap	웹 서비스에 대한 SOAP over HTTP 프로토콜의 지원을 제어합니다. 설치 시 기본적으로 지원이 추가됩니다.
HttpGet	웹 서비스에 대한 HTTP-GET 프로토콜의 지원을 제어합니다. 설치 시 지원이 기본적으로 추가되지 않습니다.
HttpPost	요청 생성에 관계없이 컨트롤이 웹 서비스에 대해 HTTP-POST 프로토콜을 지원합니다. 설치 시 지원이 기본적으로 추가되지 않습니다.
HttpPostLocalhost	로컬 컴퓨터에서 요청이 생성될 때 웹 서비스에 대한 HTTP-POST 프로토콜 지원을 제어합니다. HttpPost가 현재 구성에 추가되면 이 설정이 적용되지 않습니다. 설치 시 기본적으로 지원이 추가됩니다.
Documentation	사용자가 브라우저에서 매개 변수를 사용하지 않고 웹 서비스에 대한 URL을 탐색할 경우 서비스 도움말 페이지를 표시할지 여부를 지정합니다. 설치 시 기본적으로 지원이 추가됩니다. Documentation 프로토콜 구성에 대한 자세한 내용은 이 항목의 뒷부분에 자세히 설명되어 있습니다.

참고:
.NET Framework 버전 1.0에서는 HttpSoap, HttpGet, HttpPost 및 Documentation 설정을 지원하므로 기본적으로 컴퓨터 수준에서 모든 설정이 활성화됩니다.

Documentation 프로토콜 구성

웹 서비스가 적절히 구성되었을 경우, 웹 브라우저에서 매개 변수를 사용하지 않고 웹 서비스에 대한 URL을 탐색할 때 클라이언트에서 웹 서비스에 대한 서비스 도움말 페이지를 볼 수 있습니다. 기본적으로 서비스 도움말 페이지에는 웹 서비스 및 해당 웹 서비스가 공개하는 웹 서비스 메서드와 통신하는 방법에 대한 정보가 사람이 인식할 수 있는 형식으로 포함되어 있습니다.

서비스 도움말 페이지는 간단한 ASP.NET Web Form이므로 회사 로고와 같은 항목을 포함하도록 대체하거나 수정할 수 있습니다. 서비스 도움말 페이지의 파일 이름은 Machine.config 파일에 지정된 DefaultWsdlHelpGenerator.aspx의 기본 설정을 사용하여 구성 파일의 <wsdlHelpGenerator> 요소에서 지정합니다.

서비스 도움말 페이지는 <protocols> 요소에 Documentation 프로토콜이 지정된 구성 파일 범위에 속하는 웹 서비스에 대해서만 표시됩니다. 기본적으로 Documentation 프로토콜은 Machine.config 파일에서 지정됩니다. 자세한 내용은 방법: 웹 서비스에 대한 서비스 도움말 페이지를 사용하지 않도록 설정을 참조하십시오.

보안

웹 서비스에 대해 HTTP-GET 또는 HTTP-POST 프로토콜을 활성화하면 의도하지 않은 호출에 노출될 수 있다는 것에 유의해야 합니다. 예를 들어, 아무 것도 모르는 사용자에게 클릭할 경우 전자 메일에 제공된 매개 변수를 사용하여 웹 서비스를 자동으로 호출하는 링크가 포함된 전자 메일이 수신될 수 있습니다. HTTP-GET 또는 HTTP-POST 프로토콜을 활성화하기 전에 그러한 호출이 위험할 수 있음을 고려해야 합니다.

참고 항목

Footer image

다음을 통해 공유

ASP.NET을 사용하여 만든 XML Web services에 대한 구성 옵션

메시징 프로토콜 및 서비스 도움말 페이지 구성

Documentation 프로토콜 구성

보안

참고 항목

작업

개념

기타 리소스

추가 리소스