dotnet / dotnet/dotnet-api-docs

Please provide CipherMode availability matrix

Open
#3,597 3 comments 0 reactions 0 assignees View on GitHub
area-System.Security Pri3 untriaged
Dominant language
C#
Stars
949
Forks
1.7k
Avg merge
3d 27m
Merged PRs (30d)
49

Description

https://docs.microsoft.com/en-us/dotnet/api/system.security.cryptography.ciphermode?view=netcore-2.0

The current documentation does not show which cipher modes are supported by a certain algorithm on different platforms. One question I have is that "on which platforms is AES CFB mode fully supported?", that no existing documentation can tell.

Library authors and users are forced to rely on `CryptographicException` as stated, which is clearly inconvenient.

https://docs.microsoft.com/en-us/dotnet/api/system.security.cryptography.symmetricalgorithm.mode?view=netcore-2.0#System_Security_Cryptography_SymmetricAlgorithm_Mode

I know it is not easy to build a matrix in documentation, as there are multiple platforms, multiple algorithms and cipher modes to check. But I guess your test suite should cover the same things, so the information is already somewhere.

Only if you provide it, library authors and end users can then save tons of hours testing on their own.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.