Ejemplo de extensión de seguridad

[!NOTA] Para simplificar, el ejemplo de autenticación de formularios tiene un nombre no seguro y necesita una entrada de pertenencia URL simple en los archivos de directivas de seguridad. En su implementación de la extensión de seguridad de producción, al agregar directivas de seguridad para el ensamblado debe crear ensamblados con nombres seguros y usar la condición de pertenencia de nombre seguro. Para obtener más información acerca de ensamblados con nombres seguros, vea el tema sobre cómo crear y utilizar ensamblados con nombres seguros en MSDN.

A continuación, deberá aumentar los permisos para el grupo de código "Mi PC" en el archivo de directivas del Administrador de informes.

Para modificar el archivo RSMgrPolicy.config

1. Abra el archivo de directivas del Administrador de informes, rsmgrpolicy.config, que se encuentra en el directorio <instalación>\ReportManager.

2. Ubique el siguiente grupo de código en rsmgrpolicy.config y cambie el atributo PermissionSetName de Execution a FullTrust, como se indica a continuación:

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

Para usar la autenticación de formularios, debe modificar los archivos Web.config para que el Administrador de informes y el Servidor de informes cambien el modo de autenticación e inhabiliten la suplantación.

Para modificar el archivo Web.config para el Servidor de informes

1. Abra el archivo Web.config en un editor de texto. De forma predeterminada, el archivo se encuentra en el directorio <instalación>\ReportServer.

2. Busque el elemento <identity> y establezca el atributo Impersonate en false.

   <identity impersonate="false" />
   

3. Busque el elemento <authentication> y cambie el atributo Mode a Forms.

4. Agregue el elemento <forms> siguiente como secundario del elemento <authentication> y establezca los atributos loginUrl, name, timeout y path según se indica a continuación:

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

5. Agregue el elemento <authorization> siguiente directamente después del elemento <authentication>.

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

   Esto denegará a los usuarios no autenticados el derecho a obtener acceso al servidor de informes. El atributo loginUrl establecido anteriormente del elemento <authentication> redirigirá las solicitudes no autenticadas a la página Logon.aspx.

Para modificar el archivo Web.config para el Administrador de informes

1. Abra el Web.config del Administrador de informes. Se encuentra en el directorio <instalación>\ReportManager.

2. Deshabilite la suplantación; para ello, busque la sección <identity impersonate= "true" /> y cámbiela por lo siguiente:

Configurar la autenticación anónima

De manera predeterminada, el grupo de usuarios invitados incluye la cuenta IUSR_nombreDelEquipo. Esta cuenta se usa para iniciar sesión localmente y ver la página Logon.aspx. Para admitir la autenticación de formularios, debe habilitar el acceso anónimo para el directorio virtual ReportServer. De manera predeterminada, el acceso anónimo está deshabilitado.

Para habilitar la autenticación anónima

1. En Servicios de Internet Information Server, seleccione el directorio virtual ReportServer, que suele ser miembro del sitio Web predeterminado, y abra sus fichas Propiedad.

2. Haga clic en la ficha Seguridad de directorios.

3. En la sección de Autenticación y control de acceso, haga clic en Editar.

   Aparecerá el cuadro de diálogo Método de autenticación.

4. Active la casilla de verificación Acceso anónimo.

5. Haga clic en Aceptar.

   Repita los pasos anteriores para el directorio virtual Reports.

Crear la base de datos UserAccounts

El ejemplo incluye una secuencia de comandos de base de datos, createuserstore.sql, que permite configurar un almacén de usuarios para el ejemplo Forms en una base de datos de SQL Server.

Para crear la base de datos UserAccounts

1. Abra SQL Server Management Studio y conéctese a la instancia local de SQL Server.

2. Ubique el archivo de secuencia de comandos SQL createuserstore.sql. El archivo de secuencia de comandos se encuentra dentro de los archivos de proyecto del ejemplo.

3. Busque "LocalMachine" hacia el final de la secuencia de comandos y reemplácelo con su propio nombre de equipo. Los usuarios de Windows 2003 deben reemplazar LocalMachine\ASPNET por NT AUTHORITY\NETWORK SERVICE (excepto cuando se trabaja en el modo de compatibilidad de IIS 5).

4. Ejecute la consulta para crear la base de datos UserAccounts.

5. Salir de SQL Server Management Studio.

Probar el ejemplo

El siguiente procedimiento prueba la extensión del ejemplo. Deberá registrar un usuario administrador, que agrega el nombre de usuario, el valor hash de contraseña y el valor salt a la tabla users de la base de datos UserAccounts. Asimismo, deberá especificar ese nombre de usuario en el archivo de configuración del Servidor de informes. A continuación, iniciará sesión en el mismo usuario para garantizar el funcionamiento correcto de las rutinas de comprobación de contraseñas, así como la carga correcta del ensamblado de extensión por parte del servidor de informes.

Para crear el proyecto del informe

1. Reinicie IIS ejecutando Iisreset.exe en el símbolo del sistema.

2. Abra el Administrador de informes. Puede hacerlo desde el menú del programa Reporting Services u obteniendo acceso al directorio virtual Reports desde su explorador.

3. Escriba un nombre de usuario y una contraseña y haga clic en Registrar usuario para agregar el usuario a la base de datos accounts.

4. Abra el archivo RSReportServer.config. Busque el elemento <Security> y agregue el nombre de usuario registrado anteriormente como se indica a continuación:

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

5. Vuelva a la página UILogon.aspx, escriba de nuevo el nombre de usuario y la contraseña y haga clic en Inicio de sesión.

