Share via


CA2210: Assemblies should have valid strong names

Applies to: yesVisual Studio noVisual 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:

Sign your assembly with a strong name in Visual Studio

  1. In Visual Studio, open your solution.

  2. In Solution Explorer, right-click your project and then click Properties.

  3. Click the Signing tab, and select the Sign the assembly check box.

  4. From Choose a strong name key file, select New.

    The Create Strong Name Key window will display.

  5. In Key file name, type a name for your strong name key.

  6. Choose whether to protect the key with a password, and then click OK.

  7. 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.

See also