对等验证允许列表
Alteryx 已为与建立 TLS 或 SSL 连接相关的功能增加了安全检查,例如使用 cURL 和 OpenSSL 建立的 https:// URL 连接。您可以使用“对等验证”设置来调整安全检查。
这要求与服务的连接使用 TLS 进行保护,并且所连接的服务器提供有效且受信任的 CA 签名证书。验证必须沿着 CA 链一直到根证书,并根据 Microsoft Windows 证书存储的受信任证书颁发机构列表来验证证书。目前不支持 Linux。
此功能最初在 2022.1+ Designer-FIPS 和 2022.2 Server-FIPS 版本中启用,且无法关闭。
现在,非 FIPS 2022.3+ 版本也启用了对等验证。
设置对等验证的允许列表
我们知道,某些管理员和用户可能会在此更改中遇到问题,尤其是在现有工作流或服务器环境使用不安全连接,或 TLS 连接使用自签名、无效或不受信任的证书时。
要解决这些问题,并继续使用不安全的连接或应用未通过验证的证书的 TLS 连接,您必须向允许列表添加例外情况。
允许列表包含在启用对等验证的情况下通常会失败的 URL 站点条目。
将 URL 例外添加到名为
PeerValidationBypass.txt
的文本文件。您必须将文件放置在
C:\ProgramData\Alteryx\PeerValidationBypass.txt
中。如果文件不存在,则默认开启对等验证。但是,请注意,文件存在也不会关闭对等验证。这会使 Designer 和 Server 在连接到文件中列出的特定站点时忽略对等验证。
PeerValidationBypass.txt 要求
PeerValidationBypass.txt
文件中的条目必须遵循以下几条规则:
每行一个完全限定域名 (FQDN) 条目。
仅输入域名或 IP 地址。
移除 URL 开头的
protocol://
。从 URL 中移除任何路径、查询和密码。
请勿在条目之间留下空白行。
使用通配符
您可以使用包含通配符的 FQDN 和 IPv4 地址配置 PeerValidationBypass.txt。
域名是由多个字段组成的简单结构,以点分隔,并从右向左读取。示例域名是 help.alteryx.com
,其中…
顶级域 (TLD) 为
com
。标签遵循 TLD。
alteryx
是 Label1,help
是 Label2。标签是不区分大小写的字符序列,长度从 1 到 63 个字符不等。
其只能包含字母 A 到 Z、数字 0 到 9 和连字符 (-),且连字符不能位于标签的首位或末位。
TLD 前面的标签在上面的示例中也称为二级域 (SLD) Alteryx。
注意
域名可以仅由一个字段组成,也可以由两个、三个或三个以上字段组成。完全限定域名 (FQDN) 始终按以下格式标记:
hostname.SLD.TLD
在解析 PeerValidationBypass.txt 以确定是否应验证某个端点的 TLS 证书时,解析器会按以下方式解释通配符:
星号 (*) 字符匹配 0 个或 0 个以上有效标签字符。
问号 (?) 字符正好匹配 1 个有效标签字符。
域名条目详细信息
对于域名条目…
如果 TLD 是国家/地区代码 TLD,则最后三个字段中不允许使用通配符。通配符匹配从标签 3 及其之后的标签开始执行。
如果 TLD 不是国家/地区代码 TLD,则最后两个字段中不允许使用通配符。通配符匹配从标签 2 及其之后的标签开始执行。
域名无效条目示例
???.*.com.fr
、alteryx*.help.n?t
、alteryx.*.net
和 hello.world.example*.???
IPv4 地址条目详细信息
对于 IPv4 地址条目…
前两个字段不允许使用通配符。
通配符匹配在最后两个字段中生效。
IPv4 无效条目示例
192.*.*.23
、???.*.123.234
和 *.10.100.200
条目示例
示例 1
假设对等验证阻止此 URL:
https://ThisIsATest.com/?category.id=External
在 PeerValidationBypass.txt 文件中,输入以下内容:
ThisIsATest.com
示例 2
假设您想要屏蔽以下具有相似模式的 URL:
https://example.ThisIsATest.com/?category.id=External
https://warning.ThisIsATest.com/?category.id=External
https://info.ThisIsATest.com/?category.id=External
您可以在 PeerValidationBypass.txt 文件中使用一条包含通配符的记录屏蔽这三个 URL:
*.ThisIsATest.com
示例 3
要屏蔽 visit.country.france.fr
和 work.country.france.fr
,请在 PeerVAlidationBypass.txt
文件中输入以下内容:
*.country.france.fr
注意
TLD 是国家/地区代码。因此,在最后三个字段 (country.france.fr
) 中不允许使用通配符。
示例 4
要屏蔽 IPv4 地址 123.12.123.1
和 123.12.123.2
,请在 PeerValidationBypass.txt 文件
中输入以下内容:
123.12.123.?
补充说明
编辑
PeerValidationBypass.txt
后,每当您在 Alteryx 工具中使用 cURL/OpenSSL 时,都会搜索匹配项。如果 Designer 或 Server 找到匹配项,则会关闭对等验证。请注意,FIPS 产品会忽略允许列表。
为了避免在外部服务器需要由中间 CA 签署的 SSL 证书时出现 SSL 对等验证错误,请将所需的中间 CA 添加到 Microsoft 管理控制台中的受信任的根证书颁发机构 - 证书文件夹中。