SecAnnotate.exe (strumento .NET Security Annotator)

Lo strumento .NET Security Annotator (SecAnnotate.exe) è un'applicazione da riga di comando che identifica le parti SecurityCritical e SecuritySafeCritical di uno o più assembly.

Un'estensione di Visual Studio, Security Annotator, offre un'interfaccia utente grafica a SecAnnotate.exe e consente di eseguire lo strumento da Visual Studio.

Viene installato automaticamente con Visual Studio. Per eseguire lo strumento, usare il prompt dei comandi per gli sviluppatori di Visual Studio o Visual Studio Developer PowerShell.

Al prompt dei comandi, digitare quanto segue, i cui parametri vengono illustrati nella sezione seguente e gli assembly consistono di uno o più nomi di assembly separati da spazi vuoti:

Sintassi

SecAnnotate.exe [parameters] [assemblies]  

Parametri

Opzione	Descrizione
/a oppure /showstatistics	Mostra le statistiche sull'utilizzo della trasparenza negli assembly analizzati.
/d:Directory oppure /referencedir:Directory	Specifica una directory in cui cercare gli assembly dipendenti durante l'annotazione.
/i oppure /includesignatures	Include informazioni estese sulle firme nel file di rapporto sulle annotazioni.
/n oppure /nogac	Interrompe la ricerca degli assembly di riferimento nella Global Assembly Cache.
/o:output.xml oppure /out:output.xml	Specifica il file delle annotazioni di output.
/p:maxpasses oppure /maximumpasses:maxpasses	Specifica il numero massimo di passaggi di aggiunta annotazioni da effettuare sugli assembly prima di interrompere la generazione di nuove annotazioni.
/q oppure /quiet	Specifica una modalità non interattiva, nella quale l'annotatore non restituisce messaggi di stato, ma solo informazioni sugli errori.
/r:Assemblea oppure /referenceassembly:Assemblea	Include l'assembly specificato quando vengono risolti gli assembly dipendenti durante l'annotazione. Gli assembly di riferimento sono prioritari rispetto agli assembly trovati nel percorso di riferimento.
/s:Rulename oppure /suppressrule:Rulename	Elimina l'esecuzione della regola di trasparenza specificata sugli assembly di input.
/t oppure /forcetransparent	Forza lo strumento di annotazione a trattare tutti gli assembly che non dispongono di alcuna annotazione di trasparenza come se fossero completamente trasparenti.
/t:assembly oppure /forcetransparent:assembly	Forza la trasparenza per l'assembly specificato, a prescindere dalle relative annotazioni correnti a livello di assembly.
/v oppure /verify	Verifica solo che le annotazioni di un assembly siano corrette. Non tenta di eseguire più passaggi per trovare tutte le annotazioni necessarie se non supera la verifica.
/x oppure /verbose	Specifica un output dettagliato durante l'annotazione.
/y:Directory oppure /symbolpath:Directory	Include la directory specificata quando si ricercano file di simboli durante l'annotazione.

Commenti

Parametri e assembly possono essere forniti anche in un file di risposta specificato sulla riga di comando, preceduti dal simbolo di chiocciola (@). Ogni riga nel file di risposta deve contenere un solo parametro o nome di assembly.

Per altre informazioni su .NET Security Annotator, vedere il post Using SecAnnotate to Analyze Your Assemblies for Transparency Violations (Uso di SecAnnotate per analizzare gli assembly con lo scopo di identificare violazioni di trasparenza) nel blog .NET Security.

Esempi