Crittografia

Avviare Visual Studio .NET e creare un nuovo progetto Libreria di classi Visual C# denominato DPAPIComp.

Utilizzare Esplora soluzioni per rinominare Class1.cs come DataProtectorComp.cs.

All'interno di DataProtectorComp.cs, rinominare Class1 come DataProtectorComp e rinominare di conseguenza in modo appropriato il costruttore predefinito.

Aggiungere un riferimento all'assembly nell'assembly System.EnterpriseServices.dll.

Aggiungere le istruzioni using riportate di seguito all'inizio di DataProtectorComp.cs.

using System.EnterpriseServices; 
using System.Security.Principal; 
using System.Runtime.InteropServices; 

Derivare la classe DataProtectorComp dalla classe ServicedComponent.

public class DataProtectorComp : ServicedComponent 

Aggiungere alla classe DataProtectorComp i due metodi pubblici vuoti seguenti:

public byte[] Encrypt(byte[] plainText) 
{} 
public byte[] Decrypt(byte[] cipherText) 
{}

Aggiungere un riferimento al file nell'assembly DataProtection.dll.

Aggiungere l'istruzione using riportata di seguito sotto le istruzioni using esistenti in DataProtectorComp.cs.

using DataProtection; 

Aggiungere al metodo Encrypt il codice riportato di seguito per crittografare i dati forniti.

DataProtector dp = new DataProtector( DataProtector.Store.USE_USER_STORE ); 
byte[] cipherText = null; 
try 
{ 
  cipherText = dp.Encrypt(plainText, null); 
} 
catch(Exception ex) 
{ 
  throw new Exception("Exception encrypting. " + ex.Message); 
} 
return cipherText; 

Aggiungere al metodo Decrypt il codice riportato di seguito per decrittografare il testo cifrato fornito.

DataProtector dp = new DataProtector( DataProtector.Store.USE_USER_STORE ); 
byte[] plainText = null; 
try 
{ 
  plainText = dp.Decrypt(cipherText,null); 
} 
catch(Exception ex) 
{ 
  throw new Exception("Exception decrypting. " + ex.Message); 
} 
return plainText; 

Aggiungere una nuova classe Visual C# al progetto e assegnarle il nome Launcher.cs.

Aggiungere alla classe il seguente metodo: che verrà chiamato dal servizio all'avvio.

public bool Launch() 
{ 
  return true; 
} 

Scegliere Genera soluzione dal menu Genera.

Creare un nuovo account utente locale denominato DPAPIAccount. Immettere una password, deselezionare la casella di controllo Cambiamento obbligatorio password all'accesso successivo, quindi selezionare la casella di controllo Nessuna scadenza password.

Utilizzare lo strumento Criteri di protezione locali nel gruppo di programmi Strumenti di amministrazione per assegnare all'account i privilegi Accesso locale e Accesso come processo batch.

Disconnettersi da Windows.

Eseguire di nuovo l'accesso utilizzando il nuovo account DPAPIAccount.
Verrà creato un profilo utente per questo account.

Disconnettersi da Windows ed eseguire di nuovo l'accesso con il proprio account di sviluppatore.

Aprire una finestra di comando e modificare la directory impostandola sulla cartella del progetto DPAPIComp.

Mediante l'utilità sn.exe generare una coppia di chiavi da utilizzare per firmare l'assembly.

sn -k dpapicomp.snk 

Tornare a Visual Studio .NET e aprire Assemblyinfo.cs.

Individuare l'attributo AssemblyKeyFile e aggiungere il percorso del file di chiave all'interno della cartella del progetto.

[assembly: AssemblyKeyFile(@"..\..\dpapicomp.snk")] 

Aggiungere all'inizio del file l'istruzione using riportata di seguito.

using System.EnterpriseServices; 

Aggiungere gli attributi a livello di assembly riportati di seguito per configurare l'applicazione COM+ come applicazione server e per specificare il nome dell'applicazione.

[assembly: ApplicationActivation(ActivationOption.Server)] 
[assembly: ApplicationName("DPAPI Helper Application")] 

Scegliere Genera soluzione dal menu Genera per generare il progetto del componente servito.

Aprire una finestra di comando e passare alla directory di output del progetto contenente il file DPAPIComp.dll.

Utilizzare regsvcs.exe per registrare il componente servito e creare l'applicazione COM+.

regsvcs DPAPIComp.dll 

Avviare lo snap-in MMC (Microsoft Management Console) di Servizi componenti.

Espandere le cartelle Servizi componenti, Computer, Risorse del computer e ApplicazioniCOM +.

Individuare e fare clic con il pulsante destro del mouse su DPAPI Helper Application, quindi selezionare Proprietà.

