보안 확장 프로그램 예제

[!참고] 간단한 예제를 위해 폼 인증 예제에서는 이름을 짧게 지정하며 보안 정책 파일에 단순한 URL 멤버 자격 항목을 필요로 합니다. 실제 프러덕션 보안 확장 구현에서는 강력한 이름의 어셈블리를 만들고 어셈블리에 대한 보안 정책을 추가할 때 강력한 이름의 멤버 자격을 사용해야 합니다. 강력한 이름의 어셈블리에 대한 자세한 내용은 MSDN의 강력한 이름의 어셈블리 생성 및 사용(Creating and Using Strong-Named Assemblies) 항목을 참조하십시오.

다음으로 보고서 관리자 정책 파일의 "My Computer" 코드 그룹에 대한 권한 수준을 높입니다.

RSMgrPolicy.config 파일을 수정하려면

1. <install>\ReportManager 디렉터리에 있는 보고서 관리자 정책 파일 rsmgrpolicy.config를 엽니다.

2. rsmgrpolicy.config에서 다음 코드 그룹을 찾고 다음과 같이 PermissionSetName 특성을 Execution에서 FullTrust로 변경합니다.

   <CodeGroup 
           class="FirstMatchCodeGroup" 
           version="1" 
           PermissionSetName="FullTrust"
           Description="This code group grants MyComputer code Execution 
   permission. ">
       <IMembershipCondition 
               class="ZoneMembershipCondition"
               version="1"
               Zone="MyComputer" />
   

폼 인증을 사용하려면 보고서 관리자 및 보고서 서버에 대한 Web.config 파일을 수정하여 인증 모드를 변경하고 가장을 비활성화해야 합니다.

보고서 서버에 대한 Web.config 파일을 수정하려면

1. 텍스트 편집기에서 Web.config 파일을 엽니다. 기본적으로 이 파일은 <install>\ReportServer 디렉터리에 있습니다.

2. <identity> 요소를 찾아 Impersonate 특성을 false로 설정합니다.

   <identity impersonate="false" />
   

3. <authentication> 요소를 찾아 Mode 특성을 Forms로 변경합니다.

4. 다음의 <forms> 요소를 <authentication> 요소의 자식으로 추가하고 loginUrl, name, timeout 및 path 특성을 다음과 같이 설정합니다.

   <authentication mode="Forms">
      <forms loginUrl="logon.aspx" name="sqlAuthCookie" timeout="60" 
                  path="/"></forms>
      </authentication>
   

5. 다음 <authorization> 요소를 <authentication> 요소의 바로 다음에 추가합니다.

   <authorization> 
      <deny users="?" />
   </authorization>
   

   그러면 인증되지 않은 사용자가 보고서 서버에 액세스하는 권한이 거부됩니다. 이전에 설정한 <authentication> 요소의 loginUrl 특성은 인증되지 않은 요청을 Logon.aspx 페이지로 리디렉션합니다.

보고서 관리자에 대한 Web.config 파일을 수정하려면

1. 보고서 관리자에 대한 Web.config를 엽니다. 이 파일은 <install>\ReportManager 디렉터리에 있습니다.

2. <identity impersonate= "true" /> 섹션을 찾아 다음과 같이 변경하여 가장을 비활성화합니다. <identity impersonate="false" />.

익명 인증 구성

기본적으로 Windows 사용자 그룹 Guests에는 IUSR_computername 계정이 포함됩니다. 이 계정은 로컬에서 처음 로그인하여 Logon.aspx 페이지를 보는 데 사용합니다. 폼 인증을 지원하려면 ReportServer 가상 디렉터리에 대한 익명 액세스를 허용해야 합니다. 기본적으로 익명 액세스는 허용되지 않습니다.

익명 인증을 허용하려면

1. 인터넷 정보 서비스에서 일반적으로 기본 웹 사이트의 멤버인 ReportServer 가상 디렉터리를 선택하고 속성 탭을 엽니다.

2. 디렉터리 보안 탭을 클릭합니다.

3. 익명 액세스 및 인증 제어 섹션에서 편집을 클릭합니다.

   인증 방법 대화 상자가 나타납니다.

4. 익명 액세스 확인란을 선택합니다.

5. 확인을 클릭합니다.

   Reports 가상 디렉터리에 대하여 위의 단계를 반복합니다.

UserAccounts 데이터베이스 만들기

