dotnet / dotnet/dotnet-api-docs
Where is the documentation for System.IdentityModel.Tokens.Jwt?
- Lingua principale
- C#
- Stelle
- 949
- Fork
- 1.7k
- Merge medio
- 2g 19h
- PR unite (30g)
- 52
Descrizione
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**
Guida per i contributori
Apri la guida per i contributori
Direzione di ricerca
La fonte documentata è xml/ns-System.IdentityModel.xml; inizia esaminando questo riferimento API e la pagina Microsoft Docs collegata sui JWT. Definisci l'ambito di una guida dedicata agli sviluppatori, incluso un esempio standard di crittografia JWT, e considera completato il lavoro quando le istruzioni richieste saranno disponibili nella documentazione ufficiale.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- csharp
- Ambito
- documentation
- Tipo di issue
- Documentazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Stato di attività
- Ferma
- Chiarezza
- Da chiarire
- Idoneità per principianti
- 25/100