diff --git a/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/servlet/ServletSingleTokenSecurityAutoConfiguration.kt b/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/servlet/ServletSingleTokenSecurityAutoConfiguration.kt index 360f6b1..d225e23 100644 --- a/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/servlet/ServletSingleTokenSecurityAutoConfiguration.kt +++ b/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/servlet/ServletSingleTokenSecurityAutoConfiguration.kt @@ -110,7 +110,7 @@ class ServletSingleTokenSecurityAutoConfiguration( * 调用注册器构建安全链,指定链 ID、HttpSecurity 对象和请求匹配器 */ return registrar.buildChain( - SecurityConstants.API_KEY_CHAIN_ID, + SecurityConstants.SINGLE_TOKEN_CHAIN_ID, http, combinedMatcher ) { config -> diff --git a/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/webflux/ReactiveSingleTokenSecurityAutoConfiguration.kt b/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/webflux/ReactiveSingleTokenSecurityAutoConfiguration.kt index 5bd22cc..1654b8e 100644 --- a/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/webflux/ReactiveSingleTokenSecurityAutoConfiguration.kt +++ b/forgeboot-security/forgeboot-security-authorize/autoconfigure/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/autoconfigure/webflux/ReactiveSingleTokenSecurityAutoConfiguration.kt @@ -113,7 +113,7 @@ class ReactiveSingleTokenSecurityAutoConfiguration( val combinedMatcher: ServerWebExchangeMatcher = ServerWebExchangeMatchers.matchers(*matchers.toTypedArray()) return registrar.buildChain( - SecurityConstants.API_KEY_CHAIN_ID, + SecurityConstants.SINGLE_TOKEN_CHAIN_ID, http, combinedMatcher ) { config -> diff --git a/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/servlet/customizer/SingleTokenHttpSecurityCustomizer.kt b/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/servlet/customizer/SingleTokenHttpSecurityCustomizer.kt index f0dc3e0..4ae1d9f 100644 --- a/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/servlet/customizer/SingleTokenHttpSecurityCustomizer.kt +++ b/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/servlet/customizer/SingleTokenHttpSecurityCustomizer.kt @@ -10,7 +10,7 @@ import org.springframework.security.web.authentication.UsernamePasswordAuthentic * 基于单 Token 认证的安全配置定制器 * * 该类用于在 Spring Security 的过滤器链中注册并配置 API 密钥身份验证逻辑, - * 仅当当前安全链标识符匹配 API_KEY_CHAIN_ID 时生效。 + * 仅当当前安全链标识符匹配 SINGLE_TOKEN_CHAIN_ID 时生效。 * * @property singleTokenAuthenticationFilter 处理 API 密钥身份验证请求的过滤器实例 * @since 2025-06-25 16:09:38 @@ -30,7 +30,7 @@ class SingleTokenHttpSecurityCustomizer( * @return Boolean 返回 true 表示支持该 chainId,否则不支持 */ override fun supports(chainId: String): Boolean { - return SecurityConstants.API_KEY_CHAIN_ID == chainId + return SecurityConstants.SINGLE_TOKEN_CHAIN_ID == chainId } /** diff --git a/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/webflux/customizer/SingleTokenServerHttpSecurityCustomizer.kt b/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/webflux/customizer/SingleTokenServerHttpSecurityCustomizer.kt index 41bfda3..1700808 100644 --- a/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/webflux/customizer/SingleTokenServerHttpSecurityCustomizer.kt +++ b/forgeboot-security/forgeboot-security-authorize/impl/src/main/kotlin/com/gewuyou/forgeboot/security/authorize/impl/webflux/customizer/SingleTokenServerHttpSecurityCustomizer.kt @@ -22,13 +22,13 @@ class SingleTokenServerHttpSecurityCustomizer( * 判断当前定制器是否支持处理指定的安全链配置。 * * 该方法用于标识此定制器是否适用于给定 chainId 所代表的安全配置场景。 - * 在本实现中,仅当 chainId 与预定义的 API_KEY_CHAIN_ID 匹配时返回 true。 + * 在本实现中,仅当 chainId 与预定义的 SINGLE_TOKEN_CHAIN_ID 匹配时返回 true。 * * @param chainId 安全链的唯一标识符,用于区分不同的安全配置场景 * @return Boolean 返回 true 表示支持该 chainId,否则不支持 */ override fun supports(chainId: String): Boolean { - return SecurityConstants.API_KEY_CHAIN_ID == chainId + return SecurityConstants.SINGLE_TOKEN_CHAIN_ID == chainId } /** diff --git a/forgeboot-security/forgeboot-security-core/src/main/kotlin/com/gewuyou/forgeboot/security/core/common/constants/SecurityConstants.kt b/forgeboot-security/forgeboot-security-core/src/main/kotlin/com/gewuyou/forgeboot/security/core/common/constants/SecurityConstants.kt index 7ad4ae8..84ad321 100644 --- a/forgeboot-security/forgeboot-security-core/src/main/kotlin/com/gewuyou/forgeboot/security/core/common/constants/SecurityConstants.kt +++ b/forgeboot-security/forgeboot-security-core/src/main/kotlin/com/gewuyou/forgeboot/security/core/common/constants/SecurityConstants.kt @@ -4,6 +4,7 @@ package com.gewuyou.forgeboot.security.core.common.constants * 安全相关常量定义 * * 该对象存储与安全认证相关的通用常量,便于统一管理和维护。 + * 包含请求头字段名称、令牌前缀及链路标识等关键信息。 * * @since 2025-06-25 16:02:05 * @author gewuyou @@ -11,26 +12,31 @@ package com.gewuyou.forgeboot.security.core.common.constants object SecurityConstants { /** * HTTP请求头中用于携带身份凭证的字段名称 + * 通常在请求头中使用,格式为 "Authorization: Bearer " */ const val AUTHORIZATION_HEADER = "Authorization" /** * HTTP请求头中用于携带刷新令牌的字段名称 + * 用于获取新的访问令牌,避免频繁登录 */ - const val REFRESH_TOKEN_HEADER="X-Refresh-Token" + const val REFRESH_TOKEN_HEADER = "X-Refresh-Token" /** * Bearer Token前缀,用于在请求头中标识Token类型 + * 避免与其他类型的令牌混淆,如 Basic Auth */ const val BEARER_PREFIX = "Bearer " /** - * API密钥请求头字段名称,用于在请求头中携带API认证标识 + * 单一令牌模式下的链路标识 + * 用于区分不同认证模式或业务场景的令牌处理逻辑 */ - const val API_KEY_CHAIN_ID = "apiKey" + const val SINGLE_TOKEN_CHAIN_ID = "singleToken" /** * 默认的API密钥标识 + * 用于未指定具体链路时的默认认证方式 */ const val DEFAULT_CHAIN_ID = "default" } \ No newline at end of file