12.6. 客户端范围

创建客户端范围时，选择 协议。同一范围中的链接的客户端必须具有相同的协议。

每个 realm 在菜单中具有一组预定义的内置客户端范围。

客户端范围、电子邮件、地址 和电话 在 OpenID Connect 规范 中定义。这些范围没有定义任何角色范围映射，但它们定义了协议映射。这些映射程序与 OpenID Connect 规范中定义的声明对应。

例如，当您打开 电话 客户端范围并打开 映射程序 标签时，您会看到与范围 电话 规范中定义的声明对应的协议映射程序。

当 电话 客户端范围连接到客户端时，客户端会自动继承 电话 客户端范围中定义的所有协议映射程序。为这个客户端发布的访问令牌包含用户的电话号码信息，假设该用户有定义的电话号码。

内置客户端范围包含规格中定义的协议映射程序。您可以自由编辑客户端范围，并创建、更新或删除任何协议映射程序或角色范围映射。

客户端范围包含与同意屏幕相关的选项。如果客户端上启用了相关的客户端 ，则 这些选项很有用。

客户端范围和客户端之间的链接在客户端的客户端 范围 选项卡中配置。在客户端范围和客户端之间链接的两种方法如下：

scope=openid phone

mapper s 选项卡包含 protocol mappers，Scope 选项卡包含为此客户端声明的角色范围映射。它们不包含从客户端范围继承的 mappers 和范围映射。可以查看有效协议映射程序（即客户端本身中定义的协议映射程序以及从链接的客户端范围继承）以及为客户端生成令牌时使用的有效角色范围映射。

这也会显示 scope 参数的值。此参数需要从应用程序发送到 Red Hat Single Sign-On OpenID Connect 授权端点。

所有示例是为特定用户生成的，并为特定客户端发布，其值用于指定的 scope 参数。这个示例包括使用的所有声明和角色映射。

向用户发出令牌时，仅当用户被允许使用令牌时，客户端范围才会生效。

当客户端范围没有定义任何角色范围映射时，允许每个用户使用此客户端范围。但是，当客户端范围定义了角色范围映射时，用户必须至少是其中一个角色的成员。用户角色和客户端范围的角色之间必须有一个交集。复合角色工厂用于评估此交集。

如果用户不允许使用客户端范围，则在生成令牌时不会使用协议映射程序或角色范围映射。客户端范围不会出现在令牌中的 范围 值中。

使用 Realm Default Client Scopes 定义自动链接到新创建的客户端的客户端范围集。

从这里，选择您要作为默认客户端范围添加到新创建的 客户端范围 和可选客户端 范围 的客户端范围。

创建客户端时，如果需要，可以取消链接默认的客户端范围。这与删除 默认角色类似。