电子邮件连接器和操作

编辑

电子邮件连接器和操作编辑

电子邮件连接器使用 SMTP 协议发送邮件。电子邮件正文以纯文本和 HTML 文本格式发送。

要使电子邮件的页脚包含指向 Kibana 的链接，请设置 server.publicBaseUrl 配置设置。
使用 xpack.actions.email.domain_allowlist 配置设置时，用于发件人（来自）、收件人、抄送和密件抄送所有属性的电子邮件地址必须具有在配置设置中指定的电子邮件域。

在 Kibana 中创建连接器编辑

您可以在 堆栈管理 > 连接器 中创建连接器，也可以在创建规则时根据需要创建连接器。例如

连接器配置编辑

电子邮件连接器具有以下配置属性

名称: 连接器的名称。该名称用于在管理 UI 连接器列表中或在配置操作时的连接器列表中标识连接器。
发件人: 使用此连接器发送的所有电子邮件的发件人地址。必须以 user@host-name 格式指定。有关更多信息，请参阅 Nodemailer 地址文档。
服务: 电子邮件服务的名称。如果 service 是 Nodemailer 众所周知的电子邮件服务提供商之一，则使用默认值定义 host、port 和 secure 属性，并禁用修改。如果 service 是 MS Exchange Server，则忽略 host、port 和 secure 属性，而需要 tenantId、clientId、clientSecret。如果 service 是 other，则必须定义 host 和 port 属性。
主机: 服务提供商的主机名。如果您正在使用 xpack.actions.allowedHosts 设置，请确保将此主机名添加到允许的主机中。
端口: 要连接到服务提供商的端口。
安全: 如果为 true，则连接在连接到服务提供商时将使用 TLS。有关更多信息，请参阅 Nodemailer TLS 文档。如果为 false，则连接将首先通过 TCP 连接，然后尝试通过 SMTP STARTTLS 命令切换到 TLS。
租户 ID: 应用程序计划对其进行操作的目录租户，采用 GUID 格式。
客户端 ID: 分配给您的应用程序的应用程序 ID，采用 GUID 格式。您可以在注册应用程序的门户中找到此信息。
客户端密钥: 您在应用程序注册门户中为应用程序生成的客户端密钥。客户端密钥在发送之前必须进行 URL 编码。还支持在 Authorization 标头中提供凭据的基本身份验证模式，根据 RFC 6749。
需要身份验证: 如果为 true，则必须提供用于登录类型身份验证的用户名和密码。
用户名: 用于登录类型身份验证的用户名。
密码: 用于登录类型身份验证的密码。

测试连接器编辑

您可以在 Kibana 中创建或编辑连接器时对其进行测试。例如

电子邮件操作具有以下配置属性。

收件人、抄送、密件抄送: 每个项目都是一个地址列表。地址可以以 user@host-name 格式指定，也可以以 name <user@host-name> 格式指定。收件人、抄送或密件抄送必须包含一个条目。
主题: 电子邮件的主题行。
正文: 电子邮件的正文文本。支持 Markdown 格式。

连接器网络配置编辑

使用操作配置设置来自定义连接器网络配置，例如代理、证书或 TLS 设置。您可以设置适用于所有连接器的配置，也可以使用 xpack.actions.customHostSettings 设置每个主机的配置。

为知名服务配置电子邮件帐户编辑

电子邮件连接器使用 Nodemailer 的集成从许多流行的 SMTP 电子邮件服务发送电子邮件。对于 Microsoft Exchange 电子邮件，它使用 Microsoft Graph API。

对于其他电子邮件服务器，您可以在 JSON 文件 well-known/services.json 中查看 Nodemailer 支持的知名服务列表。这些文件中对象的属性（host、port 和 secure）对应于相同的电子邮件连接器配置属性。“well-known/services.json”文件中缺少的 secure 属性被视为 false。通常，port: 465 使用 secure: true，而 port: 25 和 port: 587 使用 secure: false。