Keycloak 16.0如何通过自定义属性过滤调用/users/count接口？

你可以直接在/users/count接口中使用q参数按自定义属性过滤，用法和用户列表接口完全一致，以此获取符合条件的用户总数，配合分页参数实现正确分页。

具体用法示例 #

请求URL格式：

{{keycloak_url}}/admin/realms/{{realm}}/users/count?q=attribute:value

关键说明 #

• Keycloak 16.0的/users/count接口与/users列表接口共享相同的过滤逻辑，q参数的语法（包括自定义属性的attribute:value格式）完全通用。
• 用这个方式得到的计数，和你用相同q参数调用/users接口返回的用户列表总数完全匹配，能保证分页逻辑的准确性。
• 注意事项：
  • q参数中的属性名和值如果包含特殊字符或空格，需要进行URL编码
  • 调用该接口需要具备与用户列表接口相同的权限（比如分配了view-users角色）
  • 如果自定义属性是多值字段，q=attribute:value会匹配所有包含该值的用户，行为和列表接口一致

内容的提问来源于stack exchange，提问作者Chris K