Estensione di esempio per la protezione

[!NOTA] Per ragioni di semplicità, l'esempio di autenticazione basata su form ha un nome vulnerabile e richiede una voce di appartenenza URL semplice nei file dei criteri di protezione. Nell'implementazione dell'estensione di protezione di produzione è necessario creare assembly con nome sicuro e utilizzare la condizione di appartenenza con nome sicuro quando si aggiungono criteri di protezione per l'assembly. Per ulteriori informazioni sugli assembly con nome sicuro, vedere l'argomento relativo alla creazione e all'utilizzo di assembly con nome sicuro in MSDN.

È quindi necessario ampliare le autorizzazioni per il gruppo di codice "My Computer" nel file dei criteri di Gestione report.

Per modificare il file RSMgrPolicy.config

1. Aprire il file dei criteri di Gestione report, rsmgrpolicy.config, incluso nella directory <install>\ReportManager.

2. Individuare il codice di gruppo seguente in rsmgrpolicy.config e modificare l'attributo PermissionSetName da Execution a FullTrust come indicato di seguito:

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

Per utilizzare l'autenticazione basata su form, è necessario modificare i file Web.config per Gestione report e Server report per modificare la modalità di autenticazione e disattivare la rappresentazione.

Per modificare il file Web.config per Server report

1. Aprire il file Web.config in un editor di testo. Per impostazione predefinita, il file è disponibile nella directory <install>\ReportServer.

2. Individuare l'elemento <identity> e impostare l'attributo Impersonate su false.

   <identity impersonate="false" />
   

3. Individuare l'elemento <authentication> e modificare l'attributo Mode in Forms.

4. Aggiungere l'elemento seguente <forms> come figlio dell'elemento <authentication> e impostare gli attributi loginUrl, name, timeout e path come indicato di seguito:

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

5. Aggiungere l'elemento <authorization> seguente direttamente dopo l'elemento <authentication>.

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

   In questo modo agli utenti non autenticati verrà negato l'accesso al server di report. L'attributo loginUrl impostato in precedenza per l'elemento <authentication> reindirizzerà le richieste non autenticate alla pagina Logon.aspx.

Per modificare il file Web.config per Gestione report

1. Aprire Web.config per Gestione report. Il file è incluso nella directory <install>\ReportManager.

2. Disattivare la rappresentazione individuando la sezione <identity impersonate= "true" /> e modificandola in <identity impersonate="false" />.

Configurazione dell'autenticazione anonima

Per impostazione predefinita, il gruppo di utenti di Windows Guests include l'account IUSR_computername che viene inizialmente utilizzato per l'accesso locale e la visualizzazione della pagina Logon.aspx. Per garantire il supporto dell'autenticazione basata su form, è necessario attivare l'accesso anonimo per la directory virtuale ReportServer. Per impostazione predefinita, l'accesso anonimo è disattivato.

Per attivare l'autenticazione anonima

1. In Internet Information Services selezionare la directory virtuale ReportServer, inclusa in genere nel sito Web predefinito, e aprire la finestra di dialogo Proprietà corrispondente.

2. Fare clic sulla scheda Protezione directory.

3. In Controllo autenticazione e accesso anonimo fare clic su Modifica.

   Verrà visualizzata la finestra di dialogo Metodi di autenticazione.

4. Selezionare la casella di controllo Accesso anonimo.

5. Fare clic su OK.

   Ripetere questi passaggi per la directory virtuale Reports.

Creazione del database UserAccounts

L'esempio include uno script di database, createuserstore.sql, che consente di configurare un archivio utente per l'esempio Forms in un database di SQL Server.

Per creare il database UserAccounts

1. Aprire SQL Server Management Studio e connettersi all'istanza locale di SQL Server.

2. Individuare il file script SQL createuserstore.sql. Il file script si trova all'interno dei file di progetto di esempio.

3. Individuare "LocalMachine" verso la fine dello script e sostituirlo con il nome del computer in uso. Gli utenti di Windows 2003 devono sostituire LocalMachine\ASPNET con NT AUTHORITY\NETWORK SERVICE (se non sono in modalità compatibilità con IIS 5).

4. Eseguire la query per creare il database UserAccounts.

5. Chiudere SQL Server Management Studio.

Test dell'esempio

Eseguire la procedura seguente per eseguire il test dell'estensione di esempio. È necessario registrare un utente amministratore, che aggiunge il nome utente, l'hash della password e il valore salt alla tabella users del database UserAccounts. È inoltre necessario specificare tale nome utente nel file di configurazione di Server report. Eseguire quindi l'accesso con lo stesso utente per verificare il corretto funzionamento delle routine di verifica della password nonché il caricamento corretto dell'assembly dell'estensione da parte del server di report.

Per creare il progetto report

1. Riavviare IIS eseguendo Iisreset.exe al prompt dei comandi.

2. Aprire Gestione report. A tale scopo, utilizzare il menu di programma di Reporting Services oppure accedere alla directory virtuale Reports tramite il browser.

3. Specificare nome utente e password e quindi fare clic su Register User per aggiungere l'utente al database accounts.

4. Aprire il file RSReportServer.config. Individuare l'elemento <Security> e aggiungere il nome utente registrato in precedenza, come indicato di seguito:

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

5. Ritornare alla pagina UILogon.aspx, immettere di nuovo il nome utente e la password e quindi fare clic su Logon.

