8.4.3. 管理权限请求
使用 UMA 协议的资源服务器可以使用特定的端点来管理权限请求。此端点提供了一个与 UMA 兼容的流，用于注册权限请求并获取一个权限票据。
http://${host}:${port}/realms/${realm-name}/authz/protection/permission权限票据 是代表权限请求的特殊安全令牌类型。根据 UMA 规格，权限票据是：
关联处理从授权服务器到资源服务器，从资源服务器到客户端，最终从客户端重新发送到授权服务器，以便授权服务器评估正确的策略以应用到授权数据的请求。
在大多数情况下，您不需要直接处理此端点。Red Hat build of Keycloak 提供了一个 策略强制器，为资源服务器启用 UMA，以便它可以从授权服务器获取权限票据，将这个票据返回到客户端应用程序，并根据最终请求方令牌(RPT)强制执行授权决策。
从红帽构建的 Keycloak 获取权限票据的过程由资源服务器执行，而不是常规客户端应用程序，当客户端试图访问受保护的资源时获得权限票据，而无需必要授予访问该资源。使用 UMA 时，权限票据的颁发是允许资源服务器进行的重要方面：
- 从与资源服务器保护的资源关联的数据摘要
- 在 Red Hat build of Keycloak 授权请求中注册，稍后可以在工作流中使用它们来根据资源的所有者同意授予访问权限
- 将资源服务器与授权服务器分离，并允许它们使用不同的授权服务器保护和管理其资源
客户而言，权限票据也很重要的方面，需要强调：
- 客户端不需要了解授权数据如何与受保护的资源关联。对客户端的权限票据完全不透明。
- 客户端可以访问不同资源服务器上的资源，并由不同的授权服务器保护
这些只是 UMA 带来的一些好处，其中 UMA 的其他方面基于权限票据，特别关注隐私和用户对其资源的控制访问权限。
8.4.3.1. 创建权限票据
复制链接链接已复制到粘贴板!
要创建权限票据，请发送 HTTP POST 请求，如下所示：
curl -X POST \
http://${host}:${port}/realms/${realm-name}/authz/protection/permission \
-H 'Authorization: Bearer '$pat \
-H 'Content-Type: application/json' \
-d '[
{
"resource_id": "{resource_id}",
"resource_scopes": [
"view"
]
}
]'在创建票据时，您还可以推送任意声明，并将这些声明与 ticket 关联：
curl -X POST \
http://${host}:${port}/realms/${realm-name}/authz/protection/permission \
-H 'Authorization: Bearer '$pat \
-H 'Content-Type: application/json' \
-d '[
{
"resource_id": "{resource_id}",
"resource_scopes": [
"view"
],
"claims": {
"organization": ["acme"]
}
}
]'在评估与权限票据关联的资源和范围的权限时，策略可以使用这些声明。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}