dotnet / dotnet/dotnet-api-docs

Where is the documentation for System.IdentityModel.Tokens.Jwt?

Open
#3,259 26 comments 11 reactions 0 assignees View on GitHub
.net/svc area-WCF external Pri2 waiting-on-feedback
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

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.