È necessario disporre dell'accesso senza restrizioni a Gestione report e al server di report. L'utente amministratore creato dispone sul server di report di autorizzazioni equivalenti a quelle di cui dispone un account amministratore predefinito sul computer locale. Ai fini di questo esempio, è possibile disporre di un solo utente designato come amministratore. Dopo aver creato un account amministratore predefinito, è possibile registrare altri utenti e assegnare loro ruoli sul server di report.

[!NOTA] L'utente amministratore deve essere aggiunto ai ruoli ufficiali Amministratore sistema e Gestione contenuto (cartella principale) del server di report. In questo modo non ci sono descrittori di protezione vuoti nel database del server di report. Per ulteriori informazioni sui ruoli Amministratore sistema e Gestione contenuto, vedere Panoramica dei ruoli predefiniti

Utilizzo del servizio Web con la protezione personalizzata

È possibile utilizzare l'API del servizio Web con l'autenticazione basata su form in modo analogo all'utilizzo con l'autenticazione di Windows. È tuttavia necessario chiamare LogonUser nel codice del servizio Web e passare le credenziali dell'utente corrente. Il client del servizio Web non potrà inoltre usufruire del vantaggio offerto dalla gestione automatica dei cookie, che è garantita da Internet Explorer e altri browser. È necessario estendere la classe proxy Microsoft.ReportingServices per includere la gestione dei cookie. A tale scopo, ignorare i metodi GetWebRequest e GetWebResponse della classe del servizio Web.

Debug dell'estensione di esempio

L'esecuzione dell'estensione di esempio nel debugger non solo consente di risolvere eventuali problemi, ma è la soluzione ideale per esaminare il codice istruzione per istruzione e assistere in tempo reale all'autenticazione del server di report e al processo di autorizzazione.

In Microsoft .NET Framework sono disponibili diversi strumenti di debug che consentono di analizzare il codice di esempio. Nella procedura seguente viene utilizzato Visual Studio 2005 per eseguire il debug dell'esempio precedente.

Per eseguire il debug del codice di esempio dell'autenticazione basata su form

1. Avviare Visual Studio e aprire il file CustomSecurity.sln nel server di report di prova.

2. Aprire Internet Explorer e passare a Gestione report lasciando il codice di esempio aperto in Visual Studio.

3. Tornare a Visual Studio e impostare alcuni punti di interruzione nel codice del progetto dell'estensione per la protezione personalizzata.

4. Con il progetto dell'estensione nella finestra attiva scegliere Connetti a processo dal menu Debug.

   Verrà visualizzata la finestra di dialogo Connetti a processo.

5. Nell'elenco dei processi selezionare Aspnet_wp.exe (o W3wp.exe, se l'applicazione è distribuita in IIS 6.0) e fare clic su Connetti.

6. Nella finestra di dialogo Connetti a processo selezionare il tipo di programma Common Language Runtime e quindi fare clic su OK. Per ottenere le massime prestazioni durante il debug verificare che Nativo non sia selezionato come tipo di programma.

7. Durante l'esecuzione dell'esempio viene visualizzato un form di accesso. Immettere le credenziali utente nel form e fare clic su Logon.

   Quando durante l'elaborazione vengono raggiunti i punti di interruzione, il debugger interrompe l'esecuzione in corrispondenza di tali punti.

8. Esaminare il codice istruzione per istruzione premendo F11. Per ulteriori informazioni sull'utilizzo di Visual Studio per il debug, vedere la documentazione di Visual Studio 2005.

[!NOTA] L'esecuzione del debug comporta un utilizzo elevato delle risorse e del processore. Se si verificano problemi, chiudere Visual Studio, ripristinare IIS e iniziare di nuovo connettendo la soluzione CustomSecurity al processo di lavoro ASP.NET e accedendo a Gestione report.

Rimozione dell'estensione di esempio

È possibile ripristinare l'autenticazione di Windows dopo aver utilizzato l'esempio. Questa operazione non è tuttavia consigliabile.

Per ripristinare la protezione di Windows

1. Ripristinare i file seguenti dalle copie di backup: Web.config, RSReportServer.config e RSWebApplication.config. In questo modo, i metodi di autenticazione e autorizzazione per il server di report vengono impostati sulla protezione di Windows predefinita. Vengono inoltre rimosse le voci specificate per l'estensione nei file di configurazione di Server report e Gestione report.

2. Disattivare l'accesso anonimo in Internet Information Services (IIS) per la directory virtuale del server di report.

Dopo la rimozione delle informazioni di configurazione, l'estensione di protezione non è più disponibile per il server di report. Non dovrebbe essere necessario rimuovere i descrittori di protezione creati durante l'esecuzione del server di report nell'estensione di esempio per la protezione. Il server di report assegna automaticamente il ruolo Amministratore sistema al gruppo BUILTIN\Administrators sul computer che ospita il server di report quando l'autenticazione di Windows è attivata. È tuttavia necessario riapplicare manualmente la protezione basata sui ruoli per gli utenti di Windows.

Si noti che il ripristino dell'autenticazione di Windows dopo aver eseguito la migrazione a un'estensione di protezione diversa non è in genere consigliabile. Se si esegue il ripristino, potrebbero verificarsi errori quando si tenta di accedere a elementi nel database del server di report a cui sono associati descrittori di protezione personalizzati, ma non descrittori di protezione dell'autenticazione di Windows.

Vedere anche

Attività

Esempi di SQL Server Reporting Services

Altre risorse

Estensioni di esempio (Reporting Services)
Implementing a Security Extension

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche