• 欢迎光临~

SAP Spartacus UI 通过 HTTP Interceptor 给请求添加 Authorization 字段的源代码分析

开发技术 开发技术 2022-10-15 次浏览

Angular HTTP Interceptor 的几种使用场景之中,最常见的就是为 outbound HTTP 请求,添加 Authorization 头部字段。

下面这段示例应用程序有一个 AuthService,它产生一个 Authorization token。在AuthInterceptor 中注入该服务以获取 token,并向每个传出请求添加带有该 token 的 Authorization header:

import { AuthService } from '../auth.service';

@Injectable()
export class AuthInterceptor implements HttpInterceptor {

  constructor(private auth: AuthService) {}

  intercept(req: HttpRequest<any>, next: HttpHandler) {
    // Get the auth token from the service.
    const authToken = this.auth.getAuthorizationToken();

    // Clone the request and replace the original headers with
    // cloned headers, updated with the authorization.
    const authReq = req.clone({
      headers: req.headers.set('Authorization', authToken)
    });

    // send cloned request with header to the next handler.
    return next.handle(authReq);
  }
}

当然,上面先 clone 请求,再设置字段,有更简洁的写法:

// Clone the request and set the new header in one step.
const authReq = req.clone({ setHeaders: { Authorization: authToken } });

在 SAP Spartacus 的 Angular 代码中也采取了上述的思路来实现。

一个例子:AuthHttpHeaderService

这个类是 AuthInterceptor 的一个 service 类:
SAP Spartacus UI 通过 HTTP Interceptor 给请求添加 Authorization 字段的源代码分析

我们查看 alterRequest 方法的注释,得知其作用就是给 OCC API 调用的 HTTP 请求添加 Authorization 字段。

首先调用第 147 行的方法 getAuthorizationHeader,判断当前的请求对象 request:

这个方法的实现源代码:

  protected getAuthorizationHeader(request: HttpRequest<any>): string | null {
    const rawValue = request.headers.get('Authorization');
    return rawValue;
  }

因为如果请求头部已经拥有 Authorization 字段,我们就不应该继续添加了。

SAP Spartacus UI 通过 HTTP Interceptor 给请求添加 Authorization 字段的源代码分析

isOccUrl 的实现代码:

  protected isOccUrl(url: string): boolean {
    return url.includes(this.occEndpoints.getBaseUrl());
  }

如果该请求 url 包含 OCC endpoint,并且还没有 Authorization 字段添加,则进入代码第 150 行,添加 Access Token.

方法 createAuthorizationHeader 接收的参数 token 的类型为 AuthToken,这是一个 interface:

SAP Spartacus UI 通过 HTTP Interceptor 给请求添加 Authorization 字段的源代码分析

interface 的字段列表:

export interface AuthToken {
  /**
   * Token used for `Authorization` header.
   */
  access_token: string;
  /**
   * Token to refresh the `access_token` when it expires.
   */
  refresh_token?: string;
  /**
   * Time when `access_token` expires.
   */
  expires_at?: string;
  /**
   * Scopes granted by the OAuth server.
   */
  granted_scopes?: string[];
  /**
   * Time when `access_token` was fetched from OAuth server and saved.
   */
  access_token_stored_at: string;
  /**
   * Type of the `access_token`. Most often `Bearer`.
   */
  token_type?: string;
}

可见 AuthToken 接口除了包含 Access Token 之外,还有其超时时间,以及 refresh token 的值。但对于我们当前的场景,我们仅需要关注 access_token 字段。

如下图三个关键点所示:

  • 首先检查 token 输入参数的字段 access_token,如果可用,直接返回该字段值;
  • 如果 access_token 字段不可用,从 Ngrx 这个 memory store 里读取出来,赋给临时变量 currentToken
  • 将 currentToken 的值返回给调用者
    SAP Spartacus UI 通过 HTTP Interceptor 给请求添加 Authorization 字段的源代码分析
喜欢 (0)