The documentation you are viewing is for Dapr v1.12 which is an older version of Dapr. For up-to-date documentation, see the latest version.

使用 OAuth 配置端点授权

在 Web API 的应用程序端点上启用 OAuth 授权

Dapr OAuth 2.0 中间件 允许您使用 授权代码授予流在 Web API 的 Dapr 端点上启用 OAuth 授权。 还可以将授权令牌注入到端点 API 中,这些 API 可用于对 API 使用 客户端凭据授予流调用的外部 API 进行授权。 当中间件被启用时,任何通过 Dapr 进行的方法调用在被传递给用户代码之前都需要被授权。

这两个流之间的主要区别在于, 授权代码授予流 需要用户交互并授权用户,而 客户端凭据授予流 不需要用户交互并授权服务/应用程序。

在授权服务器上注册你的应用程序

不同的授权服务器提供不同的应用注册体验。 下面是一些示例:

为了指定 Dapr 授权中间件,你需要收集一下信息:

  • 客户端ID(参考 这里)
  • 客户端密钥(参考 这里)
  • 范围 (参考 这里)
  • 授权网址
  • 令牌网址

一些流行的授权服务器的授权/令牌 URL。

服务器 授权网址 令牌网址
Azure AAD https://login.microsoftonline.com/{tenant}/oauth2/authorize https://login.microsoftonline.com/{tenant}/oauth2/token
GitHub https://github.com/login/oauth/authorize https://github.com/login/oauth/access_token
Google https://accounts.google.com/o/oauth2/v2/auth https://accounts.google.com/o/oauth2/token https://www.googleapis.com/oauth2/v4/token
Twitter https://api.twitter.com/oauth/authorize https://api.twitter.com/oauth2/token

定义中间件组件定义

定义授权代码授予组件

OAuth 中间件(授权代码)由组件定义:

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: oauth2
  namespace: default
spec:
  type: middleware.http.oauth2
  version: v1
  metadata:
  - name: clientId
    value: "<your client ID>"
  - name: clientSecret
    value: "<your client secret>"
  - name: scopes
    value: "<comma-separated scope names>"
  - name: authURL
    value: "<authorization URL>"
  - name: tokenURL
    value: "<token exchange URL>"
  - name: redirectURL
    value: "<redirect URL>"
  - name: authHeaderName
    value: "<header name under which the secret token is saved>"
    # forceHTTPS:
    # This key is used to set HTTPS schema on redirect to your API method
    # after Dapr successfully received Access Token from Identity Provider.
    # By default, Dapr will use HTTP on this redirect.
  - name: forceHTTPS
    value: "<set to true if you invoke an API method through Dapr from https origin>"

为授权代码授予定义自定义管道

要使用 OAuth 中间件(授权代码),你应该使用 Dapr配置 创建一个 自定义管道 ,如以下示例所示:

apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
  name: pipeline
  namespace: default
spec:
  httpPipeline:
    handlers:
    - name: oauth2
      type: middleware.http.oauth2

定义客户端凭据授予组件

OAuth(客户端凭据)中间件由组件定义:

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: myComponent
spec:
  type: middleware.http.oauth2clientcredentials
  version: v1
  metadata:
  - name: clientId
    value: "<your client ID>"
  - name: clientSecret
    value: "<your client secret>"
  - name: scopes
    value: "<comma-separated scope names>"
  - name: tokenURL
    value: "<token issuing URL>"
  - name: headerName
    value: "<header name under which the secret token is saved>"
  - name: endpointParamsQuery
    value: "<list of additional key=value settings separated by ampersands or semicolons forwarded to the token issuing service>"
    # authStyle:
    # "0" means to auto-detect which authentication
    # style the provider wants by trying both ways and caching
    # the successful way for the future.

    # "1" sends the "client_id" and "client_secret"
    # in the POST body as application/x-www-form-urlencoded parameters.

    # "2" sends the client_id and client_password
    # using HTTP Basic Authorization. This is an optional style
    # described in the OAuth2 RFC 6749 section 2.3.1.
  - name: authStyle
    value: "<see comment>"

为客户端凭据授予定义自定义管道

要使用 OAuth 中间件(授权代码),你应该使用 Dapr 配置 创建一个 自定义管道,如以下样本所示:

apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
  name: pipeline
  namespace: default
spec:
  httpPipeline:
    handlers:
    - name: myComponent
      type: middleware.http.oauth2clientcredentials

应用配置

要将上述配置(无论授予类型如何) 应用于 Dapr sidecar,请在 pod 规范中添加 dapr.io/config 注解:

apiVersion: apps/v1
kind: Deployment
...
spec:
  ...
  template:
    metadata:
      ...
      annotations:
        dapr.io/enabled: "true"
        ...
        dapr.io/config: "pipeline"
...

访问访问令牌

授权码

一旦一切就绪,每当客户试图通过 Dapr sidecar 调用 API 方法(例如调用 v1.0/invoke/ 端点),如果没有找到访问令牌,它将被重定向到授权的同意页。 否则,访问令牌将被写入 authHeaderName 头,并提供给应用程序代码使用。

客户端凭据授予

一旦一切就绪,每当客户端试图通过 Dapr sidecar 调用 API 方法(比如调用 v1.0/invoke/ 端点), 如果没有找到现有的有效访问令牌,它将检索到一个新的访问令牌。 访问令牌被写入 headerName 头,并提供给应用程序代码使用。 这样,应用就可以在调用中将授权标头中的令牌转发给请求该令牌的外部 API。