← Explore all 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.

“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.

Upstream setup instructions ↗
  1. 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.
  2. 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.

  1. 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

  2. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/README.md

    Supports: install.sourceUrl, install.steps, limitations (install scope)

  3. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-dotnet/.claude-plugin/plugin.json

    Supports: publisher, license (plugin licence field)

  4. Repository README ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md

    Supports: compatibility, install.steps (Copilot CLI plugin commands)

  5. Repository LICENSE ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE

    Supports: license

  6. https://github.com/microsoft/skills/commit/e1f9cce11758d305e6c77683fe34ccc394586291

    Supports: limitations (last commit date)

Evidence & Ask