大多數程式碼存取安全性 API 已淘汰

  • 發行項

.NET 中的大多數程式碼存取安全性 (CAS) 相關類型現已淘汰為警告。 這包括 SecurityPermissionAttribute 在內的 CAS 屬性、包括 SocketPermission、EvidenceBase 在內的 CAS 權限物件、衍生類型，以及其他支援的 API。

變更描述

在 .NET Framework 2.x - 4.x 中，CAS 屬性和 API 可能會影響程式碼執行過程，包括確保 CAS 需求堆疊查核行程成功或失敗。

// 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
}

在 .NET Core 2.x - 3.x 中，執行階段不接受 CAS 屬性或 CAS API。 執行階段會忽略方法項目上的屬性，而且大多數的程式設計 API 都沒有效果。

// 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
}

此外，對擴充 API (Assert) 進行的程式設計呼叫一律會成功，但對限制性 API (Deny、PermitOnly) 進行的程式設計呼叫一律會在執行階段擲回例外狀況。 (PrincipalPermission 是此規則的例外狀況。請參閱下方 建議的動作 一節。)

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

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

在 .NET 5 和更新版本中，大多數與 CAS 相關的 API 已淘汰，而且會產生編譯時期警告 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
}

此變更僅限編譯時期。 舊版 .NET Core 沒有執行階段變更。 .NET Core 2.x - 3.x 中不會執行任何作業的方法，在 .NET 5 和更新版本中一樣不會在執行階段執行任何作業。 在 .NET Core 2.x - 3.x 中擲回 PlatformNotSupportedException 的方法，在 .NET 5 和更新版本中一樣會繼續在執行階段擲回 PlatformNotSupportedException。

變更原因

程式碼存取安全性 (CAS) 是不受支援的舊版技術。 啟用 CAS 的基礎結構僅存在於 .NET Framework 2.x - 4.x 中，但已淘汰而且不會接收服務或安全性修正程式。

由於 CAS 已被取代， 支援基礎結構並未轉送至 .NET Core 或 .NET 5+。 不過，因為我們有向前提出 API，所以應用程式可以對 .NET Framwork 和 .NET Core 進行交叉編譯。 這會導致發生「失敗開啟」的案例，其中雖然存在一些可呼叫的 CAS 相關 API，但在執行階段不會執行任何動作。 對於預期執行階段接受 CAS 相關屬性或程式設計 API 呼叫的元件而言，這可能會導致安全性問題。 為了更好地傳達執行階段不會使用這些屬性或 API，我們在 .NET 5.0 中已將大多數項目淘汰。

導入的版本

5.0

  • 如果您要判斷提示任何安全性權限，請移除判斷提示權限的屬性或呼叫。

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

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

  • 如果您要拒絕或限制任何權限 (透過 PermitOnly)，請連絡安全顧問。 由於 .NET 5+ 執行階段不接受 CAS 屬性，因此，如果應用程式不正確地依賴 CAS 基礎結構以限制對這些方法的存取，可能會出現安全性漏洞。

    // 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();
}

  • 如果您需要任何權限 (PrincipalPermission 除外)，請移除需求。 所有需求在執行階段都會成功。

    // 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();
}

  • 如果您需要 PrincipalPermission，請參閱 PrincipalPermissionAttribute 已淘汰為錯誤的指引。 PrincipalPermission 和 PrincipalPermissionAttribute 均適用該指引。

  • 如果您確實必須停用這些警告 (不建議)，可以在程式碼中隱藏 SYSLIB0003 警告。

    #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
}

    您也可以在專案檔中隱藏警告。 這麼做會停用專案中所有來源檔案的警告。

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

    注意

    隱藏 SYSLIB0003 只會停用 CAS 相關的淘汰警告。 這不會停用任何其他警告，也不會變更 .NET 5+ 執行階段的行為。

  • 安全性

受影響的 API