What's Changed
New Feature: Mailgun Email Provider
Full Mailgun REST API integration — the fourth supported email provider alongside Keycloak SMTP, SendGrid, and AWS SES.
Implementation highlights:
- Uses Java's built-in
HttpClient(no external SDK dependency) keeping the JAR lean - Supports both US and EU API regions (
api.mailgun.net/api.eu.mailgun.net) - Sends HTML body, plain text body, or falls back to template-data body automatically
- Validated with 18 unit tests (
MailgunEmailSenderTest) + 5 factory routing tests (EmailSenderFactoryTest)
New configuration fields in authenticator admin UI:
| Field | Required | Description |
|---|---|---|
| Mailgun API Key | Yes | Private API key from Mailgun dashboard |
| Mailgun Domain | Yes | Sending domain (e.g. mg.example.com)
|
| Mailgun From Email | Yes | Verified sender address |
| Mailgun From Name | No | Display name (defaults to from email) |
| Mailgun Region | No | US (default) or EU |
Example config:
Email Provider: MAILGUN
Mailgun API Key: key-xxxxxxxxxxxxxxxxxxxx
Mailgun Domain: mg.yourdomain.com
Mailgun From Email: noreply@yourdomain.com
Mailgun Region: US
Full Changelog: v26.3.2...v26.4.0