Compartilhar via

Classe TrustLevel

  • Artigo

Configura um nível de confiança para aplicativos Web em um servidor Web.

Sintaxe

class TrustLevel : CollectionElement

Métodos

Essa classe não contém métodos.

Propriedades

A tabela a seguir lista as propriedades expostas pela classe TrustLevel.

Nome Descrição
Name Um valor string somente leitura obrigatório que especifica um nível de segurança nomeado que é mapeado para um arquivo de política. Os valores possíveis estão listados posteriormente na seção Comentários. A propriedade de chave.
PolicyFile Um valor string de leitura/gravação obrigatório que especifica um arquivo de configuração que contém configurações de política de segurança para o nível de segurança especificado na propriedade Name. O padrão é "interno".

O arquivo de política deve estar localizado no mesmo diretório que o arquivo Web.config no nível do computador. Por padrão, esse diretório é %windir%\Microsoft.NET\Framework\{versão}\Config.

Você pode aplicar o arquivo da política de segurança a um aplicativo ASP.NET especificando o nome de nível de confiança na propriedade Level da classe TrustSection.

Subclasses

Essa classe não contém subclasses.

Comentários

As instâncias dessa classe estão contidas na propriedade SecurityPolicy da classe SecurityPolicySection.

Você pode estabelecer a política de segurança para todos os aplicativos Web no servidor definindo o nível de confiança. Como os níveis de confiança só podem ser definidos no nível do computador, os arquivos de configuração devem definir os níveis no diretório de configuração no nível do computador. Por padrão, esse diretório é %windir%\Microsoft.NET\Framework\{versão}\Config.

Você pode criar uma política personalizada mapeando um elemento <trustLevel> nomeado no arquivo Web.config no nível do computador para um arquivo de configuração de política personalizada. O arquivo de configuração de política personalizada também deve residir no diretório de configuração no nível do computador.

A tabela a seguir lista os possíveis valores da propriedade Name. O padrão é "Full". Para obter uma explicação sobre as permissões de cada nível de confiança, confira a classe TrustSection.

Valor Descrição
"Full" Especifica que o ASP.NET não restringe a política de segurança com uma política específica de domínio de aplicativo. Não há nenhum arquivo de política de segurança associado a Full. Por padrão, esse valor de nível de confiança é mapeado para "interno" na propriedade PolicyFile. Observação: como o ASP.NET trata a confiança total como um caso especial, a confiança total não tem um arquivo de política associado. Se Total estiver definido, o host do ASP.NET não adicionará nenhuma política extra no nível de domínio ao aplicativo. O nível de confiança total é sempre mapeado para um manipulador interno e a propriedade PolicyFile é ignorada.
"High" Especifica um alto nível de segurança para mapeamento de arquivos de política. Por padrão, esse valor de nível de confiança é mapeado para o arquivo de política Web_hightrust.config.
"Medium" Especifica um nível médio de segurança para mapeamento de arquivos de política. Por padrão, esse valor de nível de confiança é mapeado para o arquivo de política Web_mediumtrust.config.
"Low" Especifica um baixo nível de segurança para mapeamento de arquivos de política. Por padrão, esse valor de nível de confiança é mapeado para o arquivo de política Web_lowtrust.config.
"Minimal" Especifica um nível mínimo de segurança para mapeamento de arquivos de política. Por padrão, esse valor de nível de confiança é mapeado para o arquivo de política Web_minimaltrust.config.
"User Defined" Especifica o nome de um nível de confiança definido pelo usuário. Para obter mais informações, confira Administrar Política de Segurança.

Exemplo

O exemplo a seguir exibe os nomes de nível de confiança e os arquivos de configuração de política de segurança correspondentes especificados no arquivo Web.config no nível do computador.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the security policy section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "SecurityPolicySection", oSection  
  
' Display the path and location.  
WScript.Echo "Path: " & oSection.Path   
WScript.Echo "Location: " & oSection.Location  
WScript.Echo  
  
' Display the security level names and their policy files.  
For Each oTrustLevel In oSection.SecurityPolicy  
    WScript.Echo "Security level: " & oTrustLevel.Name  
    WScript.Echo "   Policy file: " & oTrustLevel.PolicyFile  
    WScript.Echo   
Next

Hierarquia de herança

CollectionElement

TrustLevel

Requisitos

Tipo Descrição
Cliente – IIS 7.0 no Windows Vista
– IIS 7.5 no Windows 7
– IIS 8.0 no Windows 8
– IIS 10.0 no Windows 10
Servidor – IIS 7.0 no Windows Server 2008
– IIS 7.5 no Windows Server 2008 R2
– IIS 8.0 no Windows Server 2012
– IIS 8.5 no Windows Server 2012 R2
– IIS 10.0 no Windows Server 2016
Product – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF WebAdministration.mof

Confira também

System.Web.Configuration.TrustLevelAdministrar a Política de Segurança
Níveis de confiança e arquivos de política do ASP.NET
Classe CollectionElement
Classe SecurityPolicySection
Elemento trustLevel para securityPolicy (esquema de configurações ASP.NET)