# azure-ad-b2c/samples architecture

> Architecture diagram of the GitHub repository azure-ad-b2c/samples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure-ad-b2c/samples
- Repository: https://github.com/azure-ad-b2c/samples

## Overview

This repository is a catalog of Azure AD B2C custom-policy journey samples, not one application. A representative journey starts with B2C sending claims to a sample REST/API handler, which validates or transforms them, optionally uses an external service or state store, and returns claims or a decision. Other samples provide separate journeys for invitations, profile updates, lockout, MFA and passwordless sign-in. The graph highlights sampled runtime implementations; many policy configurations and other README-listed capabilities are not represented in the provided tree or excerpts.

Main entry points: [`policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Controllers/AuthController.cs`](https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Controllers/AuthController.cs) (Claims-provider UI), [`policies/sign-in-with-magic-link-keyvault/src/Controllers/InvitationController.cs`](https://github.com/azure-ad-b2c/samples/blob/master/policies/sign-in-with-magic-link-keyvault/src/Controllers/InvitationController.cs) (Invitation flow), [`policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/AzureADGraphClient.cs`](https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/AzureADGraphClient.cs) (Graph client), [`policies/signin-signup-typingdna/source-code/TypingDNA-API-Interface/typingDNAInterface/Controllers/tdnaController.cs`](https://github.com/azure-ad-b2c/samples/blob/master/policies/signin-signup-typingdna/source-code/TypingDNA-API-Interface/typingDNAInterface/Controllers/tdnaController.cs) (TypingDNA checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rest["REST Journeys"]
  node_captcha["Captcha handler"]
  node_captcha_response["Claims response"]
  node_profile_api["Remote profile API"]
  node_profile_entity["Profile record<br/>[UserTableEntity.cs]"]
  node_lockout_api["Lockout API"]
  node_lockout_state["Lockout state<br/>[User.cs]"]
  node_username_restore["Username restore"]
end

subgraph group_identity["Identity Extensions"]
  node_claims_ui["Claims-provider UI<br/>[AuthController.cs]"]
  node_graph_client["Graph client"]
  node_user_profile["Profile form data"]
end

subgraph group_integrations["External Integrations"]
  node_typingdna["TypingDNA checks<br/>[tdnaController.cs]"]
  node_typing_service{{"TypingDNA service"}}
  node_authy["Authy MFA"]
  node_twilio{{"Twilio SMS"}}
  node_graph_service{{"Azure AD Graph"}}
  node_email_service{{"Mail provider"}}
end

subgraph group_web["Web Journeys"]
  node_invite_controller["Invitation flow"]
  node_certificate_helper["Token signing"]
  node_email_sender["Email sender<br/>[IEmailSender.cs]"]
  node_task_model["Task record<br/>[Task.cs]"]
end

node_b2c(("B2C policy"))

node_claims_ui -->|"updates account"| node_graph_client
node_claims_ui -->|"reads form data"| node_user_profile
node_graph_client -.->|"updates directory"| node_graph_service
node_invite_controller -->|"builds token"| node_certificate_helper
node_invite_controller -->|"sends invitation"| node_email_sender
node_email_sender -.->|"delivers email"| node_email_service
node_typingdna -->|"checks patterns"| node_typing_service
node_authy -->|"sends approval"| node_twilio
node_b2c -.->|"submits claims"| node_captcha
node_b2c -.->|"submits claims"| node_profile_api
node_b2c -.->|"submits claims"| node_lockout_api
node_b2c -.->|"submits claims"| node_username_restore
node_b2c -.->|"submits claims"| node_typingdna
node_b2c -.->|"submits claims"| node_authy
node_b2c -.->|"starts journey"| node_claims_ui

click node_captcha "https://github.com/azure-ad-b2c/samples/blob/master/policies/captcha-integration/Captcha-Handler-API/Contoso.AADB2C.API/Controllers/IdentityController.cs"
click node_captcha_response "https://github.com/azure-ad-b2c/samples/blob/master/policies/captcha-integration/Captcha-Handler-API/Contoso.AADB2C.API/Models/B2CResponseContent.cs"
click node_profile_api "https://github.com/azure-ad-b2c/samples/blob/master/policies/remote-profile/source-code/AADB2C.WebAPI/AADB2C.WebAPI/Controllers/IdentityController.cs"
click node_profile_entity "https://github.com/azure-ad-b2c/samples/blob/master/policies/remote-profile/source-code/AADB2C.WebAPI/AADB2C.WebAPI/Models/UserTableEntity.cs"
click node_lockout_api "https://github.com/azure-ad-b2c/samples/blob/master/policies/lockout/ADB2C.Lockout/ADB2C.Lockout/Controllers/IdentityController.cs"
click node_lockout_state "https://github.com/azure-ad-b2c/samples/blob/master/policies/lockout/ADB2C.Lockout/ADB2C.Lockout/Models/User.cs"
click node_username_restore "https://github.com/azure-ad-b2c/samples/blob/master/policies/username-discovery/AADB2C.RestoreUsername.API/AADB2C.RestoreUsername.API/Controllers/IdentityController.cs"
click node_typingdna "https://github.com/azure-ad-b2c/samples/blob/master/policies/signin-signup-typingdna/source-code/TypingDNA-API-Interface/typingDNAInterface/Controllers/tdnaController.cs"
click node_authy "https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-mfa-authy-app/source-code/AADB2C.MFA.AuthyApp/Controllers/IdentityController.cs"
click node_claims_ui "https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Controllers/AuthController.cs"
click node_graph_client "https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/AzureADGraphClient.cs"
click node_user_profile "https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Models/UserProfileModel.cs"
click node_invite_controller "https://github.com/azure-ad-b2c/samples/blob/master/policies/sign-in-with-magic-link-keyvault/src/Controllers/InvitationController.cs"
click node_certificate_helper "https://github.com/azure-ad-b2c/samples/blob/master/policies/sign-in-with-magic-link-keyvault/src/Utility/KeyVaultCertificateHelper.cs"
click node_email_sender "https://github.com/azure-ad-b2c/samples/blob/master/policies/sign-in-with-magic-link-keyvault/src/Utility/IEmailSender.cs"
click node_task_model "https://github.com/azure-ad-b2c/samples/blob/master/policies/twilio-mfa-psd2/source-code/PSD2%20Demo%20App/TaskService/Models/Task.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_captcha,node_captcha_response,node_profile_api,node_profile_entity,node_lockout_api,node_lockout_state,node_username_restore toneBlue
class node_claims_ui,node_graph_client,node_user_profile toneAmber
class node_typingdna,node_typing_service,node_authy,node_twilio,node_graph_service,node_email_service toneMint
class node_invite_controller,node_certificate_helper,node_email_sender,node_task_model toneRose
class node_b2c toneIndigo
```

## Components

### REST Journeys

- [Captcha handler](https://github.com/azure-ad-b2c/samples/blob/master/policies/captcha-integration/Captcha-Handler-API/Contoso.AADB2C.API/Controllers/IdentityController.cs): `policies/captcha-integration/Captcha-Handler-API/Contoso.AADB2C.API/Controllers/IdentityController.cs`
- [Claims response](https://github.com/azure-ad-b2c/samples/blob/master/policies/captcha-integration/Captcha-Handler-API/Contoso.AADB2C.API/Models/B2CResponseContent.cs): `policies/captcha-integration/Captcha-Handler-API/Contoso.AADB2C.API/Models/B2CResponseContent.cs`
- [Remote profile API](https://github.com/azure-ad-b2c/samples/blob/master/policies/remote-profile/source-code/AADB2C.WebAPI/AADB2C.WebAPI/Controllers/IdentityController.cs): `policies/remote-profile/source-code/AADB2C.WebAPI/AADB2C.WebAPI/Controllers/IdentityController.cs`
- [Profile record](https://github.com/azure-ad-b2c/samples/blob/master/policies/remote-profile/source-code/AADB2C.WebAPI/AADB2C.WebAPI/Models/UserTableEntity.cs): `policies/remote-profile/source-code/AADB2C.WebAPI/AADB2C.WebAPI/Models/UserTableEntity.cs`
- [Lockout API](https://github.com/azure-ad-b2c/samples/blob/master/policies/lockout/ADB2C.Lockout/ADB2C.Lockout/Controllers/IdentityController.cs): `policies/lockout/ADB2C.Lockout/ADB2C.Lockout/Controllers/IdentityController.cs`
- [Lockout state](https://github.com/azure-ad-b2c/samples/blob/master/policies/lockout/ADB2C.Lockout/ADB2C.Lockout/Models/User.cs): `policies/lockout/ADB2C.Lockout/ADB2C.Lockout/Models/User.cs`
- [Username restore](https://github.com/azure-ad-b2c/samples/blob/master/policies/username-discovery/AADB2C.RestoreUsername.API/AADB2C.RestoreUsername.API/Controllers/IdentityController.cs): `policies/username-discovery/AADB2C.RestoreUsername.API/AADB2C.RestoreUsername.API/Controllers/IdentityController.cs`

### Identity Extensions

- [Claims-provider UI](https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Controllers/AuthController.cs): `policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Controllers/AuthController.cs`
- [Graph client](https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/AzureADGraphClient.cs): `policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/AzureADGraphClient.cs`
- [Profile form data](https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Models/UserProfileModel.cs): `policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Models/UserProfileModel.cs`

### External Integrations

- [TypingDNA checks](https://github.com/azure-ad-b2c/samples/blob/master/policies/signin-signup-typingdna/source-code/TypingDNA-API-Interface/typingDNAInterface/Controllers/tdnaController.cs): `policies/signin-signup-typingdna/source-code/TypingDNA-API-Interface/typingDNAInterface/Controllers/tdnaController.cs`
- **TypingDNA service**
- [Authy MFA](https://github.com/azure-ad-b2c/samples/blob/master/policies/custom-mfa-authy-app/source-code/AADB2C.MFA.AuthyApp/Controllers/IdentityController.cs): `policies/custom-mfa-authy-app/source-code/AADB2C.MFA.AuthyApp/Controllers/IdentityController.cs`
- **Twilio SMS**
- **Azure AD Graph**
- **Mail provider**

### Web Journeys

- [Invitation flow](https://github.com/azure-ad-b2c/samples/blob/master/policies/sign-in-with-magic-link-keyvault/src/Controllers/InvitationController.cs): `policies/sign-in-with-magic-link-keyvault/src/Controllers/InvitationController.cs`
- [Token signing](https://github.com/azure-ad-b2c/samples/blob/master/policies/sign-in-with-magic-link-keyvault/src/Utility/KeyVaultCertificateHelper.cs): `policies/sign-in-with-magic-link-keyvault/src/Utility/KeyVaultCertificateHelper.cs`
- [Email sender](https://github.com/azure-ad-b2c/samples/blob/master/policies/sign-in-with-magic-link-keyvault/src/Utility/IEmailSender.cs): `policies/sign-in-with-magic-link-keyvault/src/Utility/IEmailSender.cs`
- [Task record](https://github.com/azure-ad-b2c/samples/blob/master/policies/twilio-mfa-psd2/source-code/PSD2%20Demo%20App/TaskService/Models/Task.cs): `policies/twilio-mfa-psd2/source-code/PSD2 Demo App/TaskService/Models/Task.cs`

### Other components

- **B2C policy**

## Connections

- Claims-provider UI → Graph client: updates account (evidence: `policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Controllers/AuthController.cs`)
- Claims-provider UI → Profile form data: reads form data (evidence: `policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/Controllers/AuthController.cs`)
- Graph client → Azure AD Graph: updates directory (evidence: `policies/custom-claims-provider/source-code/AADB2C.ClaimsProvider.UI/AzureADGraphClient.cs`)
- Invitation flow → Token signing: builds token (evidence: `policies/sign-in-with-magic-link-keyvault/src/Controllers/InvitationController.cs`)
- Invitation flow → Email sender: sends invitation (evidence: `policies/sign-in-with-magic-link-keyvault/src/Controllers/InvitationController.cs`)
- Email sender → Mail provider: delivers email
- TypingDNA checks → TypingDNA service: checks patterns (evidence: `policies/signin-signup-typingdna/source-code/TypingDNA-API-Interface/typingDNAInterface/Controllers/tdnaController.cs`)
- Authy MFA → Twilio SMS: sends approval (evidence: `policies/custom-mfa-authy-app/source-code/AADB2C.MFA.AuthyApp/Controllers/IdentityController.cs`)
- B2C policy → Captcha handler: submits claims
- B2C policy → Remote profile API: submits claims
- B2C policy → Lockout API: submits claims
- B2C policy → Username restore: submits claims
- B2C policy → TypingDNA checks: submits claims
- B2C policy → Authy MFA: submits claims
- B2C policy → Claims-provider UI: starts journey
