3.5. 使用 Web 控制台配置 Apicurio Registry 设置
作为管理员,您可以使用 Apicurio Registry web 控制台在运行时为 Apicurio Registry 配置动态设置。您可以管理身份验证、授权和 API 兼容性等功能的配置选项。
只有在部署了 Apicurio Registry 时启用了身份验证时,才会在 web 控制台中显示身份验证和授权设置。如需了解更多详细信息,请参阅在 OpenShift 上安装和部署红帽构建的 Apicurio Registry。
先决条件
- Apicurio Registry 已部署。
您使用管理员访问权限登录到 Apicurio Registry web 控制台:
http://MY_REGISTRY_UI_URL/
流程
- 在 Apicurio Registry web 控制台中点 Settings 选项卡。
选择您要为 Apicurio Registry 配置的设置:
Expand 表 3.1. 身份验证设置 设置 描述 HTTP 基本身份验证
仅在启用了身份验证时显示(确保部署)。选择后,Apicurio Registry 用户可以使用 HTTP 基本身份验证进行身份验证,除了 OAuth 之外。默认不选择。
Expand 表 3.2. 授权设置 设置 描述 匿名读取访问
仅在启用了身份验证时显示。选择后,Apicurio Registry 授予对匿名用户的只读访问权限,而无需任何凭证。如果要使用 Apicurio Registry 在外部发布模式或 API,则此设置很有用。默认不选择。
工件仅所有者授权
仅在启用了身份验证时显示。选择后,只有创建工件的用户才能修改该工件。默认不选择。
工件组所有者授权
仅在启用了身份验证并且启用了 Artifact owner-only 授权 时显示。选择后,只有创建工件组的用户才能对该工件组具有写入访问权限,例如,在该组中添加或删除工件。默认不选择。
验证的读取访问权限
仅在启用了身份验证时显示。选择后,Apicurio Registry 至少授予来自任何经过身份验证的用户的只读访问权限,而不考虑其用户角色。默认不选择。
Expand 表 3.3. 兼容性设置 设置 描述 规范哈希模式(兼容性 API)
选择后,Schema Registry 兼容性 API 使用规范哈希而不是内容的常规哈希。
传统 ID 模式(兼容性 API)
选择后,Confluent Schema Registry 兼容性 API 使用
globalId
而不是contentId
作为工件标识符。返回的最大主题数(兼容性 API)
决定 Confluent Schema Registry 兼容性 API 返回的最大 Subject 数量(用于
/subjects
端点)。Expand 表 3.4. Web 控制台设置 设置 描述 下载链接到期
为了安全起见,生成到
.zip
下载文件的链接的秒数,例如从 Apicurio Registry 导出工件数据时。默认值为 30 秒。Expand 表 3.5. 语义版本设置 设置 描述 自动创建 semver 分支
启用后,自动为主('A.x')和次('A.B.x')工件版本自动创建或更新分支。
确保所有版本号都兼容"semver"
启用后,验证所有工件版本是否都符合 Semantic Versioning 2 格式(https://semver.org)。
Expand 表 3.6. 其他属性 设置 描述 删除工件
选择后,用户可以使用 Core Registry API 删除 Apicurio Registry 中的工件。默认不选择。
删除工件版本
选择后,用户可以使用 Core Registry API 删除 Apicurio Registry 中的工件版本。默认不选择。
Delete group(删除组)
选择后,用户可以使用 Core Registry API 删除 Apicurio Registry 中的组。默认不选择。
存储只读模式
选择后,Registry 会为写入存储的操作返回错误(此属性除外)。默认情况下不启用。