Fare clic sulla scheda Attivazione e verificare che il tipo di applicazione sia impostato su Applicazione server.

Fare clic sulla scheda Identità, quindi selezionare il pulsante di opzione Il seguente utente.

Immettere DPAPIAccount come utente, digitare la password corretta, quindi scegliere OK per chiudere la finestra di dialogo Proprietà.

Avviare una nuova istanza di Visual Studio .NET e creare un nuovo progetto di servizio di Windows C# denominato DPAPIService.

Utilizzare Esplora soluzioni per rinominare Service1.cs come DPAPIService.cs.

All'interno di DPAPIService.cs rinominare Service1 come DPAPIService e rinominare di conseguenza in modo appropriato il costruttore predefinito.

All'interno di DPAPIService.cs individuare il metodo InitializedComponent e modificare il nome del servizio in DPAPIService.

Impostare un riferimento agli assembly System.EnterpriseServices.dll e System.Configuration.Install.dll.

Impostare un riferimento al file nell'assembly DPAPIComp.

Aggiungere la seguente istruzione using all'inizio di DPAPIService.cs, sotto le istruzioni using esistenti.

using DPAPIComp; 

Individuare il metodo Main e sostituire il seguente codice:

ServicesToRun = new System.ServiceProcess.ServiceBase[]{new Service1()}; 

con la seguente riga:

ServicesToRun = new System.ServiceProcess.ServiceBase[]{new DPAPIService()}; 

Individuare il metodo OnStart e aggiungere il codice riportato di seguito, che eseguirà il componente DPAPIComp all'avvio del servizio.

Launcher launchComponent = new Launcher(); 
launchComponent.Launch(); 

Aggiungere un nuovo file di classe C# al progetto e assegnare il nome DPAPIServiceInstaller.

Aggiungere all'inizio di DPAPIServiceInstaller le istruzioni using riportate di seguito, sotto l'istruzione using esistente.

using System.ComponentModel; 
using System.ServiceProcess; 
using System.Configuration.Install; 

Derivare la classe DPAPIServiceInstaller dalla classe Installer.

public class DPAPIServiceInstaller : Installer

Aggiungere l'attributo RunInstaller a livello di classe come indicato di seguito.

[RunInstaller(true)] 
public class DPAPIServiceInstaller : Installer 

Aggiungere le due variabili membro private riportate di seguito alla classe DPAPIServiceInstaller. Gli oggetti verranno utilizzati durante l'installazione del servizio.

private ServiceInstaller dpApiInstaller; 
private ServiceProcessInstaller dpApiProcessInstaller; 

Aggiungere il codice riportato di seguito al costruttore della classe DPAPIServiceInstaller.

dpApiInstaller = new ServiceInstaller(); 
dpApiInstaller.StartType = System.ServiceProcess.ServiceStartMode.Manual; 
dpApiInstaller.ServiceName = "DPAPIService"; 
dpApiInstaller.DisplayName = "DPAPI Service"; 
Installers.Add (dpApiInstaller);  
dpApiProcessInstaller = new ServiceProcessInstaller(); 
dpApiProcessInstaller.Account = ServiceAccount.User; 
Installers.Add (dpApiProcessInstaller); 

Scegliere Genera soluzione dal menu Genera.

Aprire una finestra di comando e modificare la directory impostandola sulla cartella Bin\Debug sotto la cartella del progetto DPAPIService.

Eseguire l'utilità installutil.exe per installare il servizio.

Installutil.exe DPAPIService.exe 

Nella finestra di dialogo Impostazione informazioni di accesso del servizio immettere il nome utente e la password dell'account creato in precedenza nella procedura 4, "Creazione di un account di Windows per eseguire l'applicazione di Enterprise Services e il servizio di Windows", quindi scegliere OK.
Il nome utente deve essere indicato nel formato "autorità\nomeutente".

Visualizzare l'output dall'utilità installutil.exe e verificare che il servizio sia installato correttamente.

Avviare lo snap-in MMC Servizi dal gruppo di programmi Strumenti di amministrazione.

Avviare il servizio DPAPI.

Aggiungere un nuovo progetto di applicazione Web C# denominato DPAPIWeb alla soluzione DPAPIComp esistente.

Aggiungere un riferimento all'assembly in System.EnterpriseServices e un riferimento al progetto nel progetto DPAPIComp.

Aprire WebForm1.aspx in modalità progettazione e creare un modulo analogo a quello illustrato nella figura 1. Utilizzare gli ID elencati nella tabella 1 per i singoli controlli.

Tabella 1: ID dei controlli di WebForm1.aspx

Figura 2
Modulo Web DPAPIWeb

Fare doppio clic sul pulsante Crittografa per visualizzare il gestore eventi ButtonClick.

