配置参考¶
此页面包含 apache-airflow-providers-smtp
提供程序的所有可用 Airflow 配置列表,您可以在 airflow.cfg
文件中或使用环境变量设置这些配置。
注意
从 Airflow 2.7.0 开始,嵌入在提供程序包中的配置开始被使用。以前,配置是在 Airflow 核心包中描述和配置的 - 因此,如果您使用的是低于 2.7.0 的 Airflow,请查看 Airflow 文档以获取 Airflow 核心中可用的配置选项列表。
注意
有关更多信息,请参阅 设置配置选项。
[smtp_provider]¶
SMTP 提供程序的选项。
ssl_context¶
1.3.0 版中的新功能。
使用 SMTP 和 IMAP SSL 连接时使用的 ssl 上下文。默认情况下,上下文为“默认”,这将其设置为 ssl.create_default_context()
,这在兼容性和安全性之间提供了适当的平衡,但是,它要求您操作系统中的证书已更新,并且您的 SMTP/IMAP 服务器具有有效的证书,并且您的机器上安装了相应的公钥。如果您想禁用证书检查,可以将其切换为“无”,但不建议这样做,因为如果您的基础设施安全性不够高,则允许 MITM(中间人)攻击。它应该只在您修复证书配置时临时设置。这通常可以通过升级到运行 Airflow 组件的操作系统的较新版本、升级/刷新操作系统中的适当证书或更新邮件服务器的证书来完成。
如果您没有显式设置此选项,它将使用 Airflow 的“email.ssl_context”配置,但如果此配置不存在,它将使用“默认”值。
- 类型
字符串
- 默认
无
- 环境变量
AIRFLOW__SMTP_PROVIDER__SSL_CONTEXT
- 示例
默认
templated_email_subject_path¶
1.6.1 版中的新功能。
使用 SmtpNotifier 时,允许覆盖标准模板化电子邮件主题行。必须提供模板的路径。
- 类型
字符串
- 默认
无
- 环境变量
AIRFLOW__SMTP_PROVIDER__TEMPLATED_EMAIL_SUBJECT_PATH
- 示例
path/to/override/email_subject.html
templated_html_content_path¶
1.6.1 版中的新功能。
使用 SmtpNotifier 时,允许覆盖标准模板化电子邮件路径。必须提供模板的路径。
- 类型
字符串
- 默认
无
- 环境变量
AIRFLOW__SMTP_PROVIDER__TEMPLATED_HTML_CONTENT_PATH
- 示例
path/to/override/email.html