Skip to content

凭证授权模式

凭证授权(Client Credentials Grant)是 OAuth 2.0 定义的一种授权类型,适用于客户端直接访问属于自身的资源,或者在某些情况下代表自己进行 API 调用。这种模式通常不涉及用户交互,因为它依赖于客户端的身份验证凭据来获取访问令牌(access token)。以下是使用客户端凭证授权模式实现流程的详细步骤:

实现流程

  1. 客户端注册

    • 首先,客户端需要在授权服务器上进行注册,以获得client_idclient_secret。这些凭据用于标识客户端并验证其身份。
  2. 请求访问令牌

    • 客户端向授权服务器发送一个 HTTP POST 请求,以交换其凭据(client_idclient_secret)为访问令牌。
    • 请求 URL 通常是类似于https://authorization-server.com/oauth/token的形式。
    • 请求体中需要包含以下参数:
      • grant_type: 必须设置为client_credentials,表示使用客户端凭证授权类型。
      • client_id: 客户端 ID。
      • client_secret: 客户端密钥。
      • scope(可选): 请求的权限范围,如果授权服务器支持的话。
  3. 处理响应

    • 如果请求成功,授权服务器将以 JSON 格式返回一个响应,其中至少包括:
      • access_token: 提供给客户端使用的访问令牌。
      • token_type: 表示令牌类型的字符串,通常是Bearer
      • expires_in(可选): 访问令牌的有效期(秒数)。
      • scope(可选): 实际授予的权限范围,可能与请求中的范围不同。
  4. 使用访问令牌

    • 客户端收到访问令牌后,可以在后续的请求中通过在 HTTP 头部添加Authorization: Bearer <access_token>的方式来访问受保护的资源。
  5. 刷新令牌(非标准):

    • 在客户端凭证授权模式下,一般不会提供刷新令牌。一旦访问令牌过期,客户端需要再次执行上述步骤来获取新的访问令牌。

示例请求

假设有一个客户端想要访问自己的资源,并且已经获得了client_idclient_secret,则可以发送如下请求来获取访问令牌:

http
POST /oauth/token HTTP/1.1
Host: authorization-server.com
Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&scope=read%20write

在这个例子中,Authorization头部包含了 Base64 编码的client_id:client_secret字符串。请求体中指定了grant_typeclient_credentials,并且请求了readwrite两个作用域的权限。

注意事项

  • 确保所有请求都通过 HTTPS 传输,以保证安全性。
  • 不要将client_secret暴露给不可信的环境或第三方。
  • 根据实际需求合理设定scope,限制客户端只能访问必要的资源。

通过以上步骤,您可以利用客户端凭证授权模式安全地访问资源服务器上的受保护资源。这种方法特别适合服务到服务之间的通信场景。

Released under the MIT License.