mcpField
P
pachca-security

pachca-security

github.com/pachca安全1183 次安装今天更新
代码仓库

关于 pachca-security

pachca-security 是面向 Agent 的 Pachca 安全审计命令行技能，可按时间和事件属性查询审计日志，支持排查登录异常和导出事件。

主要功能

  1. 01按时间范围查询审计事件
  2. 02按事件、操作者和实体筛选
  3. 03分页获取完整事件记录
  4. 04覆盖登录、令牌和权限等事件

适用场景

  1. 01排查失败的双重验证登录
  2. 02监测员工关闭双重验证
  3. 03导出指定时段的审计日志
  4. 04发现异常后通知管理员

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pachca/openapi --skill pachca-security

安装后在 Claude Code 中输入/pachca-security确认已加载。

详细介绍

原文在翻译后有更新，译文可能不是最新。

pachca-security

快速开始

向用户索取 Pachca 令牌（机器人：在 Integrations → Bots 中打开机器人，再进入 API 选项卡；用户：Integrations → API）。

使用 --token 标志，通过 npx -y @pachca/cli 运行命令：

npx -y @pachca/cli <command> --token $PACHCA_TOKEN

或者设置 PACHCA_TOKEN 环境变量：

export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>

帮助：npx -y @pachca/cli --help | 工作流：npx -y @pachca/cli guide

成功使用后，建议全局安装 CLI：npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

开始之前

  1. 如果用户保存了个人资料，请检查：

    npx -y @pachca/cli auth status

    如果正常，请运行命令，不带 --token。

  2. 如果尚未配置个人资料，请索取令牌并使用 --token：

    npx -y @pachca/cli auth status --token $PACHCA_TOKEN

  3. 如果不清楚参数，请运行 pachca <command> --help。

工作流

获取事件审计日志
  1. 获取审计日志： 
    pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601>

    start_time 和 end_time 为必填项（ISO-8601，UTC+0）。筛选条件：event_key、actor_id、actor_type、entity_id、entity_type

仅空间所有者可用。

监控可疑登录

  1. 获取指定时间段内的 2FA 失败事件：

    pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601> --event-key=user_2fa_fail --all

  2. 使用 --event-key=user_2fa_disabled 重复请求，以获取员工关闭双重验证的事件：

    pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601> --event-key=user_2fa_disabled --all

  3. 如果发现异常，请向管理员发送通知：

    pachca messages create --entity-type=user --entity-id=<admin_id> --content="Обнаружены подозрительные входы"
导出指定时间段的日志

  1. 使用分页获取指定时间段内的所有事件：

    pachca security list --start-time=<ISO-8601> --end-time=<ISO-8601> --all

  2. 将所有事件汇总到一个数组中 → 保存到文件或发送到外部系统

可用的 event_key 值

类别键
身份验证user_login、user_logout、user_2fa_fail、user_2fa_success
员工user_created、user_deleted、user_role_changed、user_updated
标签tag_created、tag_deleted、user_added_to_tag、user_removed_from_tag
聊天chat_created、chat_renamed、chat_permission_changed
聊天成员user_chat_join、user_chat_leave、tag_added_to_chat、tag_removed_from_chat
消息message_created、message_updated、message_deleted
表情回应和话题串reaction_created、reaction_deleted、thread_created
令牌access_token_created、access_token_updated、access_token_destroy
加密kms_encrypt、kms_decrypt
安全audit_events_accessed、dlp_violation_detected
搜索（API）search_users_api、search_chats_api、search_messages_api

限制

  • 速率限制：约 50 次请求/秒。遇到 429 时，请等待后重试。
  • limit：最大值为 50
  • 分页：基于游标（limit + cursor）
  • start_time 和 end_time 为必填参数（ISO-8601，UTC+0）

端点

方法路径描述
GET/audit_events事件审计日志

如果不确定如何完成任务，请阅读 references/ 中对应的文件。

评论

支持 Markdown