在 shopify.app.toml 中通过访问网络规则保护你的应用

您现在可以在shopify.app.toml的新[network_access]部分声明应用的外部主机和服务器。通常Shopify会在客户导航到Shopify之外的URL时发出警告；声明外部主机可跳过此警告，从而为可信流程减少摩擦。同时，声明服务器有助于Shopify发现可疑活动并保护您的应用。

变更内容

新的network_access部分包含两个属性：

• allowed_navigation_hosts_hosts：应用从商店页面链接到的外部网站，例如您自己的域名。Shopify 通常会在将客户引导至商店页面以外的网站之前发出警告。对这些主机的链接会跳过该警告。请按照链接中出现的顺序列出每个主机，最多 20 个。
• allowed_sources_sources：您的应用在商店页面、结账页面和 Shopify 管理页面上加载或发送请求的 HTTPS 来源，最多 20 个。这包括您的扩展程序、应用主页和应用代理页面。我们使用该列表来保护您的应用并监控商店页面是否存在恶意请求。

以下是一个配置示例：

[network_access] allowed_navigation_hosts = ["app.example.com"] allowed_sources = ["https://api.app.example.com"]

受影响对象

任何代码从商店页面、结账页面或 Shopify 管理页面链接到外部服务器或与外部服务器通信的应用均可使用此新部分。

操作指南

对于所有应用，我们强烈建议您：

1. 将应用链接给客户的主机（例如应用自己的网站）添加到allowed_navigation_hosts。
2. 将应用代码加载或发送请求的服务器（例如API或CDN）添加到allowed_sources。
3. 运行shopify app deploy并发布新版本。

如需示例，请参阅 声明应用的网络访问权限。