CA2210: Assemblies should have valid strong names
Applies to: Visual Studio Visual Studio for Mac
Note
This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
Item | Value |
---|---|
RuleId | CA2210 |
Category | Microsoft.Design |
Breaking change | Non-breaking |
Cause
An assembly is not signed with a strong name, the strong name could not be verified, or the strong name would not be valid without the current registry settings of the computer.
Note
This rule has been deprecated. For more information, see Deprecated rules.
Rule description
This rule retrieves and verifies the strong name of an assembly. A violation occurs if any of the following are true:
The assembly does not have a strong name.
The assembly was altered after signing.
The assembly is delay-signed.
The assembly was incorrectly signed, or signing failed.
The assembly requires registry settings to pass verification. For example, the Strong Name tool (Sn.exe) was used to skip verification for the assembly.
The strong name protects clients from unknowingly loading an assembly that has been tampered with. Assemblies without strong names should not be deployed outside very limited scenarios. If you share or distribute assemblies that are not correctly signed, the assembly can be tampered with, the common language runtime might not load the assembly, or the user might have to disable verification on his or her computer. An assembly without a strong name has from the following drawbacks:
Its origins cannot be verified.
The common language runtime cannot warn users if the contents of the assembly have been altered.
It cannot be loaded into the global assembly cache.
Note that to load and analyze a delay-signed assembly, you must disable verification for the assembly.
How to fix violations
Create a key file
Use one of the following procedures:
Use the Assembly Linker tool (Al.exe).
For the .NET Framework 2.0, use either the
/keyfile
or/keycontainer
compiler option /KEYFILE (Specify Key or Key Pair to Sign an Assembly) or /KEYCONTAINER (Specify a Key Container to Sign an Assembly) linker option in C++).For the .NET Framework v1.0 or v1.1, use either the System.Reflection.AssemblyKeyFileAttribute or System.Reflection.AssemblyKeyNameAttribute attribute.
Sign your assembly with a strong name in Visual Studio
In Visual Studio, open your solution.
In Solution Explorer, right-click your project and then click Properties.
Click the Signing tab, and select the Sign the assembly check box.
From Choose a strong name key file, select New.
The Create Strong Name Key window will display.
In Key file name, type a name for your strong name key.
Choose whether to protect the key with a password, and then click OK.
In Solution Explorer, right-click your project and then click Build.
Sign your assembly with a strong name outside Visual Studio
Use the Strong name tool (Sn.exe).
When to suppress warnings
Only suppress a warning from this rule if the assembly is used in an environment where tampering with the contents is not a concern.