Skip to content

Commit addae3b

Browse files
JamesNKRon Petrusha
authored andcommitted
Add additional info about when to make strong naming key public (dotnet#8414)
* Add additional info about when to make strong naming key public * PR feedback * PR feedback * PR feedback * PR feedback * Remove private to be consistent with how the key is refered to
1 parent 82947e1 commit addae3b

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

docs/standard/library-guidance/strong-naming.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,12 +43,14 @@ You should strong name your open-source .NET libraries. Strong naming an assembl
4343
4444
**✔️ CONSIDER** strong naming your library's assemblies.
4545

46-
**✔️ CONSIDER** checking in the key used to strong name into your source control system.
46+
**✔️ CONSIDER** adding the strong naming key to your source control system.
4747

4848
> A publicly available key lets developers modify and recompile your library source code with the same key.
49+
>
50+
> You shouldn't make the strong naming key public if it has been used in the past to give special permissions in [partial-trust scenarios](/dotnet/framework/misc/using-libraries-from-partially-trusted-code). Otherwise, you might compromise existing environments.
4951
5052
> [!IMPORTANT]
51-
> When a cryptographic identity is desired, [Authenticode](/windows-hardware/drivers/install/authenticode) and [NuGet Package Signing](/nuget/create-packages/sign-a-package) are recommended. Strong naming should not be used for security considerations.
53+
> When the identity of the publisher of the code is desired, [Authenticode](/windows-hardware/drivers/install/authenticode) and [NuGet Package Signing](/nuget/create-packages/sign-a-package) are recommended. Code Access Security (CAS) should not be used as a security mitigation.
5254
5355
**✔️ CONSIDER** incrementing the assembly version on only major version changes to help users reduce binding redirects, and how often they're updated.
5456

0 commit comments

Comments
 (0)