Skip to main content

Crate openlark_security

Crate openlark_security 

Source
Expand description

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审计日志数据

Re-exports§

pub use security::acs::AcsProject;
pub use security::acs::AcsV1Service;
pub use security::security_and_compliance::SecurityAndComplianceProject;
pub use security::security_and_compliance::SecurityAndComplianceV1Service;
pub use security::security_and_compliance::SecurityAndComplianceV2Service;
pub use crate::error::SecurityError;

Modules§

error
安全服务错误处理模块
models
共享数据模型
prelude
预导出模块
security
Security 模块

Structs§

SecurityClient
安全服务客户端 — Arc 包装的 SecurityServices，支持零成本克隆。
SecurityServices
安全服务统一入口

Type Aliases§

SecurityResult
结果类型别名