# azuread/azure-activedirectory-identitymodel-extensions-for-dotnet architecture

> Architecture diagram of the GitHub repository azuread/azure-activedirectory-identitymodel-extensions-for-dotnet, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet
- Repository: https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet

## Overview

IdentityModel Extensions for .NET is a set of authentication and authorization libraries, not a single hosted application. Its principal workflow is to obtain identity-provider metadata, parse and validate a presented token using configured validation rules and keys, and expose the resulting identity to a .NET application. The repository also supports token creation, multiple token formats and federation protocols, proof-of-possession mechanisms, and shared logging. The tree and README establish these product areas; some implementation relationships are shown only by the source index, so uncertain connections are omitted.

Main entry points: [`src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs`](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs) (JWT handler), [`src/Microsoft.IdentityModel.Protocols/Configuration/ConfigurationManager.cs`](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols/Configuration/ConfigurationManager.cs) (Configuration manager), [`src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs`](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs) (JWT creation), [`src/Microsoft.IdentityModel.Tokens/TokenValidationParameters.cs`](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/TokenValidationParameters.cs) (Validation settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tokens["Token processing"]
  node_jwt_handler["JWT handler"]
  node_jwt_model["JWT model<br/>[JsonWebToken.cs]"]
  node_jwt_create["JWT creation"]
  node_jwt_utils["JWT utilities"]
  node_token_base["Handler base<br/>[TokenHandler.cs]"]
  node_validation_params["Validation settings"]
  node_validators["Token validators<br/>[Validators.cs]"]
  node_crypto["Crypto providers"]
  node_encryption["Authenticated encryption"]
  node_legacy_jwt["JWT compatibility"]
  node_saml1["SAML handler"]
  node_saml2["SAML 2 handler"]
end

subgraph group_protocols["Identity protocols"]
  node_oidc["OpenID Connect"]
  node_oidc_config["OIDC metadata"]
  node_wsfed["WS-Federation"]
  node_wstrust["WS-Trust"]
end

subgraph group_proof["Proof of possession"]
  node_signed_http["Signed HTTP requests"]
  node_dpop["DPoP validation"]
end

subgraph group_config["Configuration"]
  node_config_manager["Configuration manager"]
  node_http_retriever["HTTP document retrieval"]
end

subgraph group_shared["Shared services"]
  node_logger["Logging<br/>[LogHelper.cs]"]
end

node_app(("Application"))

node_app -->|"validates tokens"| node_jwt_handler
node_jwt_handler -.->|"reads token"| node_jwt_model
node_jwt_handler -->|"uses utilities"| node_jwt_utils
node_jwt_handler -.->|"accepts settings"| node_validation_params
node_jwt_handler -->|"gets configuration"| node_config_manager
node_jwt_create -->|"uses handler"| node_jwt_handler
node_jwt_create -->|"uses utilities"| node_jwt_utils
node_token_base -->|"base class"| node_jwt_handler
node_validation_params -.->|"configures checks"| node_validators
node_jwt_handler -.->|"validates claims"| node_validators
node_crypto -.->|"provides crypto"| node_encryption
node_app -->|"uses JWT compatibility"| node_legacy_jwt
node_app -->|"validates SAML"| node_saml1
node_app -->|"validates SAML 2"| node_saml2
node_app -->|"uses OIDC"| node_oidc
node_oidc -.->|"uses metadata"| node_oidc_config
node_app -->|"uses federation"| node_wsfed
node_app -->|"uses federation"| node_wstrust
node_app -.->|"creates or validates"| node_signed_http
node_app -.->|"validates DPoP"| node_dpop
node_config_manager -->|"retrieves documents"| node_http_retriever
node_jwt_handler -.->|"logs events"| node_logger
node_config_manager -->|"logs events"| node_logger

click node_jwt_handler "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs"
click node_jwt_model "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebToken.cs"
click node_jwt_create "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs"
click node_jwt_utils "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JwtTokenUtilities.cs"
click node_token_base "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/TokenHandler.cs"
click node_validation_params "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/TokenValidationParameters.cs"
click node_validators "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/Validators.cs"
click node_crypto "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/CryptoProviderFactory.cs"
click node_encryption "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/Encryption/AuthenticatedEncryptionProvider.cs"
click node_legacy_jwt "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/System.IdentityModel.Tokens.Jwt/JwtSecurityTokenHandler.cs"
click node_saml1 "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens.Saml/Saml/SamlSecurityTokenHandler.cs"
click node_saml2 "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens.Saml/Saml2/Saml2SecurityTokenHandler.cs"
click node_oidc "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectProtocolValidator.cs"
click node_oidc_config "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/Configuration/OpenIdConnectConfigurationRetriever.cs"
click node_wsfed "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.WsFederation/WsFederationMessage.cs"
click node_wstrust "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.WsTrust/WsTrustSerializer.cs"
click node_signed_http "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.SignedHttpRequest/SignedHttpRequestHandler.cs"
click node_dpop "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Dpop/DpopProofValidator.cs"
click node_config_manager "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols/Configuration/ConfigurationManager.cs"
click node_http_retriever "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols/Configuration/HttpDocumentRetriever.cs"
click node_logger "https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Logging/LogHelper.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_jwt_handler,node_jwt_model,node_jwt_create,node_jwt_utils,node_token_base,node_validation_params,node_validators,node_crypto,node_encryption,node_legacy_jwt,node_saml1,node_saml2 toneBlue
class node_oidc,node_oidc_config,node_wsfed,node_wstrust toneAmber
class node_signed_http,node_dpop toneMint
class node_config_manager,node_http_retriever toneRose
class node_logger,node_app toneIndigo
```

## Components

### Token processing

- [JWT handler](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs): `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs`
- [JWT model](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebToken.cs): `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebToken.cs`
- [JWT creation](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs): `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs`
- [JWT utilities](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.JsonWebTokens/JwtTokenUtilities.cs): `src/Microsoft.IdentityModel.JsonWebTokens/JwtTokenUtilities.cs`
- [Handler base](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/TokenHandler.cs): `src/Microsoft.IdentityModel.Tokens/TokenHandler.cs`
- [Validation settings](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/TokenValidationParameters.cs): `src/Microsoft.IdentityModel.Tokens/TokenValidationParameters.cs`
- [Token validators](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/Validators.cs): `src/Microsoft.IdentityModel.Tokens/Validators.cs`
- [Crypto providers](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/CryptoProviderFactory.cs): `src/Microsoft.IdentityModel.Tokens/CryptoProviderFactory.cs`
- [Authenticated encryption](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens/Encryption/AuthenticatedEncryptionProvider.cs): `src/Microsoft.IdentityModel.Tokens/Encryption/AuthenticatedEncryptionProvider.cs`
- [JWT compatibility](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/System.IdentityModel.Tokens.Jwt/JwtSecurityTokenHandler.cs): `src/System.IdentityModel.Tokens.Jwt/JwtSecurityTokenHandler.cs`
- [SAML handler](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens.Saml/Saml/SamlSecurityTokenHandler.cs): `src/Microsoft.IdentityModel.Tokens.Saml/Saml/SamlSecurityTokenHandler.cs`
- [SAML 2 handler](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Tokens.Saml/Saml2/Saml2SecurityTokenHandler.cs): `src/Microsoft.IdentityModel.Tokens.Saml/Saml2/Saml2SecurityTokenHandler.cs`

### Identity protocols

- [OpenID Connect](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectProtocolValidator.cs): `src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectProtocolValidator.cs`
- [OIDC metadata](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/Configuration/OpenIdConnectConfigurationRetriever.cs): `src/Microsoft.IdentityModel.Protocols.OpenIdConnect/Configuration/OpenIdConnectConfigurationRetriever.cs`
- [WS-Federation](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.WsFederation/WsFederationMessage.cs): `src/Microsoft.IdentityModel.Protocols.WsFederation/WsFederationMessage.cs`
- [WS-Trust](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.WsTrust/WsTrustSerializer.cs): `src/Microsoft.IdentityModel.Protocols.WsTrust/WsTrustSerializer.cs`

### Proof of possession

- [Signed HTTP requests](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols.SignedHttpRequest/SignedHttpRequestHandler.cs): `src/Microsoft.IdentityModel.Protocols.SignedHttpRequest/SignedHttpRequestHandler.cs`
- [DPoP validation](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Dpop/DpopProofValidator.cs): `src/Microsoft.IdentityModel.Dpop/DpopProofValidator.cs`

### Configuration

- [Configuration manager](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols/Configuration/ConfigurationManager.cs): `src/Microsoft.IdentityModel.Protocols/Configuration/ConfigurationManager.cs`
- [HTTP document retrieval](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Protocols/Configuration/HttpDocumentRetriever.cs): `src/Microsoft.IdentityModel.Protocols/Configuration/HttpDocumentRetriever.cs`

### Shared services

- [Logging](https://github.com/azuread/azure-activedirectory-identitymodel-extensions-for-dotnet/blob/dev/src/Microsoft.IdentityModel.Logging/LogHelper.cs): `src/Microsoft.IdentityModel.Logging/LogHelper.cs`

### Other components

- **Application**

## Connections

- Application → JWT handler: validates tokens (evidence: `README.md`)
- JWT handler → JWT model: reads token (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs`)
- JWT handler → JWT utilities: uses utilities (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs`)
- JWT handler → Validation settings: accepts settings (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs`)
- JWT handler → Configuration manager: gets configuration (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs`)
- JWT creation → JWT handler: uses handler (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs`)
- JWT creation → JWT utilities: uses utilities (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs`)
- Handler base → JWT handler: base class (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs`)
- Validation settings → Token validators: configures checks (evidence: `src/Microsoft.IdentityModel.Tokens/Validators.cs`)
- JWT handler → Token validators: validates claims
- Crypto providers → Authenticated encryption: provides crypto (evidence: `src/Microsoft.IdentityModel.Tokens/CryptoProviderFactory.cs`)
- Application → JWT compatibility: uses JWT compatibility (evidence: `README.md`)
- Application → SAML handler: validates SAML (evidence: `README.md`)
- Application → SAML 2 handler: validates SAML 2 (evidence: `README.md`)
- Application → OpenID Connect: uses OIDC (evidence: `README.md`)
- OpenID Connect → OIDC metadata: uses metadata
- Application → WS-Federation: uses federation (evidence: `README.md`)
- Application → WS-Trust: uses federation (evidence: `README.md`)
- Application → Signed HTTP requests: creates or validates
- Application → DPoP validation: validates DPoP
- Configuration manager → HTTP document retrieval: retrieves documents (evidence: `src/Microsoft.IdentityModel.Protocols/Configuration/ConfigurationManager.cs`)
- JWT handler → Logging: logs events (evidence: `src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.cs`)
- Configuration manager → Logging: logs events (evidence: `src/Microsoft.IdentityModel.Protocols/Configuration/ConfigurationManager.cs`)
