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	2426e0b
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-docs/deploys/679b04fdcd73790008bb4a39

[netlify]

✅ Deploy Preview for authentik-storybook ready!

Name	Link
🔨 Latest commit	2426e0b
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/679b04fdbe754c000865f137
😎 Deploy Preview	https://deploy-preview-12630--authentik-storybook.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[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 (141ced8) to head (2426e0b).
Report is 18 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.69%   92.79%   +0.09%     
==========================================
  Files         769      776       +7     
  Lines       38926    39406     +480     
==========================================
+ Hits        36083    36567     +484     
+ Misses       2843     2839       -4     

Flag	Coverage Δ
e2e	48.37% <33.06%> (-0.11%)	⬇️
integration	24.59% <23.26%> (-0.02%)	⬇️
unit	90.47% <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