授權(quán)服務(wù)：授權(quán)碼和訪問令牌的頒發(fā)流程是怎樣的？
作者：架構(gòu)師秋天
通過這篇文章，我們詳細(xì)解析了OAuth 2.0中授權(quán)服務(wù)的授權(quán)碼和訪問令牌頒發(fā)流程，并通過源碼分析展示了各個(gè)關(guān)鍵步驟的實(shí)現(xiàn)。希望本文能讓你對授權(quán)碼許可流程有更深入的理解。
今天，我們將深入探索OAuth 2.0體系中最經(jīng)典的授權(quán)碼許可流程，特別是其中的授權(quán)服務(wù)如何頒發(fā)授權(quán)碼和訪問令牌。本文會結(jié)合關(guān)鍵源碼片段和詳盡注釋，帶你逐步掌握授權(quán)服務(wù)的核心邏輯。
一、OAuth 2.0中的授權(quán)服務(wù)是什么？
在OAuth 2.0授權(quán)體系中，授權(quán)服務(wù)（Authorization Server）是負(fù)責(zé)頒發(fā)訪問令牌的核心組件。它的主要任務(wù)是：
- 驗(yàn)證客戶端的身份是否合法；
- 生成并頒發(fā)授權(quán)碼（Authorization Code）和訪問令牌（Access Token）；
- 管理和驗(yàn)證令牌的有效性和過期狀態(tài)；
- 支持刷新令牌的生成，確保用戶不在場的情況下，應(yīng)用也能繼續(xù)訪問資源。
要理解授權(quán)服務(wù)的工作原理，首先需要明白OAuth 2.0體系中的授權(quán)碼許可流程是如何運(yùn)作的。
二、授權(quán)碼許可流程概覽
授權(quán)碼許可（Authorization Code Grant）是OAuth 2.0中最常用的授權(quán)類型，其流程可以概括為以下幾步：
- 用戶授權(quán)請求：用戶在客戶端上發(fā)起訪問資源的請求，客戶端將用戶重定向至授權(quán)服務(wù)的登錄頁面。
- 用戶同意授權(quán)：用戶在授權(quán)服務(wù)頁面進(jìn)行登錄認(rèn)證，并同意將部分權(quán)限授予客戶端。
- 獲取授權(quán)碼：用戶授權(quán)后，授權(quán)服務(wù)生成授權(quán)碼，并將其返回給客戶端。
- 交換授權(quán)碼：客戶端將獲得的授權(quán)碼發(fā)送給授權(quán)服務(wù)，授權(quán)服務(wù)驗(yàn)證通過后生成訪問令牌并返回給客戶端。
- 訪問資源服務(wù)器：客戶端使用訪問令牌，向資源服務(wù)器發(fā)起請求以獲取用戶數(shù)據(jù)。
授權(quán)碼許可流程的關(guān)鍵組件
- 客戶端：即第三方應(yīng)用，比如你手機(jī)上的應(yīng)用。
- 授權(quán)服務(wù)：負(fù)責(zé)頒發(fā)授權(quán)碼和訪問令牌。
- 資源服務(wù)器：存儲用戶數(shù)據(jù)，比如用戶的訂單信息。
- 資源所有者：即用戶，擁有訪問資源的權(quán)限。
接下來，讓我們通過代碼解析授權(quán)服務(wù)的核心流程。
三、代碼解析：授權(quán)碼和訪問令牌的生成
3.1 獲取授權(quán)碼
在OAuth 2.0中，授權(quán)碼的生成是授權(quán)服務(wù)的第一步操作。以下為獲取授權(quán)碼的示例代碼。
授權(quán)服務(wù)代碼示例
// AuthorizationEndpoint.java
@RestController
@RequestMapping("/oauth")
public class AuthorizationEndpoint {
@Autowired
private AuthorizationService authorizationService;
@GetMapping("/authorize")
public ResponseEntity<?> authorize(
@RequestParam("response_type") String responseType,
@RequestParam("client_id") String clientId,
@RequestParam("redirect_uri") String redirectUri,
@RequestParam("scope") String scope,
@RequestParam("state") String state
) {
// Step 1: 驗(yàn)證客戶端ID是否合法
if (!authorizationService.isClientValid(clientId)) {
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Invalid client_id");
}
// Step 2: 驗(yàn)證redirect_uri是否合法
if (!authorizationService.isRedirectUriValid(clientId, redirectUri)) {
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Invalid redirect_uri");
}
// Step 3: 生成授權(quán)碼
String authorizationCode = authorizationService.generateAuthorizationCode(clientId, redirectUri, scope);
// Step 4: 將授權(quán)碼和狀態(tài)碼一起重定向回客戶端
URI location = URI.create(redirectUri + "?code=" + authorizationCode + "&state=" + state);
return ResponseEntity.status(HttpStatus.FOUND).location(location).build();
}
}代碼解讀
- 驗(yàn)證客戶端ID：isClientValid(clientId)方法檢查請求中的客戶端ID是否合法。
- 驗(yàn)證重定向URI：isRedirectUriValid方法確保redirect_uri與客戶端注冊的回調(diào)地址匹配，避免授權(quán)碼泄露。
- 生成授權(quán)碼：generateAuthorizationCode方法會根據(jù)客戶端ID、回調(diào)URI和權(quán)限范圍生成唯一的授權(quán)碼。
- 返回授權(quán)碼：通過重定向，將生成的授權(quán)碼返回給客戶端?？蛻舳穗S后可以使用授權(quán)碼請求訪問令牌。
3.2 獲取訪問令牌
授權(quán)碼生成后，客戶端會調(diào)用授權(quán)服務(wù)的另一個(gè)接口，將授權(quán)碼交換為訪問令牌。以下為訪問令牌的獲取流程：
// TokenEndpoint.java
@RestController
@RequestMapping("/oauth")
public class TokenEndpoint {
@Autowired
private AuthorizationService authorizationService;
@PostMapping("/token")
public ResponseEntity<?> getToken(
@RequestParam("grant_type") String grantType,
@RequestParam("code") String code,
@RequestParam("redirect_uri") String redirectUri,
@RequestParam("client_id") String clientId,
@RequestParam("client_secret") String clientSecret
) {
// Step 1: 驗(yàn)證授權(quán)碼是否合法
if (!authorizationService.isAuthorizationCodeValid(code, clientId, redirectUri)) {
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Invalid authorization code");
}
// Step 2: 驗(yàn)證客戶端ID和密鑰
if (!authorizationService.isClientAuthenticated(clientId, clientSecret)) {
return ResponseEntity.status(HttpStatus.UNAUTHORIZED).body("Client authentication failed");
}
// Step 3: 生成訪問令牌
String accessToken = authorizationService.generateAccessToken(clientId, code);
// Step 4: 返回訪問令牌
return ResponseEntity.ok(Collections.singletonMap("access_token", accessToken));
}
}代碼解讀
- 驗(yàn)證授權(quán)碼：isAuthorizationCodeValid方法檢查授權(quán)碼是否有效，以及是否匹配客戶端ID和回調(diào)URI。
- 驗(yàn)證客戶端身份：通過client_id和client_secret進(jìn)行身份驗(yàn)證，確?？蛻舳说恼埱蠛戏?。
- 生成訪問令牌：generateAccessToken方法會為有效的授權(quán)碼生成一個(gè)唯一的訪問令牌。
- 返回訪問令牌：將訪問令牌返回給客戶端，客戶端可以使用此令牌訪問資源服務(wù)器上的用戶數(shù)據(jù)。
3.3 訪問令牌的管理
在實(shí)際應(yīng)用中，訪問令牌通常具有一定的有效期，超過有效期后需要重新生成。
// AuthorizationService.java
@Service
public class AuthorizationService {
private Map<String, String> authorizationCodes = new HashMap<>();
private Map<String, String> accessTokens = new HashMap<>();
private static final long TOKEN_EXPIRY = 3600L; // 1小時(shí)
// 生成授權(quán)碼
public String generateAuthorizationCode(String clientId, String redirectUri, String scope) {
String code = UUID.randomUUID().toString();
authorizationCodes.put(code, clientId + ":" + redirectUri + ":" + scope);
return code;
}
// 驗(yàn)證授權(quán)碼
public boolean isAuthorizationCodeValid(String code, String clientId, String redirectUri) {
String storedCode = authorizationCodes.get(code);
if (storedCode == null) {
return false;
}
String[] parts = storedCode.split(":");
return parts[0].equals(clientId) && parts[1].equals(redirectUri);
}
// 生成訪問令牌
public String generateAccessToken(String clientId, String code) {
String token = UUID.randomUUID().toString();
accessTokens.put(token, clientId + ":" + System.currentTimeMillis());
return token;
}
// 驗(yàn)證令牌是否有效
public boolean isAccessTokenValid(String token) {
String storedToken = accessTokens.get(token);
if (storedToken == null) {
return false;
}
long issuedTime = Long.parseLong(storedToken.split(":")[1]);
return (System.currentTimeMillis() - issuedTime) < TOKEN_EXPIRY * 1000;
}
}代碼解讀
- 生成授權(quán)碼：使用UUID生成唯一的授權(quán)碼，并存儲在authorizationCodes集合中。
- 驗(yàn)證授權(quán)碼：檢查授權(quán)碼是否有效，是否與客戶端ID和回調(diào)URI匹配。
- 生成訪問令牌：根據(jù)客戶端ID和授權(quán)碼生成訪問令牌，存儲在accessTokens集合中。
- 驗(yàn)證訪問令牌：檢查令牌的存儲時(shí)間，判斷是否過期。
四、令牌刷新
令牌過期后，可以通過刷新令牌（Refresh Token）來重新獲取新的訪問令牌。刷新令牌機(jī)制避免了用戶頻繁授權(quán)，也確?？蛻舳嗽谟脩舨辉趫龅那闆r下繼續(xù)使用。
// TokenEndpoint.java
@PostMapping("/refresh")
public ResponseEntity<?> refreshAccessToken(
@RequestParam("grant_type") String grantType,
@RequestParam("refresh_token") String refreshToken,
@RequestParam("client_id") String clientId,
@RequestParam("client_secret") String clientSecret
) {
if (!authorizationService.isRefreshTokenValid(refreshToken, clientId)) {
return ResponseEntity.status(HttpStatus.UNAUTHORIZED).
body("Invalid refresh token");
}
String newAccessToken = authorizationService.refreshAccessToken(clientId, refreshToken);
return ResponseEntity.ok(Collections.singletonMap("access_token", newAccessToken));
}代碼解讀
- 驗(yàn)證刷新令牌：確認(rèn)refreshToken是否與客戶端ID匹配。
- 生成新令牌：調(diào)用refreshAccessToken生成新的訪問令牌。
五、總結(jié)
通過這篇文章，我們詳細(xì)解析了OAuth 2.0中授權(quán)服務(wù)的授權(quán)碼和訪問令牌頒發(fā)流程，并通過源碼分析展示了各個(gè)關(guān)鍵步驟的實(shí)現(xiàn)。希望本文能讓你對授權(quán)碼許可流程有更深入的理解。
責(zé)任編輯：武曉燕
來源：
架構(gòu)師秋天
