RSWebApplication 구성 파일

  • 아티클

업데이트: 2006년 7월 17일

RSWebApplication.config 파일은 보고서 관리자에 대한 구성 설정을 저장하고 보고서 배포에 사용되는 설정 및 사용자당 열려 있는 연결 수를 지정합니다.

파일 위치

이 파일은 \Reporting Services\ReportManager 폴더에 있습니다.

편집 지침

이 파일을 편집하여 열려 있는 연결 수를 제한하고, 기본 배달 확장 프로그램을 변경하고, 각 배달 확장 프로그램의 기본 렌더링 형식을 변경할 수 있습니다.

기본 구성의 예

다음 예에서는 RSWebApplication.config 파일에 포함된 일부 설정 및 기본값을 보여 줍니다.

<Configuration>
     <UI>
     <ReportServerUrl></ReportServerUrl>
     <ReportServerVirtualDirectory>ReportServer</ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
     </UI>
     <Extensions>
          <DeliveryUI>
               <Extension Name="Report Server Email" Type="Microsoft.ReportingServices.EmailDeliveryProvider.EmailDeliveryProviderControl,ReportingServicesEmailDeliveryProvider">
                    <DefaultDeliveryExtension>True</DefaultDeliveryExtension>
                    <Configuration>
                         <RSEmailDPConfiguration>
                              <DefaultRenderingExtension>MHTML</DefaultRenderingExtension>
                         </RSEmailDPConfiguration>
                    </Configuration>
               </Extension>
               <Extension Name="Report Server FileShare" Type="Microsoft.ReportingServices.FileShareDeliveryProvider.FileShareUIControl,ReportingServicesFileShareDeliveryProvider"/>
          </DeliveryUI>
     </Extensions>
     <Add Key="MaxActiveReqForOneUser" Value="20"/>
     <Add Key="DisplayErrorLink" Value="true"/>
</Configuration>

보고서 서버 끝점 액세스를 위한 대체 구성의 예

이 예에서는 ReportServerVirtualDirectory 대신 ReportServerUrl을 사용하는 방법을 보여 줍니다.

ms155878.note(ko-kr,SQL.90).gif중요:
구성 설정은 대소문자를 구분합니다. 새 항목을 추가할 때는 보이는 대로 정확하게 설정을 입력하십시오. 대소문자를 구분하지 않으면 "구성 파일에 잘못된 요소가 들어 있습니다. ElementName 요소는 구성 파일 요소가 아닙니다."와 같은 오류가 나타납니다. 
<UI>
     <ReportServerUrl>https://www.adventure-works.com/ReportServer</ReportServerUrl>
     <ReportServerVirtualDirectory></ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
</UI>

구성 설정

다음 표에서는 기본 설정에 대한 정보를 제공합니다. 설정은 구성 파일에 나타나는 순서로 표시됩니다. 사용자 지정 배달 확장 프로그램을 사용할 경우 구성 파일에는 추가 설정이 포함됩니다.

설정 설명

ReportServerVirtualDirectory

보고서 관리자가 사용하는 보고서 서버의 SOAP 끝점을 지정합니다. 보고서 서버 가상 디렉터리 이름이 값으로 사용됩니다. 예를 들어 보고서 서버 URL이 http://adventure-works.com/reportserver이면 ReportserverVirtualDirectory 설정의 값은 reportserver입니다.

이 설정을 사용하려면 보고서 관리자와 보고서 서버에서 동일한 웹 사이트를 사용하도록 구성해야 합니다. 서로 다른 웹 사이트를 사용하는 경우 ReportServerVirtualDirectory의 값을 삭제하고 대신 ReportServerURL을 사용합니다.

URL 및 이 설정에 대한 자세한 내용은 보고서 서버 가상 디렉터리 구성 및 인터넷 액세스를 위한 보고서 서버 구성을 참조하십시오.

ReportServerUrl

보고서 관리자에 사용되는 보고서 서버의 SOAP 끝점을 지정하는 다른 방법을 제공합니다. 보고서 관리자와 보고서 서버 가상 디렉터리가 별개의 서버 또는 웹 사이트에 호스팅되어 있는 경우 또는 보고서 서버에 대해 정규화된 도메인 이름을 지정해야 하는 경우 ReportServerVirtualDirectory 대신 이 설정을 사용할 수 있습니다.

ReportServerURL과 ReportServerVirtualDirectory는 함께 사용할 수 없습니다. ReportServerURL을 지정하면 ReportServerVirtualDirectory에 대한 항목을 삭제해야 합니다.

이 설정을 지정하려면 RSWebApplication.config 파일을 수동으로 편집해야 합니다. 유효한 값에는 http://<server>/<reportserver> 또는 https://<server>/<reportserver>(인증서를 사용하는 경우)가 포함됩니다. 보고서 관리자를 인터넷 연결 웹 서버에 별도로 설치한 경우 이 값은 방화벽으로 보호된 보고서 서버 인스턴스에 액세스하는 데 사용할 수 있는 정규화된 도메인 이름이어야 합니다. 이 값을 localhost로 설정할 수는 없습니다.

