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.
“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".”
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.
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.
- 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.
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
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
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/README.md
Supports: install.sourceUrl, install.steps, limitations (install scope)
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/.claude-plugin/plugin.json
Supports: publisher, license (plugin licence field)
- Repository README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: compatibility, install.steps (Copilot CLI plugin commands)
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: license
https://github.com/microsoft/skills/commit/e1f9cce11758d305e6c77683fe34ccc394586291
Supports: limitations (last commit date)