Partilhar via

A maioria das APIs de segurança de acesso ao código está obsoleta

A maioria dos tipos relacionados à segurança de acesso ao código (CAS) no .NET agora estão obsoletos como aviso. Isso inclui atributos CAS, como SecurityPermissionAttribute, objetos de permissão CAS, como SocketPermission, EvidenceBasetipos derivados e outras APIs de suporte.

Alterar descrição

No .NET Framework 2.x - 4.x, os atributos e APIs do CAS podem influenciar o curso da execução do código, incluindo garantir que as verificações de pilha solicitadas pelo CAS sejam bem-sucedidas ou falhem.

// In .NET Framework, the attribute causes CAS stack walks
// to terminate successfully when this permission is demanded.
[SocketPermission(SecurityAction.Assert, Host = "contoso.com", Port = "443")]
public void DoSomething()
{
    // open a socket to contoso.com:443
}

No .NET Core 2.x - 3.x, o tempo de execução não suporta atributos CAS ou APIs CAS. O tempo de execução ignora atributos na entrada do método, e a maioria das APIs programáticas não tem efeito.

// The .NET Core runtime ignores the following attribute.
[SocketPermission(SecurityAction.Assert, Host = "contoso.com", Port = "443")]
public void DoSomething()
{
    // open a socket to contoso.com:443
}

Além disso, chamadas programáticas para APIs expansivas (Assert) sempre bem-sucedidas, enquanto chamadas programáticas para APIs restritivas (Deny, PermitOnly) lançam sempre uma exceção em tempo de execução. PrincipalPermission( é uma exceção a esta regra. Consulte a secção Ação recomendada abaixo.)

public void DoAssert()
{
    // The line below has no effect at runtime.
    new SocketPermission(PermissionState.Unrestricted).Assert();
}

public void DoDeny()
{
    // The line below throws PlatformNotSupportedException at runtime.
    new SocketPermission(PermissionState.Unrestricted).Deny();
}

No .NET 5 e versões posteriores, a maioria das APIs relacionadas ao CAS são obsoletas e produzem aviso em tempo de compilação SYSLIB0003.

[SocketPermission(SecurityAction.Assert, Host = "contoso.com", Port = "443")] // warning SYSLIB0003
public void DoSomething()
{
    new SocketPermission(PermissionState.Unrestricted).Assert(); // warning SYSLIB0003
    new SocketPermission(PermissionState.Unrestricted).Deny(); // warning SYSLIB0003
}

Esta é uma alteração apenas em tempo de compilação. Não há qualquer alteração em tempo de execução em relação às versões anteriores do .NET Core. Métodos que não realizam nenhuma operação em .NET Core 2.x - 3.x continuarão a não realizar nenhuma operação em tempo de execução em .NET 5 e posteriores. Os métodos que lançam PlatformNotSupportedException em .NET Core 2.x - 3.x continuarão a lançar PlatformNotSupportedException em tempo de execução no .NET 5 e posteriores.

Motivo da mudança

A segurança de acesso ao código (CAS) é uma tecnologia herdada sem suporte. A infraestrutura para habilitar o CAS existe apenas no .NET Framework 2.x - 4.x, mas foi preterida e não está recebendo correções de manutenção ou segurança.

Devido à descontinuação do CAS, a infraestrutura de suporte não foi levada para o .NET Core ou .NET 5+. No entanto, as APIs foram apresentadas para que as aplicações pudessem ser compiladas entre diferentes plataformas, incluindo o .NET Framework e o .NET Core. Isto levou a cenários de "falha aberta", onde algumas APIs relacionadas com CAS existem e são chamáveis, mas não executam qualquer ação em tempo de execução. Isso pode levar a problemas de segurança para componentes que esperam que o tempo de execução honre atributos relacionados ao CAS ou chamadas de API programáticas. Para comunicar melhor que o tempo de execução não respeita esses atributos ou APIs, tornámos a maioria deles obsoletos no .NET 5.0.

Versão introduzida

5.0

  • Se você estiver afirmando qualquer permissão de segurança, remova o atributo ou chamada que afirma a permissão.

    // REMOVE the attribute below.
[SecurityPermission(SecurityAction.Assert, ControlThread = true)]
public void DoSomething()
{
}

public void DoAssert()
{
    // REMOVE the line below.
    new SecurityPermission(SecurityPermissionFlag.ControlThread).Assert();
}

  • Se você estiver negando ou restringindo (via PermitOnly) qualquer permissão, entre em contato com seu consultor de segurança. Como os atributos CAS não são honrados pelo tempo de execução do .NET 5+, seu aplicativo pode ter uma falha de segurança se depender incorretamente da infraestrutura CAS para restringir o acesso a esses métodos.

    // REVIEW the attribute below; could indicate security vulnerability.
[SecurityPermission(SecurityAction.Deny, ControlThread = true)]
public void DoSomething()
{
}

public void DoPermitOnly()
{
    // REVIEW the line below; could indicate security vulnerability.
    new SecurityPermission(SecurityPermissionFlag.ControlThread).PermitOnly();
}

  • Se você estiver exigindo alguma permissão (exceto PrincipalPermission), remova a demanda. Todas as requisições terão sucesso em tempo de execução.

    // REMOVE the attribute below; it will always succeed.
[SecurityPermission(SecurityAction.Demand, ControlThread = true)]
public void DoSomething()
{
}

public void DoDemand()
{
    // REMOVE the line below; it will always succeed.
    new SecurityPermission(SecurityPermissionFlag.ControlThread).Demand();
}

  • Se você estiver exigindo PrincipalPermission, consulte as orientações para PrincipalPermissionAttribute está obsoleto como erro. Estas orientações aplicam-se tanto a PrincipalPermission como a PrincipalPermissionAttribute.

  • Se você absolutamente deve desativar esses avisos (o que não é recomendado), você pode suprimir o SYSLIB0003 aviso no código.

    #pragma warning disable SYSLIB0003 // disable the warning
[SecurityPermission(SecurityAction.Demand, ControlThread = true)]
#pragma warning restore SYSLIB0003 // re-enable the warning
public void DoSomething()
{
}

public void DoDemand()
{
#pragma warning disable SYSLIB0003 // disable the warning
    new SecurityPermission(SecurityPermissionFlag.ControlThread).Demand();
#pragma warning restore SYSLIB0003 // re-enable the warning
}

    Você também pode suprimir o aviso em seu arquivo de projeto. Isso desativa o aviso para todos os arquivos de origem dentro do projeto.

    <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
    <!-- NoWarn below suppresses SYSLIB0003 project-wide -->
    <NoWarn>$(NoWarn);SYSLIB0003</NoWarn>
  </PropertyGroup>
</Project>

    Observação

    Suprimir SYSLIB0003 desativa apenas os avisos de obsolescência que estão relacionados ao CAS. Ele não desabilita nenhum outro aviso ou altera o comportamento do tempo de execução do .NET 5+.

  • Segurança

APIs afetadas

  • Last updated on