电子邮件连接器和操作

编辑

电子邮件连接器和操作

编辑

电子邮件连接器使用 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 编码。还支持每个 RFC 6749 在授权标头中提供凭据的基本身份验证模式。
需要身份验证: 如果为 true，则必须提供登录类型身份验证的用户名和密码。
用户名: 登录类型身份验证的用户名。
密码: 登录类型身份验证的密码。

测试连接器

编辑

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

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

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

连接器网络配置

编辑

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

配置知名服务的电子邮件帐户

编辑

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

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