예제에는 SQL Server 데이터베이스의 폼 예제에 대한 사용자 저장소를 설정할 수 있는 데이터베이스 스크립트인 createuserstore.sql이 들어 있습니다.

UserAccounts 데이터베이스를 만들려면

1. SQL Server Management Studio를 열고 SQL Server 로컬 인스턴스에 연결합니다.

2. createuserstore.sql SQL 스크립트 파일을 찾습니다. 스크립트 파일은 예제 프로젝트 파일 안에 있습니다.

3. 스크립트의 끝 부분에서 "LocalMachine"을 찾아서 자신의 컴퓨터 이름으로 바꿉니다. Windows 2003 사용자의 경우 LocalMachine\ASPNET을 NT AUTHORITY\NETWORK SERVICE로 바꿉니다(IIS 5 호환성 모드일 경우는 해당하지 않음).

4. 쿼리를 실행하여 UserAccounts 데이터베이스를 만듭니다.

5. SQL Server Management Studio를 종료합니다.

예제 테스트

다음 프로시저는 확장 예제를 테스트합니다. 관리자를 등록하면 사용자 이름, 암호 해시, 솔트 값이 UserAccounts 데이터베이스의 users 테이블에 추가됩니다. 보고서 서버 구성 파일에 사용자 이름도 입력해야 합니다. 그런 다음 같은 사용자로 로그온하여 보고서 서버가 확장 어셈블리를 적절하게 로드하고 암호 확인 루틴 작업이 정확한지 확인합니다.

보고서 프로젝트를 만들려면

1. 명령 프롬프트에서 Iisreset.exe를 실행하여 IIS를 다시 시작합니다.

2. 보고서 관리자를 엽니다. Reporting Services 프로그램 메뉴에서 또는 브라우저에서 Reports 가상 디렉터리에 액세스하여 이 작업을 수행할 수 있습니다.

3. 사용자 이름과 암호를 입력하고 사용자 등록을 클릭하여 사용자를 accounts 데이터베이스에 추가합니다.

4. RSReportServer.config 파일을 엽니다. <Security> 요소를 찾아 이전에 등록한 사용자 이름을 다음과 같이 추가합니다.

   <Security>
      <Extension Name="Forms" 
   Type="Microsoft.Samples.ReportingServices.CustomSecurity.Authorization, 
   Microsoft.Samples.ReportingServices.CustomSecurity" >
         <Configuration>
            <AdminConfiguration>
               <UserName>username</UserName>
            </AdminConfiguration>
         </Configuration>
      </Extension>
   </Security>
   

5. UILogon.aspx 페이지로 돌아가 사용자 이름과 암호를 다시 입력하고 로그온을 클릭합니다.

보고서 관리자 및 보고서 서버에 제약 없이 액세스할 수 있어야 합니다. 만든 관리자 사용자는 해당 보고서 서버에서 로컬 컴퓨터에 있는 기본 제공 관리자 계정과 동등한 권한을 갖습니다. 간단한 예를 위해 이 예제에서는 한 사용자만 관리자로 지정할 수 있습니다. 기본 제공 관리자 계정이 있으면 보고서 서버에서 추가 사용자를 등록하고 역할을 할당할 수 있습니다.

[!참고] 관리자 사용자를 보고서 서버의 공식 시스템 관리자와 내용 관리자(루트 폴더) 역할에 추가해야 합니다. 그러면 보고서 서버 데이터베이스에 비어 있는 보안 설명자가 존재하는 것을 방지할 수 있습니다. 시스템 관리자 및 내용 관리자 역할에 대한 자세한 내용은 미리 정의된 역할 개요를 참조하십시오.

웹 서비스에서 사용자 지정 보안 사용

Windows 인증과 마찬가지로 폼 인증을 웹 서비스 API에서 사용할 수 있습니다. 하지만 웹 서비스 코드에서 LogonUser를 호출하고 현재 사용자의 자격 증명을 전달해야 합니다. 또한 사용자의 웹 서비스 클라이언트는 Internet Explorer나 다른 웹 브라우저에서 제공하는 자동 쿠키 관리의 장점을 활용할 수 없습니다. 쿠키 관리를 포함하려면 Microsoft.ReportingServices 프록시 클래스를 확장해야 합니다. 웹 서비스 클래스의 GetWebRequest 및 GetWebResponse 메서드를 오버라이드하여 이를 확장할 수 있습니다.

