[]
        
首页
开发者学堂
文档
论坛
市场
生态机会
活动
在线Demo 免费试用
(Showing Draft Content)

Web字体设置

1. 概述

Web 字体设置用于控制系统通过 URL 下载字体文件时的访问范围、重定向规则、请求时长和文件大小,降低访问未经授权地址以及下载异常文件所带来的安全风险。

系统管理员可在系统管理门户中进入【系统设置】→【Web 字体设置】,配置 Web 字体下载规则。

2. 配置项

image

2.1 启用 URL 允许列表

  1. 控制是否对 Web 字体 URL 的主机地址进行限制。

  • 默认状态为关闭。

  • 开启后,系统仅允许访问【允许的 URL 列表】中配置的主机。

  • 关闭后,系统不限制 Web 字体 URL 的主机。

  1. 开启【启用URL允许列表】,将展开【允许的URL列表】输入框,用户可以输入允许的URL地址。

  • 在列表内的URL将被视为安全可访问的地址,保存字体时,可正常保存。

  • 未在列表内的URL将被视为不在访问许可范围内的地址,保存字体时,将弹出错误提示告知用户不可保存。

注意: 如果部署环境需要限制系统访问内部网络地址或其他敏感地址,建议开启 URL 允许列表,或通过网络策略限制服务器的外部访问范围。

2.2【允许的 URL 列表】

  1. 配置允许访问的 Web 字体主机地址。仅在开启【启用 URL 允许列表】后显示。

    image

每行填写一个地址,支持以下格式:

格式

示例

说明

精确主机名


仅允许访问指定主机

通配子域名

*.example.com

允许访问该域名的子域名,但不包含主域名本身

全局通配符

*

允许访问所有主机

IP 地址

192.168.1.10

允许访问指定 IP 地址

例如,配置:

*.example.com

可匹配:

a.example.com
fonts.example.com

但不能匹配:

example.com
example.com.attacker.test

输入内容时,系统将即时校验每个条目的格式。存在非法条目时,输入框将显示错误状态并指出对应条目,同时禁用【保存更改】。

以下内容不能作为允许列表条目:

  • 包含协议的地址,如 https://fonts.example.com

  • 包含端口的地址,如 fonts.example.com:443

  • 包含路径的地址,如 fonts.example.com/fonts

  • 包含查询参数的地址

  • 包含其他非法字符的地址

  • 非 ASCII 国际化域名

注意: 允许列表仅匹配主机名,不匹配端口和路径。系统不会再次校验主机名最终解析得到的 IP 地址。

2.3【允许自动重定向】

  1. 控制下载 Web 字体时是否允许跟随重定向。

  • 关闭时,返回重定向响应的字体地址将保存失败。

  • 开启时,系统可跟随重定向,但会对每一跳重新执行 URL 和允许列表校验。

  • 重定向最多允许 5 跳。超过 5 跳时,系统将拒绝保存字体。

  • 默认状态为关闭。

如果字体地址会自动跳转至其他地址,可开启该选项,或改用字体文件的最终直达地址。

2.4【请求超时(秒)】

  1. 设置一次字体下载允许使用的最长时间,包括:

  • 建立连接;

  • 等待服务器响应;

  • 读取字体文件;

  • 处理重定向链。

默认值为 30 秒,取值范围为 1~600 秒。

注意: 下载未在指定时间内完成时,系统将停止下载并拒绝保存字体。对于响应较慢的字体服务器,可适当提高该值。

2.5【字体大小上限(MB)】

  1. 设置系统允许下载的最大字体文件大小。默认值为 30 MB,取值范围为 1~1024 MB。

    系2. 统优先根据响应声明的文件大小进行判断;响应未提供文件大小时,系统将在接收数据的过程中统计实际大小。文件超过限制后,系统将立即停止读取并拒绝保存字体。

  2. 如需使用较大的字体文件,请先适当提高该配置值。

3. 保存或取消设置

  1. 完成配置后,单击【保存更改】,系统将保存并应用当前 Web 字体下载安全控制规则。

    如需放弃本次修改,单击【取消】,页面将恢复至修改前的配置。

4. 导出和导入设置

  1. 【Web 字体设置】可随系统设置一起导出和导入。在系统设置导出或导入页面中,该配置项显示为【Web 字体设置】。

    image