openlark-security 0.17.0

OpenLark 安全服务模块

提供飞书开放平台的完整安全服务，包括访问控制(ACS)和安全合规管理。

架构设计

采用 Project-Version-Resource (PVR) 三层架构：

openlark-security/src/
├── models/           # 共享数据模型
├── acs/              # 访问控制系统 (Project)
│   └── v1/          # API版本v1 (Version)
└── security_and_compliance/  # 安全合规管理 (Project)
    ├── v1/          # API版本v1 (Version) - 审计日志
    └── v2/          # API版本v2 (Version) - 设备记录管理

快速开始

use openlark_security::prelude::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = SecurityConfig::new("app_id", "app_secret");
    let security = SecurityServices::new(config);

    // 获取门禁用户列表
    let users = security.acs.v1().users().list()
        .page_size(20)
        .send()
        .await?;

    println!("用户数量: {}", users.users.len());
    Ok(())
}

API覆盖

acs (v1) - 访问控制系统

用户管理 (user)

• users.get() - 获取单个用户信息
• users.list() - 获取用户列表
• users.patch() - 修改用户部分信息

人脸识别 (user.face)

• user_faces.get() - 下载人脸图片
• user_faces.update() - 上传人脸图片

权限规则 (rule_external)

• rule_external.create() - 创建或更新权限组
• rule_external.get() - 获取权限组信息
• rule_external.delete() - 删除权限组
• rule_external.device_bind() - 设备绑定权限组

访客管理 (visitor)

• visitors.create() - 添加访客
• visitors.delete() - 删除访客

设备管理 (device)

• devices.list() - 获取门禁设备列表

security_and_compliance (v2/v1) - 安全合规管理

设备记录管理 (device_record - v2)

• device_records.mine() - 获取客户端设备认证信息
• device_records.create() - 新增设备
• device_records.list() - 查询设备信息
• device_records.get() - 获取设备信息
• device_records.update() - 更新设备
• device_records.delete() - 删除设备

设备申报审批 (device_apply_record - v2)

• device_apply_records.approve() - 审批设备申报

审计日志管理 (openapi_log - v1)

• openapi_logs.list_data() - 获取OpenAPI审计日志数据