stages/authenticator_email: Email OTP

[melizeche]

Details

stages/authenticator_email: Add Email Authenticator Stage

Introduces a new authentication stage that enables email-based two-factor authentication. This stage:

• Allows users to set up and verify their email for 2FA
• Supports configurable email templates for OTP delivery
• Integrates with existing flow and challenge system

closes #3291

Documentation PR: #12853

---

Checklist

• Local tests pass (ak test authentik/)
• The code has been formatted (make lint-fix)

If an API change has been made

• The API schema has been updated (make gen-build)

If changes to the frontend have been made

• The code has been formatted (make web)

If applicable

• The documentation has been updated
• The documentation has been formatted (make website)

[netlify]

✅ Deploy Preview for authentik-docs canceled.

Name	Link
🔨 Latest commit	fa354bb
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-docs/deploys/67a4ee85a73c370008a2f6fa

[netlify]

✅ Deploy Preview for authentik-storybook canceled.

Name	Link
🔨 Latest commit	fa354bb
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/67a4ee8548f9130008a2a0b3

[codecov]

Codecov Report

Attention: Patch coverage is 96.12245% with 19 lines in your changes missing coverage. Please review.

Project coverage is 92.79%. Comparing base (fb7d637) to head (fa354bb).
Report is 5 commits behind head on main.

Files with missing lines	Patch %	Lines
authentik/stages/authenticator_email/stage.py	86.91%	14 Missing ⚠️
authentik/stages/authenticator_email/models.py	96.42%	3 Missing ⚠️
authentik/stages/authenticator_validate/stage.py	84.61%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #12630      +/-   ##
==========================================
+ Coverage   92.75%   92.79%   +0.03%     
==========================================
  Files         785      792       +7     
  Lines       39580    40057     +477     
==========================================
+ Hits        36713    37170     +457     
- Misses       2867     2887      +20     

Flag	Coverage Δ
e2e	48.31% <33.06%> (-0.23%)	⬇️
integration	24.53% <23.26%> (-0.02%)	⬇️
unit	90.50% <96.12%> (+0.07%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[melizeche]

@rissson I pushed the generated schema.yml and blueprints/schema.json
Is this the correct procedure?

[rissson]

I pushed the generated schema.yml and blueprints/schema.json Is this the correct procedure?

Yes, that's the way to go about it