Debe obtener acceso al Administrador de informes y al servidor de informes sin restricciones. El usuario administrador creado tiene permisos sobre el servidor de informes equivalentes a los de una cuenta de administrador integrada en el equipo local. En este ejemplo, sólo puede tener un usuario designado como administrador. Una vez que tenga una cuenta de administrador integrada, puede registrar usuarios adicionales y asignarles funciones en el servidor de informes.

[!NOTA] Debe agregar su usuario administrador a las funciones oficiales de Administrador de sistema y Administrador de contenido (carpeta raíz) del servidor de informes. De este modo se evita que existan descriptores de seguridad vacíos en la base de datos del servidor de informes. Para obtener más información acerca de las funciones Administrador del sistema y Administrador de contenido, vea Información general de las funciones predefinidas.

Usar el servicio Web con seguridad personalizada

Puede usar la API del servicio Web con Autenticación de formularios de la misma forma que lo haría con la Autenticación de Windows. Sin embargo, debe llamar a LogonUser en su código de servicio Web y pasarle las credenciales del usuario actual. Además, el cliente de servicio Web no se beneficiará de la administración automática de cookies, que se ofrece en Internet Explorer u otros exploradores Web. Deberá ampliar la clase proxy Microsoft.ReportingServices para incluir la administración de cookies. Esto puede hacerse anulando los métodos GetWebRequest y GetWebResponse de la clase de servicio Web.

Depurar la extensión del ejemplo

Ejecutar la extensión del ejemplo en el depurador no sólo es una excelente manera de solucionar problemas, sino que también es un método efectivo para analizar el código y ver la autenticación del servidor de informes y el proceso de autenticación a medida que se producen.

Microsoft .NET Framework ofrece varias herramientas de depuración que pueden ayudarle a analizar el código del ejemplo. En el procedimiento siguiente se usa Visual Studio 2005 para depurar el ejemplo anterior.

Para depurar el código del ejemplo de Autenticación de formularios

1. Inicie Visual Studio y abra CustomSecurity.sln en el servidor de informes de prueba.

2. Abra Internet Explorer y vaya al Administrador de informes mientras el código de ejemplo queda abierto en Visual Studio.

3. Vaya a Visual Studio y establezca algunos puntos de interrupción en el código del proyecto de extensión de seguridad personalizado.

4. Con el proyecto de extensión en la ventana activa, desde el menú Depurar, haga clic en Proceso.

   Se abre el cuadro de diálogo Procesos.

5. En la lista de procesos, seleccione el proceso Aspnet_wp.exe (o W3wp.exe, si la aplicación se implementa en IIS 6.0), y haga clic en Asociar.

6. En el cuadro de diálogo Asociar al proceso, seleccione el tipo de programa Common Language Runtime y haga clic en Aceptar. Para mejorar el rendimiento de la depuración, asegúrese de que el tipo de programa Nativo no esté seleccionado.

7. Cuando se ejecuta el ejemplo, aparece un formulario de inicio de sesión. Escriba las credenciales del usuario en el formulario de inicio de sesión y haga clic en el botón Inicio de sesión.

   Siempre que se encuentren sus puntos de interrupción durante el procesamiento, el depurador deberá interrumpir la ejecución en ese punto.

8. Recorra el código con la tecla F11. Para obtener más información acerca de cómo usar Visual Studio para depurar, vea la documentación de Visual Studio 2005.

[!NOTA] Llevar a cabo la depuración de este modo exige muchos recursos y tiempo del procesador. Si tiene dificultades, cierre Visual Studio, restablezca IIS, y vuelva a empezar adjuntando la solución CustomSecurity al proceso de trabajo ASP.NET e iniciando sesión en el Administrador de informes.

Eliminar la extensión de ejemplo

Aunque generalmente no se recomienda, se puede volver a la Autenticación de Windows después de probar el ejemplo.

Para volver a la seguridad de Windows

1. Restaure los siguientes archivos desde las copias de seguridad: Web.config, RSReportServer.config y RSWebApplication.config. De este modo los métodos de autenticación y autorización del servidor de informes deben quedar establecidos en la seguridad predeterminada de Windows. También debe eliminar cualquier entrada realizada para la extensión en los archivos de configuración del Servidor de informes o Administrador de informes.

2. Deshabilite el acceso anónimo en los Servicios de Internet Information Server (IIS) para el directorio virtual de servidor de informes.

Después de eliminar la información de configuración, la extensión de seguridad ya no estará disponible en el servidor de informes. No debería ser necesario eliminar ningún descriptor de seguridad creado al ejecutar el servidor de informes con la extensión de seguridad del ejemplo. El servidor de informes asigna automáticamente la función de Administrador del sistema al grupo BUILTIN\Administrators en el equipo que aloja el servidor de informes cuando se habilita la Autenticación de Windows. Sin embargo, deberá volver a aplicar manualmente cualquier seguridad basada en funciones para los usuarios de Windows.

Tenga en cuenta que, por lo general, no se recomienda volver a la autenticación de Windows después de migrar a una extensión de seguridad diferente. De hacerlo, se pueden producir errores al intentar obtener acceso a elementos de la base de datos del servidor de informes que tengan descriptores de seguridad personalizados, pero no descriptores de seguridad de autenticación de Windows.

Vea también

Tareas

Ejemplos de SQL Server Reporting Services

Otros recursos

Ejemplos de extensiones (Reporting Services)
Implementing a Security Extension

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios