dotnet / dotnet/dotnet-api-docs
Where is the documentation for System.IdentityModel.Tokens.Jwt?
- Dominant language
- C#
- Stars
- 949
- Forks
- 1.7k
- Avg merge
- 3d 27m
- Merged PRs (30d)
- 49
Description
With Windows Identity Foundation (WIF) now integrated into .NET and the `System.IdentityModel.Tokens.Jwt` NuGet package getting 8,000+ downloads every day, I don't understand why there isn't any official documentation. The [MSDN documentation is disgraceful](https://msdn.microsoft.com/en-us/library/system.identitymodel.tokens.jwtsecuritytoken(v=vs.114).aspx), offering nothing that IntelliSense doesn't already communicate, [what little you have on Microsoft Docs](https://docs.microsoft.com/en-us/dotnet/framework/security/json-web-token-handler) offers no instructions, and [the official GitHub repo](https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet) for the NuGet package is a confusing mess that feels like trying to crack a walnut with a sledgehammer when trying to sift through the many projects just to find a simple, no-frills example.
For example, take a standard and common use case of needing to encrypt a JWT payload. The only usable solution I could find is [this Stack Overflow post](https://stackoverflow.com/questions/18223868/how-to-encrypt-jwt-security-token/44195678#44195678), and even that uses a hodgepodge of WIF 3.5 and .NET 4+ namespaces that feels more like a hack than a good solution.
JWTs are the standard now, and Microsoft Docs desperately needs dedicated documentation for developers on this topic. Please let us know what the plan is for this.
- Thanks
---
#### Document Details
⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*
* ID: 06bdbd36-1298-419e-9ae8-e3582e804ced
* Version Independent ID: be11dcde-c28b-d40c-08c0-bc4d504c6df9
* Content: [System.IdentityModel Namespace](https://docs.microsoft.com/en-us/dotnet/api/system.identitymodel?view=netframework-4.7.2)
* Content Source: [xml/ns-System.IdentityModel.xml](https://github.com/dotnet/dotnet-api-docs/blob/master/xml/ns-System.IdentityModel.xml)
* Service: **.net**
* GitHub Login: @dotnet-bot
* Microsoft Alias: **v-jibran**
Contributor guide
Assessment
This issue has not been assessed yet.