확장 예제 디버깅

디버거에서 확장 예제를 실행하면 발생할 수 있는 여러 문제점을 해결할 수 있을 뿐 아니라 코드를 단계적으로 수행하는 데 효과적이며 보고서 서버 인증 및 인증 프로세스를 진행 시점에서 확인할 수 있습니다.

Microsoft .NET Framework는 예제 코드를 분석하는 여러 디버깅 도구를 제공합니다. 다음 절차에서는 Visual Studio 2005를 사용하여 이전 예제를 디버깅합니다.

폼 인증 예제 코드를 디버깅하려면

1. 테스트 보고서 서버에서 Visual Studio를 시작하고 CustomSecurity.sln을 엽니다.

2. Visual Studio에서 예제 코드가 열려 있는 상태에서 Internet Explorer를 열어 보고서 관리자를 찾습니다.

3. Visual Studio로 전환하여 사용자 지정 보안 확장 프로젝트 코드에서 일부 중단점을 설정합니다.

4. 확장 프로젝트를 활성 창 상태로 두고 디버그 메뉴에서 프로세스를 클릭합니다.

   프로세스 대화 상자가 열립니다.

5. 프로세스 목록에서 Aspnet_wp.exe 프로세스(응용 프로그램을 IIS?6.0에서 배포할 경우 W3wp.exe)를 선택하고 연결을 클릭합니다.

6. 프로세스에 연결 대화 상자에서 Common Language Runtime 프로그램 종류를 선택하고 확인을 클릭합니다. 디버깅 성능을 개선하려면 디버깅할 프로그램 종류로 Native를 선택하지 않도록 합니다.

7. 예제를 실행하면 로그온 폼이 나타납니다. 로그온 폼에 사용자 자격 증명을 입력하고 Logon 단추를 클릭합니다.

   처리 중에 중단점을 만날 때마다 디버거는 해당 지점에서 실행을 중지합니다.

8. F11 키를 사용하여 코드를 단계별로 실행합니다. Visual Studio를 사용한 디버깅에 대한 자세한 내용은 Visual Studio 2005 설명서를 참조하십시오.

[!참고] 이런 방식의 디버깅에는 많은 리소스와 프로세서 시간이 소요됩니다. 실행에 어려움이 있을 경우 Visual Studio를 닫고 IIS를 다시 설정한 후 CustomSecurity 솔루션을 ASP.NET 작업자 프로세스에 연결하고 보고서 관리자에 로그온하여 다시 시작합니다.

확장 예제 제거

일반적으로 좋은 방법은 아니지만 예제를 확인한 후 Windows 인증으로 다시 전환할 수도 있습니다.

Windows 보안으로 전환하려면

1. 백업 복사본으로 Web.config, RSReportServer.config 및 RSWebApplication.config 파일을 복원합니다. 이렇게 하면 보고서 서버에 대한 인증 및 인증 방법이 기본 Windows 보안으로 설정됩니다. 또한 보고서 서버나 보고서 관리자 구성 파일에 입력한 확장에 대한 모든 항목이 제거됩니다.

2. 보고서 서버 가상 디렉터리에 대한 인터넷 정보 서비스(IIS)에 익명 액세스를 허용하지 않습니다.

구성 정보를 제거한 후에는 보고서 서버에서 보안 확장을 사용할 수 없습니다. 보안 확장 예제에서 보고서 서버를 실행하는 동안 만든 보안 설명자를 제거할 필요는 없습니다. 보고서 서버는 Windows 인증이 가능할 때 보고서 서버를 호스팅하는 컴퓨터의 BUILTIN\Administrators 그룹에 시스템 관리자 역할을 자동으로 할당합니다. 하지만 Windows 사용자에 대한 역할 기반 보안을 수동으로 다시 적용해야 합니다.

일반적으로 다른 보안 확장으로 마이그레이션한 후에 Windows 인증으로 다시 전환하는 것은 좋지 않습니다. 이렇게 하면 보고서 서버 데이터베이스에서 사용자 지정 보안 설명자는 있지만 Windows 인증 보안 설명자는 없는 항목에 액세스하려고 할 때 오류가 발생할 수 있습니다.

참고 항목

작업

SQL Server Reporting Services 예제

관련 자료

확장 프로그램 예제(Reporting Services)
Implementing a Security Extension

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역