SYSLIB0053: AesGcm は必要なタグ サイズを示す必要があります

  • [アーティクル]

タグ サイズを受け入れない AesGcm コンストラクターは、.NET 8 以降では廃止されています。

これらをコードで呼び出すと、コンパイル時に警告 SYSLIB0053 が生成されます。

廃止の理由

AES-GCM では、プラットフォームに応じて、12 バイトから 16 バイトまでのさまざまな長さのタグがサポートされています。 以前は、AesGcm クラスはタグ自体のサイズに基づいて目的のタグ サイズを決定していました。 たとえば、Decrypt が 14 バイトのタグで呼び出された場合、タグは 14 バイトであることが想定されていました。

しかし、AES-GCM は、これらのさまざまな長さを切り捨てによってサポートしています。 AES-GCM はネイティブに 16 バイトのタグを生成し、それより短いタグはタグを切り捨てることによって生成されます。

Decrypt() の呼び出し元が入力からタグを取得し、タグをそのまま渡すと、Decrypt() が可能な限り短いタグで使用されることを実質的に許可するので、タグの有効サイズが小さくなります。

コンシューマーが自分が正しいサイズのタグを使用していることを確認できるように、予想されるタグのサイズを事前に宣言する必要がある AesGcm の新しいコンストラクターが導入されました。 Encrypt() または Decrypt() の間、指定されるタグ パラメーターはコンストラクターで宣言されたサイズと一致する必要があります。

回避策

タグ サイズを受け入れる新しいコンストラクターが .NET 8 で追加されました。 代わりに、次のいずれかのコンストラクターを使用します。

警告を抑制する

古い API を使う必要がある場合は、コードまたはプロジェクト ファイルで警告を抑制することができます。

単一の違反だけを抑制するには、ソース ファイルにプリプロセッサ ディレクティブを追加して警告を無効にしてから、再度有効にします。

// Disable the warning.
#pragma warning disable SYSLIB0053

// Code that uses obsolete API.
// ...

// Re-enable the warning.
#pragma warning restore SYSLIB0053

プロジェクトですべての SYSLIB0053 警告を抑制するには、プロジェクト ファイルに <NoWarn> プロパティを追加します。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
   ...
   <NoWarn>$(NoWarn);SYSLIB0053</NoWarn>
  </PropertyGroup>
</Project>

詳細については、「警告を表示しない」を参照してください。