open-lark 0.13.0

Enterprise-grade Lark/Feishu Open API SDK with comprehensive Chinese documentation and advanced error handling
Documentation 
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

//! 认证信息（Verification）服务
//!
//! 提供飞书认证信息的完整功能集，支持身份验证、权限校验、认证管理、
//! 安全审计等企业级身份认证能力。是系统安全和权限控制的核心基础。
//!
//! # 核心功能
//!
//! ## 身份验证
//! - 🔐 用户身份认证验证
//! - 📱 多因素认证支持
//! - 🔑 令牌验证和管理
//! - 📊 认证状态查询
//! - ⏰ 认证有效期控制
//!
//! ## 权限校验
//! - 👑 用户权限验证
//! - 🔒 资源访问控制
//! - 📋 权限范围查询
//! - 🎯 细粒度权限管理
//! - 🛡️ 安全策略执行
//!
//! ## 认证管理
//! - 📝 认证信息管理
//! - 🔄 认证状态更新
//! - 📊 认证历史记录
//! - 🔔 认证异常通知
//! - 🔧 认证配置管理
//!
//! ## 安全审计
//! - 📋 认证日志记录
//! - 🔍 安全事件监控
//! - 📊 安全数据分析
//! - 🚨 异常行为检测
//! - 📈 安全趋势分析
//!
//! # 使用示例
//!
//! ```rust
//! use open_lark::prelude::*;
//!
//! let client = LarkClient::builder("app_id", "app_secret")
//!     .with_app_type(AppType::SelfBuild)
//!     .build();
//!
//! // 获取认证信息服务
//! let verification = &client.verification;
//!
//! // 验证用户身份
//! // let verify_request = VerifyUserRequest::builder()
//! //     .user_id("user_123")
//! //     .token("auth_token")
//! //     .build();
//! // let verify_result = verification.v1.user.verify(verify_request, None).await?;
//!
//! // 检查权限
//! // let permission_request = CheckPermissionRequest::builder()
//! //     .user_id("user_123")
//! //     .resource("document_123")
//! //     .action("read")
//! //     .build();
//! // let has_permission = verification.v1.permission.check(permission_request, None).await?;
//!
//! // 获取认证信息
//! // let info_request = GetVerificationInfoRequest::builder()
//! //     .user_id("user_123")
//! //     .build();
//! // let info = verification.v1.info.get(info_request, None).await?;
//!
//! // 记录安全事件
//! // let audit_request = LogSecurityEventRequest::builder()
//! //     .user_id("user_123")
//! //     .event_type("login_attempt")
//! //     .details("用户尝试登录")
//! //     .build();
//! // verification.v1.audit.log(audit_request, None).await?;
//! ```
//!
//! # API版本
//!
//! 当前支持v1版本，提供基础的认证功能：
//! - 身份验证和权限校验
//! - 认证信息管理
//! - 安全审计和监控
//! - 认证配置管理
//!
//! # 安全特性
//!
//! - 🔐 多层次安全防护
//! - 🛡️ 实时威胁检测
//! - 📊 智能风险评估
//! - 🔔 安全事件通知
//! - 📱 多设备认证同步
//!
//! # 合规支持
//!
//! - 📋 合规审计要求
//! - 🔍 详细操作日志
//! - 📊 安全报告生成
//! - 🛡️ 数据保护机制
//! - 📈 合规状态监控

/// 数据模型定义
pub mod models;
/// 认证信息服务 v1 版本
pub mod v1;

use crate::core::config::Config;

/// 认证信息服务
///
/// 企业级身份认证的统一入口，提供身份验证、权限校验、
/// 认证管理、安全审计等完整的身份认证功能。
///
/// # 服务架构
///
/// - **v1**: 认证信息API v1版本，提供基础功能集
/// - **models**: 数据模型和结构定义
///
/// # 核心特性
///
/// - 🔐 全面的身份验证功能
/// - 👑 细粒度权限控制系统
/// - 📊 完善的认证管理机制
/// - 🛡️ 实时安全审计能力
/// - 📱 多平台认证支持
///
/// # 适用场景
///
/// - 用户身份验证
/// - 系统权限控制
/// - 安全审计监控
/// - 合规性检查
/// - 风险管理控制
///
/// # 最佳实践
///
/// - 启用多因素认证
/// - 定期审查权限设置
/// - 监控异常认证行为
/// - 保护认证凭据安全
/// - 建立安全审计流程
pub struct VerificationService {
    /// v1版本API服务
    pub v1: v1::V1,
}

impl VerificationService {
    /// 创建新的认证信息服务实例
    ///
    /// # 参数
    /// - `config`: 客户端配置，包含认证信息和API设置
    ///
    /// # 返回值
    /// 配置完成的认证信息服务实例
    pub fn new(config: Config) -> Self {
        Self {
            v1: v1::V1::new(config),
        }
    }
}