Add remark about getting the thumbprint using a different algorithm

dotnet / dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)

https://docs.microsoft.com/dotnet/api/

Other

725 stars 1.56k forks source link

Add remark about getting the thumbprint using a different algorithm #10526

Closed vcsjones closed 3 weeks ago

vcsjones commented 3 weeks ago

Summary

The Thumbprint property on X509Certificate2 always uses SHA-1 as the hash algorithm. I added a remark to the property indicating that to get the thumbprint using a different algorithm, such as SHA-256, they should use GetCertHashString. It is not always obvious to some people that the thumbprint of the cert and its hash are the same thing.

dotnet-policy-service[bot] commented 3 weeks ago

Tagging subscribers to this area: @dotnet/area-system-security, @vcsjones

learn-build-service-prod[bot] commented 3 weeks ago

Learn Build status updates of commit bb8b050:

:white_check_mark: Validation status: passed

File	Status	Preview URL	Details
xml/System.Security.Cryptography.X509Certificates/X509Certificate2.xml	:white_check_mark:Succeeded	View

For more details, please refer to the build report.

For any questions, please:

Try searching the learn.microsoft.com contributor guides
Post your question in the Learn support channel