dotnet / dotnet/dotnet-api-docs

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

Aperta
#3,259 26 commenti 11 reazioni 0 assegnatari Vedi su GitHub
.net/svc area-WCF external Pri2 waiting-on-feedback
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

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.