1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! gRPC 鉴权拦截器 + 健康检查服务模块。
//!
//! `GarrisonGrpcInterceptor` 从 metadata 提取 `authorization: Bearer <token>` 鉴权,失败返回
//! `tonic::Status::UNAUTHENTICATED`(code = 16);`health_service` 提供 gRPC 标准健康检查
//! (grpc.health.v1.Health,默认 Serving),供 kubelet / 服务网格探针调用。
//!
//! ```ignore
//! use garrison::grpc::{GarrisonGrpcInterceptor, health_service};
//! use tonic::transport::Server;
//!
//! // 重要:interceptor 会拦截所有 service 请求(要求 Authorization Bearer token),
//! // 因此 health_service 必须注册到独立的 tonic Server(无 interceptor),
//! // 否则 kubelet / 服务网格探针因缺少 Authorization 头而被拒绝。
//! let health = health_service().await;
//! Server::builder()
//! .add_service(health)
//! .serve(health_addr)
//! .await?;
//!
//! Server::builder()
//! .interceptor(GarrisonGrpcInterceptor::new())
//! .add_service(my_service)
//! .serve(app_addr)
//! .await?;
//! ```
//!
//! 启用 `grpc` feature 时编译;未启用时模块不存在,不引入 tonic 依赖。
/// gRPC async 鉴权层(`tower::Layer` / `Service` 形态)。
/// gRPC 标准健康检查服务。
/// gRPC 鉴权拦截器实现。
pub use ;
pub use health_service;
pub use MAX_TOKEN_LEN;
/// 认证上下文注入载体:校验通过的 Bearer token 存入 request extensions,handler 经
/// `request.extensions().get::<GarrisonGrpcToken>()` 读取;`Debug` 手动实现为脱敏输出,防误打印泄露。
;
/// gRPC 拦截器**同步** token 校验扩展点。
///
/// `tonic::Interceptor::call` 是同步 trait,无法调用异步的 `GarrisonUtil::check_login()`;经
/// [`GarrisonGrpcInterceptor::with_token_validator`] 注入同步实现(如查询本地缓存会话表),
/// 失败返回任意 `tonic::Status` 即拒绝请求。需要 async 全量鉴权请用 [`GarrisonGrpcAuthLayer`]。
/// Garrison gRPC 鉴权拦截器。
///
/// 实现 `tonic::Interceptor`,从 metadata 提取 Authorization Bearer token:scheme 按 RFC 7235
/// 大小写不敏感(`Bearer` / `bearer` 等均可),token 非空且长度 ≤ 4KB(超长拒绝,防无界分配),
/// 通过校验的 token 以 [`GarrisonGrpcToken`] 注入 request extensions。
///
/// # 鉴权语义
///
/// 未配置校验器时仅格式校验(同步 trait 无法调用异步 `check_login()`),实际鉴权须在 handler 内经
/// `with_current_token` task_local 显式调用;配置 `with_token_validator` 时拦截器内真实鉴权、失败
/// `Status::UNAUTHENTICATED`;完整 async 鉴权用 [`GarrisonGrpcAuthLayer`]。
///
/// ```ignore
/// use garrison::grpc::GarrisonGrpcAuthLayer;
/// let svc = GarrisonGrpcAuthLayer.layer(my_greeter_service);
/// tonic::transport::Server::builder().add_service(svc).serve(addr).await?;
/// ```
///
/// # 使用
///
/// ```ignore
/// use garrison::grpc::GarrisonGrpcInterceptor;
/// use tonic::transport::Server;
///
/// Server::builder()
/// .interceptor(GarrisonGrpcInterceptor::new())
/// .add_service(my_service)
/// .serve(addr)
/// .await?;
/// ```