SSL(Secure Sockets Layer) 인증서가 설치된 경우 이 값은 SSL 인증서에 등록된 서버 이름으로 설정되어야 합니다. "기본 연결이 닫혔습니다. SSL/TLS 보안 채널에 대한 트러스트 관계를 설정할 수 없습니다."라는 오류 메시지가 표시되면 ReportServerUrl을 인증서가 발급된 서버의 정규화된 도메인 이름으로 설정합니다. 예를 들어 인증서가 https://adventure-works.com.onlinesales에 등록되어 있는 경우 보고서 서버 URL은 https://adventure-works.com.onlinesales/reportserver로 설정합니다.

이 설정을 사용하는 방법의 예를 보려면 이 항목에 제공된 예를 참조하십시오. URL 및 이 설정에 대한 자세한 내용은 보고서 서버 가상 디렉터리 구성을 참조하십시오.

ReportBuilderTrustLevel

보고서 작성기가 완전 신뢰로 실행되는지, 또는 부분 신뢰로 실행되는지 여부를 지정합니다. 유효한 값은 FullTrust 및 PartialTrust입니다. 기본값은 FullTrust입니다. 이러한 신뢰 수준에 대한 자세한 내용은 보고서 작성기 시작을 참조하십시오.

PassThroughCookies

이 설정은 기본적으로 구성 파일에 포함되어 있지 않습니다. 이 설정을 사용하려면 직접 추가해야 합니다.

이 설정은 보고서 관리자에서 사용자 지정 인증 쿠키를 전송하도록 구성합니다. 자세한 내용 및 구성 설정 지정 방법에 대한 예를 보려면 보고서 관리자에서 사용자 지정 인증 쿠키를 전달하도록 구성을 참조하십시오.

ReportServerExternalUrl

이 설정은 더 이상 사용되지 않습니다. 이전 릴리스에서는 방화벽 뒤의 보고서 서버에 요청을 보내야 하는 응용 프로그램 및 내부 프로세스에 정규화된 보고서 서버 URL을 제공하기 위해 이 설정이 사용되었습니다. 이 설정은 기본적으로 구성 파일에 포함되지 않았습니다. 수동으로 추가한 경우 파일에 남겨 두거나 제거할 수 있습니다. 인터넷 연결 보고서 서버에 보고서 작성기를 배포하는 것은 이 릴리스에서 테스트되지 않은 배포 시나리오입니다. 보고서 작성기에 대한 인터넷 액세스를 지원하기 위해 과거에 이 설정을 사용했다면 대체 전략을 고려해야 합니다.

DeliveryUI

구독에 사용할 수 있는 배달 확장 프로그램을 지정합니다. 이 섹션에서 지정한 확장 프로그램 이름은 보고서 관리자의 구독 정의 페이지에서 배달 옵션으로 나타납니다. Reporting Services에는 구독에 대한 두 가지 기본 배달 확장 프로그램인 Report Server Email과 Report Server FileShare가 포함되어 있습니다. 자세한 내용은 전자 메일 배달을 위한 보고서 서버 구성 및 Reporting Services의 파일 공유 배달를 참조하십시오.

DefaultDeliveryExtension

배달 확장 프로그램이 기본값인지 여부를 지정합니다. Report Server E-Mail은 기본 배달 확장 프로그램입니다. 유효한 값은 True 또는 False입니다. 둘 이상의 확장 프로그램에 True 값이 설정되어 있으면 첫 번째 확장 프로그램을 기본 확장 프로그램으로 간주합니다.

Configuration

배달 확장 프로그램에 대한 구성 옵션을 지정합니다. 각 배달 확장 프로그램에 대한 기본 렌더링 형식을 설정할 수 있습니다. 유효한 값은 rsreportserver.config 파일의 render 섹션에 지정된 렌더링 확장 프로그램 이름입니다.

MaxActiveReqForOneUser

보고서 관리자에 대해 단일 사용자가 열 수 있는 최대 동시 및 진행 연결 수를 지정합니다. 최대 동시 연결 수에 도달하면 사용자의 추가 연결 요청이 거부됩니다. 이 구성 설정은 서비스 거부 공격을 완화시키기 위한 것입니다.

유효한 값은 0에서 최대 정수 사이입니다. 0은 연결 수에 제한이 없음을 나타냅니다. 기본값은 20입니다.

대부분의 요청은 대단히 빠르게 처리되므로 단일 사용자가 지정된 시간에 연결이 20개 이상 열린 상태에서 작업할 가능성은 없습니다. 많은 프로세스가 진행되는 보고서를 15개 이상 열 경우 이 값을 늘려야 할 수 있습니다.

DisplayErrorLink

Microsoft 도움말 및 지원 사이트에 대한 링크를 표시합니다. 이 링크는 오류 메시지에 나타납니다. 사용자는 사이트에 연결하여 업데이트된 오류 메시지 내용을 볼 수 있습니다. 유효한 값은 true 또는 false입니다. 기본값은 true입니다.

변경 기록

릴리스 기록

2006년 7월 17일
새로운 내용:
  • ReportServerUrl 지정 방법을 보여 주는 예를 추가했습니다.

참고 항목

개념

Reporting Services 구성 파일
RSReportServer 구성 파일

관련 자료

Implementing a Delivery Extension

도움말 및 정보

SQL Server 2005 지원 받기