SecAnnotate.exe (ferramenta Anotador de Segurança do .NET)

  • Artigo

A ferramenta Anotador de Segurança do .NET (SecAnnotate.exe) é um aplicativo de linha de comando que identifica as partes SecurityCritical e SecuritySafeCritical de um ou mais assemblies.

Uma extensão do Visual Studio, Anotador de Segurança, fornece uma interface gráfica do usuário para SecAnnotate.exe e permite executar a ferramenta no Visual Studio.

Essa ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, use o Prompt de Comando do Desenvolvedor do Visual Studio ou o PowerShell do Desenvolvedor do Visual Studio.

No prompt de comando, digite o seguinte, em que parameters são descritos na seção a seguir e assemblies consistem em um ou mais nomes de assembly separados por espaços em branco:

Sintaxe

SecAnnotate.exe [parameters] [assemblies]

parâmetros

Opção Descrição
/a

ou

/showstatistics		 Mostra estatísticas sobre o uso de transparência em assemblies que estão sendo analisados.
/d:directory

ou

/referencedir:directory		 Especifica um diretório para procura assemblies dependentes durante a anotação.
/i

ou

/includesignatures		 Inclui informações de assinatura estendidas no arquivo de relatório da anotação.
/n

ou

/nogac		 Suprime a procura de assemblies referenciados no cache de assembly global.
/o:output.xml

ou

/out:output.xml		 Especifica o arquivo de anotação de saída.
/p:maxpasses

ou

/maximumpasses:maxpasses		 Especifica o número máximo de passagens de anotação que serão feitas em assemblies antes de parar a geração de novas anotações.
/q

ou

/quiet		 Especifica o modo silencioso, no qual o anotador não produz mensagens de status; ele produz apenas informações de erro.
/r:assembly

ou

/referenceassembly:assembly		 Inclui o assembly especificado durante a resolução de assemblies dependentes durante a anotação. Os assemblies de referência recebem prioridade sobre assemblies encontrados no caminho de referência.
/s:rulename

ou

/suppressrule:rulename		 Suprime a execução da regra de transparência especificada em assemblies de entrada.
/t

ou

/forcetransparent		 Força a ferramenta Anotador a tratar todos os assemblies sem anotações de transparência como se fossem totalmente transparentes.
/t:assembly

ou

/forcetransparent:assembly		 Force o assembly indicado para ser transparente, independentemente das anotações no nível de assembly atuais.
/v

ou

/verify		 Verifica apenas se as anotações de um assembly estão corretas; não tenta fazer várias passagens para encontrar todas as anotações obrigatórias se o assembly não verificar.
/x

ou

/verbose		 Especifica a saída detalhada durante a anotação.
/y:directory

ou

/symbolpath:directory		 Inclui o diretório especificado durante a procura de arquivos de símbolo durante a anotação.

Comentários

Os parâmetros e os assemblies também podem ser fornecidos em um arquivo de resposta especificado na linha de comando e prefixado com uma arroba (@). Cada linha no arquivo de resposta deve conter um único parâmetro ou nome de assembly.

Para obter mais informações sobre o Anotador de Segurança do .NET, consulte a entrada Using SecAnnotate to Analyze Your Assemblies for Transparency Violations (Usando o SecAnnotate para analisar os assemblies quanto a violações de transparência) no .NET Security Blog.

Exemplos