Aggiungere le seguenti istruzioni using all'inizio del file, sotto le istruzioni using esistenti.

using System.Text; 
using DPAPIComp; 

Tornare al gestore eventi ButtonClick Encrypt e aggiungere il codice riportato di seguito per chiamare il componente servito DataProtectorComp allo scopo di crittografare i dati immessi mediante il modulo Web.

DataProtectorComp dp = new DataProtectorComp(); 
try 
{ 
  byte[] dataToEncrypt = Encoding.ASCII.GetBytes(txtDataToEncrypt.Text); 
  txtEncryptedData.Text = Convert.ToBase64String( 
                                    dp.Encrypt(dataToEncrypt)); 
} 
catch(Exception ex) 
{ 
  lblError.ForeColor = Color.Red; 
  lblError.Text = "Exception.<br>" + ex.Message; 
  return; 
} 
lblError.Text = ""; 

Visualizzare nuovamente il modulo Web e fare doppio clic sul pulsante Decrittografa per creare un gestore eventi ButtonClick.

Aggiungere il codice riportato di seguito al componente servito DataProtectorComp per decrittografare i dati precedentemente crittografati contenuti nel campo txtEncryptedData.

DataProtectorComp dp = new DataProtectorComp(); 
try 
{ 
  byte[] dataToDecrypt = Convert.FromBase64String(txtEncryptedData.Text); 
  txtDecryptedData.Text = Encoding.ASCII.GetString( 
                                  dp.Decrypt(dataToDecrypt)); 
} 
catch(Exception ex) 
{ 
  lblError.ForeColor = Color.Red; 
  lblError.Text = "Exception.<br>" + ex.Message; 
  return; 
} 
lblError.Text = ""; 

Scegliere Genera soluzione dal menu Genera.

Fare clic con il pulsante destro del mouse su WebForm1.aspx, quindi scegliere Visualizza nel browser.

Immettere una stringa di testo nel campo Dati da crittografare.

Fare clic sul pulsante Crittografa. Verrà eseguita la chiamata al componente servito DataProtector all'interno dell'applicazione COM+. I dati crittografati vengono visualizzati nel campo Dati crittografati.

Fare clic sul pulsante Decrittografa e verificare che la stringa di testo originale venga visualizzata nel campo Dati decrittografati.

Chiudere la finestra del browser.

Tornare a Visual Studio .NET e visualizzare WebForm1.aspx in modalità progettazione.

Aggiungere un altro pulsante al modulo. Impostare la proprietà Text su Decrypt string from config file e la proprietà ID su btnDecryptConfig.

Fare doppio clic sul pulsante per creare un gestore eventi ButtonClick.

Aggiungere l'istruzione using riportata di seguito all'inizio del file, sotto le istruzioni using esistenti.

using System.Configuration; 

Tornare al gestore eventi btnDecryptConfig_Click e aggiungere il codice riportato di seguito per recuperare una stringa di connessione al database dalla sezione <appSettings> del file Web.config.

DataProtectorComp dec = new DataProtectorComp(); 
try 
{ 
  string appSettingValue = 
            ConfigurationSettings.AppSettings["connectionString"]; 
  byte[] dataToDecrypt = Convert.FromBase64String(appSettingValue); 
  string connStr = Encoding.ASCII.GetString( 
                               dec.Decrypt(dataToDecrypt)); 
  txtDecryptedData.Text = connStr; 
} 
catch(Exception ex) 
{ 
  lblError.ForeColor = Color.Red; 
  lblError.Text = "Exception.<br>" + ex.Message; 
  return; 
} 
lblError.Text = ""; 

Scegliere Genera soluzione dal menu Genera per generare nuovamente i progetti.

Fare clic con il pulsante destro del mouse su WebForm1.aspx, quindi scegliere Visualizza nel browser.

Nel campo Dati da crittografare immettere una stringa di connessione al database analoga alla seguente:

server=(local);Integrated Security=SSPI; database=Northwind 

Fare clic sul pulsante Crittografa.

Selezionare il testo crittografato e copiarlo negli Appunti.

Passare a Visual Studio .NET, aprire il file Web.config e aggiungere l'elemento <appSettings> riportato di seguito all'esterno dell'elemento <system.web>. Assegnare la stringa di connessione crittografata contenuta negli Appunti all'attributo value.

<appSettings> 
   <add key="connectionString" value="encrypted connection string" />  
</appSettings> 

Salvare il file web.config.

Fare clic sul pulsante Decrypt string from config file e verificare che la stringa di connessione al database crittografata venga letta correttamente dal file Web.config e che la stringa decrittografata sia visualizzata correttamente nel campo Decrypted data.