【问题标题】:RESTful API best practices for admin and normal user access用于管理员和普通用户访问的 RESTful API 最佳实践
【发布时间】:2016-01-28 19:58:50
【问题描述】:

必须创建一个具有管理员和普通用户访问资源(比如说汽车)的 RESTful Web 服务,我想为用户构建 Uri:

http://myhost/users/5/cars/2

但作为管理员用户,我想访问所有汽车,例如:

http://myhost/cars/51

与我提出的第一个相比,您认为最好只为汽车使用一个 Uri,为用户使用过滤器,例如:

http://myhost/cars/?user=5

同一资源没有 2 个不同的 Uris?您还有其他建议吗?

【问题讨论】:

  • 抱歉,为什么要投反对票?
  • 不是我,但可能是因为这不是主题。您可以查看here 和Meta Stack Exchange,了解有关原因的讨论/最佳实践问题。

标签: rest uri restful-architecture restful-url


【解决方案1】:

以下两个 URL 都很好,即使对于普通用户也是如此。 Auth-token 应该在 HTTP 会话中,因此服务器应该能够检测请求者是否是管理员。

http://myhost/cars 返回汽车的集合。建议根据授权对还车进行过滤。如果我是管理员,我可以看到所有汽车。如果我是用户#5,那么我可能只能看到我的车。因此管理员和普通用户都可以使用相同的 URL。

在http://myhost/cars/?user=5 的情况下,我对用户#5 的汽车感兴趣,即使我是其他人,也会应用显式过滤器。可能我得到一个空列表,因为我无权查看任何项目。这个网址也可以。

http://myhost/cars/51 表示我想直接访问 #51 号车。不管我是不是管理员。如果我无权查看此实体,我可能会收到 4XX 消息(XX 是什么是另一个争论)。

【讨论】:

  • 感谢您非常详细和清晰的解释!我一定会听从你的建议!
  • 我会问这个问题,我如何在管理员和用户之间分离对数据库的查询,我是否需要两个控制器来做到这一点??
  • 只有一个控制器是可能的。根据调用者用户的权限情况动态组装数据库查询。在 SQL 中:当应为实际用户应用某些过滤时,向 DB 查询添加额外的“where”子句。
【解决方案2】:

用户标识符不应是 uri 的一部分,因为检索资源的用户与正在检索的资源无关。当资源之间存在父子关系时,通常会将它们包含在 uri 中。

在您的案例中,用户对资源的访问权限应该从他们随请求发送的授权令牌中推断出来。

【讨论】:

  • 确实出于安全原因必须从授权令牌中推断出用户,但是在这种情况下,也存在关系:用户拥有许多汽车。那么在这种情况下,你认为 Uri:myhost/users/5/cars/2 也不好?
  • 由于 rest 调用应该在从授权令牌获得的用户身份的上下文中执行,因此 uri 中不需要“用户”。当您获得特定汽车时,uris 可以简化为myhost/car/2(注意汽车的单数)。对于非管理员用户,您将检查他们是否有权访问/与该特定汽车相关,而对于管理员用户,您只需提供汽车而不进行任何关系检查。
猜你喜欢
  • 2022-01-06
  • 2020-05-14
  • 1970-01-01
  • 2020-04-13
  • 1970-01-01
  • 2019-08-30
  • 2019-06-07
  • 1970-01-01
  • 2020-11-11
相关资源
最近更新 更多