Skip to content
Back to search

cloudsword

一款帮助云租户发现和测试云上风险、增强云上防护能力的综合性开源工具

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wgpsec--cloudsword/badge.svg)](/listings/wgpsec--cloudsword)

HTML

<a href="/listings/wgpsec--cloudsword"><img src="/api/listings/wgpsec--cloudsword/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 297 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ![header](./static/header.jpg)
  2. <h3 align="center">云鉴,让您的公有云环境更安全</h3>
  3. <p align="center">
  4. <img src="https://img.shields.io/github/go-mod/go-version/wgpsec/cloudsword">
  5. <a href="https://github.com/wgpsec/cloudsword/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-apache-blue.svg"></a>
  6. <a href="https://github.com/wgpsec/cloudsword/releases"><img src="https://img.shields.io/github/downloads/wgpsec/cloudsword/total"></a>
  7. <a href="https://github.com/wgpsec/cloudsword/releases/"><img src="https://img.shields.io/github/release/wgpsec/cloudsword"></a>
  8. <a href="https://github.com/wgpsec/cloudsword"><img src="https://img.shields.io/github/stars/wgpsec/cloudsword"></a>
  9. <a href="https://twitter.com/wgpsec"><img src="https://img.shields.io/twitter/follow/wgpsec.svg?logo=twitter"></a>
  10. <a href="https://twitter.com/teamssix"><img src="https://img.shields.io/twitter/follow/teamssix.svg?logo=twitter"></a>
  11. </p>
  12. ---
  13. 云鉴 CloudSword 是一款帮助公有云租户快速发现云上风险、测试云上风险、增强云上防护能力的综合性开源工具。
  14. 作为一款面向安全人员的工具,云鉴可以帮助租户快速了解当前公有云环境中的资源信息、快速发现当前环境中可能存在的弱点从而方便安全人员进行修补,云鉴还预设了一些防御方法,方便安全人员快速部署从而增强云上的防御能力。
  15. * 全局中文输出,没有使用压力。
  16. * 命令补全提示,方便易于使用。
  17. * MSF 使用逻辑,极低学习成本。
  18. * 凭证不用落地,避免二次泄露。
  19. ## 开始使用
  20. ### HomeBrew 安装
  21. 安装
  22. ```bash
  23. brew tap wgpsec/tap
  24. brew install wgpsec/tap/cloudsword
  25. ```
  26. 更新
  27. ```bash
  28. brew update
  29. brew upgrade cloudsword
  30. ```
  31. ### 下载二进制包
  32. 云鉴下载地址:[github.com/wgpsec/cloudsword/releases](https://github.com/wgpsec/cloudsword/releases)
  33. 下载系统对应的压缩文件,解压后在命令行中运行即可。
  34. ## 使用手册
  35. 完整用法与介绍可以查看 [云鉴使用手册](https://wiki.teamssix.com/cloudsword)
  36. ## MCP协议支持
  37. cloudsword 从v0.0.2 版本开始支持MCP协议,支持SSE以及STDIO方式
  38. 使用命令 `./cloudsword sse http://localhost:8080` 即可在本地监听8080端口
  39. **SSE模式**
  40. 以Chrerry stdio为例 填入 http://localhost:8080/sse 即可获得到工具信息
  41. ![image-20250401193340509](./static/image-20250401193340509.png)
  42. **STDIO**
  43. ![image-20250401193444375](./static/image-20250401193444375.png)
  44. **使用示例**
  45. ![image-20250401194214015](./static/image-20250401194214015.png)
  46. ## 集成模块
  47. 以下是云鉴目前所支持使用的模块:
  48. ### 阿里云
  49. #### 综合
  50. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  51. | :--: | :--: | :------: | :------- | :---------------- | :----------------------------------- |
  52. | 1 | 1101 | 阿里云 | ★★★★ | list_cloud_assets | 列出 OSS、ECS、RAM、Domain 服务资产 |
  53. #### 存储桶
  54. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  55. | :--: | :--: | :------: | :------- | :---------------------------- | :--------------------------------- |
  56. | 1 | 1201 | 阿里云 | ★★ | oss_list_buckets | 列出阿里云 OSS 对象存储桶 |
  57. | 2 | 1202 | 阿里云 | ★★★★ | oss_search_objects | 搜索阿里云 OSS 对象 |
  58. | 3 | 1203 | 阿里云 | ★★★ | oss_bucket_only_upload_images | 使用云函数限制存储桶只允许上传图片 |
  59. #### 弹性计算
  60. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  61. | :--: | :--: | :------: | :------- | :----------------- | :--------------------------- |
  62. | 1 | 1301 | 阿里云 | ★★ | ecs_list_instances | 列出阿里云 ECS 弹性计算实例 |
  63. #### 统一身份认证
  64. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  65. | :--: | :--: | :------: | :------- | :------------------------ | :-------------------------------- |
  66. | 1 | 1401 | 阿里云 | ★★ | ram_list_users | 列出阿里云 RAM 用户 |
  67. | 2 | 1402 | 阿里云 | ★ | ram_list_roles | 列出阿里云 RAM 角色 |
  68. | 3 | 1403 | 阿里云 | ★ | ram_create_user | 创建阿里云 RAM 用户 |
  69. | 4 | 1404 | 阿里云 | ★ | ram_attach_policy_to_user | 为阿里云 RAM 用户添加策略 |
  70. | 5 | 1405 | 阿里云 | ★★★ | ram_create_login_profile | 创建阿里云 RAM 用户 Web 登录配置 |
  71. | 6 | 1406 | 阿里云 | ★ | ram_create_access_key | 创建阿里云 RAM 用户访问凭证 |
  72. #### 域名
  73. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  74. | :--: | :--: | :------: | :------- | :------------------ | :--------------------------- |
  75. | 1 | 1501 | 阿里云 | ★ | domain_list_domains | 列出阿里云 Domains 域名资产 |
  76. ### 腾讯云
  77. #### 综合
  78. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  79. | :--: | :--: | :------: | :------- | :----------------- | :------------------------------- |
  80. | 1 | 2101 | 腾讯云 | ★★★★ | list_cloud_assets | 列出 COS、EVM、LH、RAM 服务资产 |
  81. | 2 | 2102 | 腾讯云 | ★★★★★ | create_honey_token | 创建腾讯云访问凭证蜜标 |
  82. #### 存储桶
  83. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  84. | :--: | :--: | :------: | :------- | :--------------- | :------------------------ |
  85. | 1 | 2201 | 腾讯云 | ★★ | cos_list_buckets | 列出腾讯云 COS 对象存储桶 |
  86. #### 弹性计算
  87. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  88. | :--: | :--: | :------: | :------- | :----------------- | :--------------------------- |
  89. | 1 | 2301 | 腾讯云 | ★★ | cvm_list_instances | 列出腾讯云 CVM 弹性计算实例 |
  90. | 2 | 2302 | 腾讯云 | ★ | lh_list_instances | 列出腾讯云 LH 轻量应用服务器 |
  91. #### 统一身份认证
  92. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  93. | :--: | :--: | :------: | :------- | :------------------------ | :------------------------------- |
  94. | 1 | 2401 | 腾讯云 | ★★ | cam_list_users | 列出腾讯云 CAM 用户 |
  95. | 2 | 2402 | 腾讯云 | ★ | cam_list_roles | 列出腾讯云 CAM 角色 |
  96. | 3 | 2403 | 腾讯云 | ★ | cam_create_user | 创建腾讯云 CAM 用户 |
  97. | 4 | 2404 | 腾讯云 | ★ | cam_attach_policy_to_user | 为腾讯云 CAM 用户添加策略 |
  98. | 5 | 2405 | 腾讯云 | ★★★ | cam_create_login_profile | 创建腾讯云 CAM 用户 Web 登录配置 |
  99. | 6 | 2406 | 腾讯云 | ★ | cam_create_access_key | 创建腾讯云 CAM 用户访问凭证 |
  100. ### 华为云
  101. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  102. | :--: | :--: | :------: | :------- | :--------------- | :------------------------- |
  103. | 1 | 3201 | 华为云 | ★★ | obs_list_buckets | 列出华为云 OBS 对象存储桶 |
  104. ### 百度云
  105. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  106. | :--: | :--: | :------: | :------- | :--------------- | :------------------------- |
  107. | 1 | 4201 | 百度云 | ★★ | bos_list_buckets | 列出百度云 BOS 对象存储桶 |
  108. ### 七牛云
  109. | 序号 | ID | 云提供商 | 推荐评级 | 模块名称 | 描述 |
  110. | :--: | :--: | :------: | :------- | :---------------- | :-------------------------- |
  111. | 1 | 5201 | 七牛云 | ★★ | kodo_list_buckets | 列出七牛云 KODO 对象存储桶 |
  112. > 推荐评级最高 5 颗星,推荐评级根据模块的复杂程度、受欢迎程度、价值程度等因素综合判定。
  113. ## 快速上手
  114. 查看帮助信息
  115. ```bash
  116. CloudSword > help
  117. 全局命令
  118. ========
  119. 全局命令 描述
  120. -------- ----
  121. help 查看帮助信息
  122. list 列出模块
  123. quit 退出程序
  124. search 搜索模块
  125. use 使用模块
  126. 二级命令
  127. ========
  128. 二级命令 描述
  129. -------- ----
  130. info 查看模块使用方法
  131. run 运行模块
  132. set 设置运行参数
  133. unset 取消设置运行参数
  134. 环境变量
  135. ========
  136. 环境变量 描述
  137. -------- ----
  138. CLOUD_SWORD_ACCESS_KEY_ID 访问凭证 ID
  139. CLOUD_SWORD_ACCESS_KEY_SECRET 访问凭证 Secret
  140. CLOUD_SWORD_SECURITY_TOKEN 可选,访问凭证的临时令牌部分
  141. CLOUD_SWORD_DETAIL 详细内容输出(设置 no 或者 yes)
  142. ```
  143. 列出阿里云 OSS 对象存储桶
  144. ```bash
  145. CloudSword > use 1201_aliyun_oss_list_buckets
  146. CloudSword 阿里云 (1201_oss_list_buckets) > set ak_id XXXXXXXXXXXX
  147. ak_id ==> XXXXXXXXXXXX
  148. CloudSword 阿里云 (1201_oss_list_buckets) > set ak_secret XXXXXXXXXXXX
  149. ak_secret ==> XXXXXXXXXXXX
  150. CloudSword 阿里云 (1201_oss_list_buckets) > run
  151. [INFO] 2024-12-20 23:23:23 正在运行 1201_aliyun_oss_list_buckets 模块。
  152. [INFO] 2024-12-20 23:23:23 找到以下存储桶:
  153. XXXXXXXX
  154. XXXXXXXX
  155. ```
  156. ![1201_aliyun_oss_list_buckets](./static/1201_aliyun_oss_list_buckets.gif)
  157. ## 加入云鉴问题讨论群
  158. 在「WgpSec 狼组安全团队」公众号菜单栏点击「加群」,添加「WgpSecBot」微信。
  159. <div align=center><img width="700" src="static/WgpSecBot.png"></div><br>
  160. 添加「WgpSecBot」微信后,给机器人发送「云鉴」关键词,机器人就会自动给您发送进群链接了。
  161. <div align=center><img width="700" src="static/add_group.png"></div><br>
  162. ## 贡献者
  163. 十分感谢各位师傅对云鉴的贡献~,如果你也想对云鉴贡献代码或想法,请参见贡献说明:[CONTRIBUTING](https://github.com/wgpsec/cloudsword/blob/master/CONTRIBUTING.md)
  164. <div align=center>
  165. <table>
  166. <tr>
  167. <td align="center">
  168. <a href="https://github.com/teamssix"><img alt="TeamsSix" src="https://avatars.githubusercontent.com/u/49087564" style="width: 100px;" /><br />TeamsSix</a>
  169. </td>
  170. <td align="center">
  171. <a href="https://github.com/keac"><img alt="Keac" src="https://avatars.githubusercontent.com/u/16091665" style="width: 100px;" /><br />Keac</a>
  172. </td>
  173. <td align="center">
  174. <a href="https://github.com/shadowabi"><img alt="shadowabi" src="https://avatars.githubusercontent.com/u/50265741" style="width: 100px;" /><br />shadowabi</a>
  175. </td>
  176. </tr>
  177. </table>
  178. </div>
  179. ## 使用答疑
  180. 我在云鉴使用手册里介绍了为什么写云鉴、云鉴未来的计划以及大家可能关心的问题,感兴趣的师傅可以移步[云鉴使用答疑](https://wiki.teamssix.com/cloudsword/more)查看。
  181. ## 协议
  182. 云鉴在 [Apache-2.0](https://github.com/wgpsec/cloudsword?tab=Apache-2.0-1-ov-file#Apache-2.0-1-ov-file) 协议下授权使用。
  183. ## 更多
  184. 下面这个是我们狼组安全团队的公众号,欢迎师傅关注,有想法一起加入狼组的师傅也可以投递简历至 admin#wgpsec.org 加入我们。
  185. > 发送邮件时,注意将 # 改为 @
  186. <div align=center><img width="700" src="static/wgpsec.png"></div><br>
  187. 如果你对云安全比较感兴趣,可以看我的另外一个项目 [Awesome Cloud Security](https://github.com/teamssix/awesome-cloud-security),这里收录了很多国内外的云安全资源,另外在我的[云安全文库](https://wiki.teamssix.com/)里有大量的云安全方向的笔记和文章,这应该是国内还不错的云安全学习资料。
  188. 下面这个是我的个人微信公众号,在 TeamsSix 公众号里可以与我进行联系,后续关于云鉴的动态我也会发布到我的公众号里。
  189. <div align=center><img width="700" src="static/teamssix.png"></div><br>
  190. 如果您感觉这个项目还不错,也欢迎扫描下面打赏码进行赞赏。
  191. <div align=center><img width="600" src="static/buy-coffee.png"></div><br>
  192. > 赞赏行为纯属自愿,旨在表达对开源软件作者或贡献者的支持和感谢,并非购买商品或服务的交易行为。赞赏者应当清楚理解,赞赏款项不享有任何商品或服务的保证,也不构成任何形式的合同关系。
  193. <div align=center><b>感谢您使用我的工具</b></div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.