---
title: "Microsoft Entra Authentication Events SDK for .NET: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/microsoft-microsoft-azure-webjobs-extensions-authentication-events-dotnet/
description: "Microsoft's .NET guide to Azure Functions handlers for Entra ID custom authentication extensions: adding claims at token issuance, prefilling or validating sign-up attributes, and sending one-time passcodes through your own channel."
---

# Microsoft Entra Authentication Events SDK for .NET: review, setup & limitations · Undominated.ai

> Microsoft's .NET guide to Azure Functions handlers for Entra ID custom authentication extensions: adding claims at token issuance, prefilling or validating sign-up attributes, and sending one-time passcodes through your own channel.

[← Explore all skills](/skills/)

IDENTITY AND ACCESS / Microsoft

# Microsoft Entra Authentication Events SDK for .NET

Microsoft's .NET guide to Azure Functions handlers for Entra ID custom authentication extensions: adding claims at token issuance, prefilling or validating sign-up attributes, and sending one-time passcodes through your own channel.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/skills/microsoft-azure-webjobs-extensions-authentication-events-dotnet)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 6 linked sources
 Publisher Microsoft
 Licence [MIT ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE)
 Revision fc164ba1d7a0
 [Read what was—and wasn’t—checked ↓](#review)

“Microsoft Entra Authentication Events SDK for .NET. Azure Functions triggers for custom authentication extensions. Use for token enrichment, custom claims, attribute collection, and OTP customization in Entra ID. Triggers: "Authentication Events", "WebJobsAuthenticationEventsTrigger", "OnTokenIssuanceStart", "OnAttributeCollectionStart", "custom claims", "token enrichment", "Entra custom extension", "authentication extension".”

 [Microsoft · upstream description ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/skills/microsoft-azure-webjobs-extensions-authentication-events-dotnet/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It gives a handler for each of the four events it lists (OnTokenIssuanceStart, OnAttributeCollectionStart, OnAttributeCollectionSubmit and OnOtpSend), each returning the matching WebJobs response type.
- It lists the Entra ID steps after deployment (register the API, create the custom authentication extension, link it to a user flow) and the scope the app registration exposes, CustomAuthenticationExtension.Receive.Payload.
- Its error-handling sample returns an empty token response instead of throwing, with the comment that throwing would fail the authentication.

### A good fit for

 - Add department, employee ID or role claims to Entra ID access or ID tokens from an Azure Function at sign-in
- Block a sign-up from an email domain, or return a field-level validation error, when attributes are submitted
- Prefill sign-up attributes or show a block page before the attribute collection page is displayed
- Send Entra ID one-time passcodes through an SMS or email provider you choose

### Weigh up before choosing

 - Both install lines Microsoft prints for this skill, `npx skills add microsoft/skills --skill azure-sdk-dotnet` and `/plugin install azure-sdk-dotnet@skills`, install the whole azure-sdk-dotnet plugin rather than the authentication events skill alone.
- The hosting cues are mixed: Program.cs is labelled "Isolated worker model", while the handlers use [FunctionName] and local.settings.json sets FUNCTIONS_WORKER_RUNTIME to "dotnet". Check the hosting model against the package documentation before copying.
- The OTP sample logs the recipient phone number at Information level, and its SendSmsAsync is an empty stub.
- The external-data sample sends the user ID to https://api.example.com/users/{userId} through a shared HttpClient with no credentials on that request.
- Practice 4 says authentication events have timeout limits; the file gives no figure.
- The microsoft-azure-webjobs-extensions-authentication-events-dotnet directory holds SKILL.md only and was last changed at the pin by commit e1f9cce1, committed 2026-04-20.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - .github/plugins/azure-sdk-dotnet/skills/microsoft-azure-webjobs-extensions-authentication-events-dotnet/SKILL.md (all 443 lines)
- .github/plugins/azure-sdk-dotnet/README.md
- .github/plugins/azure-sdk-dotnet/.claude-plugin/plugin.json
- README.md
- LICENSE

### Our findings

 - The Installation block adds Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents and gives its Current Version as v1.1.0 (stable).
- The app registration settings are Application ID URI api://<your-function-app-name>.azurewebsites.net, scope CustomAuthenticationExtension.Receive.Payload, and the delegated Microsoft Graph permission User.Read.
- The submit-event sample blocks emails ending in @blocked.com, rejects display names shorter than 3 characters, then trims the display name and upper-cases the city before saving.
- The practice list says to validate all inputs, log correlation IDs, use managed identity, cache external data, test locally with Azure Functions Core Tools and monitor with App Insights.
- The frontmatter declares license MIT, author Microsoft and version 1.0.0. It declares no allowed-tools.

### Not established by this review

 - No Function App was deployed, and no custom authentication extension or user flow was configured in Entra ID.
- No token was issued and no one-time passcode was sent.
- Neither the azure-sdk-dotnet plugin nor microsoft-azure-webjobs-extensions-authentication-events-dotnet was installed.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/README.md)
 - The azure-sdk-dotnet plugin README prints `npx skills add microsoft/skills --skill azure-sdk-dotnet` under Install. It installs the whole azure-sdk-dotnet plugin, whose skill table lists microsoft-azure-webjobs-extensions-authentication-events-dotnet; it does not install that skill alone.
- The same README prints `/plugin install azure-sdk-dotnet@skills`, which also brings in the authentication events skill together with every other skill in the plugin. The repository README runs plugin commands inside Copilot CLI after `/plugin marketplace add microsoft/skills`.

### Before you start

 - The skill prints `dotnet add package Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents`. This review did not run it.
- An Azure Function App, and Entra ID rights to register the API, create a custom authentication extension and link it to a user flow, as the Entra ID Configuration section lists.
- An SMS or email provider of your own for the OTP handler; the sample leaves SendSmsAsync empty.
- Copilot CLI, where `/plugin install azure-sdk-dotnet@skills` adds this authentication events skill with the rest of the plugin.

### Compatibility

Copilot CLI · GitHub Copilot in VS Code

### Implementation

C#

### Reference text; the handlers act only in an Azure Function an operator deploys and links to Entra ID

 - The microsoft-azure-webjobs-extensions-authentication-events-dotnet frontmatter declares no allowed-tools, and its directory holds SKILL.md alone, with no scripts.
- Deployed as written, the handlers receive Entra ID sign-in and sign-up event data: user IDs, correlation IDs, submitted attributes such as email and displayName, and the OTP code with its recipient identifier.
- The token handler adds claims to tokens Entra ID issues; the attribute handlers can block a sign-up or change submitted values before they are saved.
- The external-data sample sends user IDs to api.example.com.
- The app registration exposes the scope CustomAuthenticationExtension.Receive.Payload and requests delegated Microsoft Graph User.Read.
- local.settings.json sets AzureWebJobsStorage to UseDevelopmentStorage=true, and host.json enables Application Insights sampling.

### Cost model

Free to copy under MIT. The file states no price for Azure Functions, Entra ID or the messaging provider an OTP handler would use, and this review looked none up.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [microsoft-azure-webjobs-extensions-authentication-events-dotnet SKILL.md at the pin ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/skills/microsoft-azure-webjobs-extensions-authentication-events-dotnet/SKILL.md) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/skills/microsoft-azure-webjobs-extensions-authentication-events-dotnet/SKILL.md Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, install.prerequisites, access.permissions
- [azure-sdk-dotnet plugin README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/README.md) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/README.md Supports: install.sourceUrl, install.steps, limitations (install scope)
- [azure-sdk-dotnet plugin.json ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/.claude-plugin/plugin.json) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/.claude-plugin/plugin.json Supports: publisher, license (plugin licence field)
- [Repository README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md Supports: compatibility, install.steps (Copilot CLI plugin commands)
- [Repository LICENSE ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE Supports: license
- [Commit e1f9cce1, the last change to microsoft-azure-webjobs-extensions-authentication-events-dotnet at the pin ↗](https://github.com/microsoft/skills/commit/e1f9cce11758d305e6c77683fe34ccc394586291) Checked 2026-10-21 https://github.com/microsoft/skills/commit/e1f9cce11758d305e6c77683fe34ccc394586291 Supports: limitations (last commit date)

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Infisical SSO and User Provisioning Guide ↗ Infisical skill for connecting an identity provider for human login and SCIM user and group provisioning, including SSO enforcement and the /login/admin break-glass portal.](/skills/infisical-sso/)[### Microsoft Entra Agent ID ↗ Pins Microsoft's Entra Agent ID skill, which rejects Azure CLI tokens for these APIs and keeps the AgentID sidecar on localhost.](/skills/microsoft-entra-agent-id/)[### Microsoft Entra app registration ↗ Pins Microsoft's Entra app-registration skill, which sends Key Vault secret work elsewhere and says not to hardcode client secrets.](/skills/microsoft-entra-app-registration/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
