cloudcc-cli 2.3.4 → 2.3.5

package/src/identityProvider/create.js

@@ -0,0 +1,78 @@
+const chalk = require("chalk");
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 创建身份提供商
+ * 接口: /samlSp/save
+ * 用法：cc create identityProvider <path> <entityid> <acsurl>
+ */
+async function create(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const entityid = argvs[3];
+        const acsurl = argvs[4];
+
+        if (!entityid || !acsurl) {
+            console.error();
+            console.error(chalk.red("Error: 缺少必需参数"));
+            console.error(chalk.yellow("用法: cc create identityProvider <path> <entityid> <acsurl>"));
+            console.error(chalk.yellow("示例: cc create identityProvider . 'http://testdev.cloudcc.cn/ccdomaingateway/apisvc' 'http://testdev.cloudcc.cn/ccdomaingateway/apisvc/saml2/sp/sso/acs'"));
+            console.error();
+            throw new Error("缺少必需参数: entityid 和 acsurl");
+        }
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green(`Creating identity provider, please wait...`));
+        console.error();
+
+        // 构建请求参数
+        const body = {
+            entityid: entityid,
+            acsurl: acsurl,
+            issuername: "",
+            nameidtype: "FederationId",
+            nameidformat: "1",
+            enablelogout: false,
+            logouturl: "",
+            custattrname: "",
+            id: ""
+        };
+
+        const res = await postClass(
+            config.setupSvc + "/api/samlSp/save",
+            body,
+            config.accessToken
+        );
+
+        if (res && res.result) {
+            console.error();
+            console.error(chalk.green("Success! Identity provider created."));
+            if (res.data) {
+                console.error(chalk.gray(`Response: ${JSON.stringify(res.data, null, 2)}`));
+            }
+            console.error();
+            return res;
+        }
+
+        const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+        console.error();
+        console.error(chalk.red("Error: " + msg));
+        console.error();
+        throw new Error("Create IdentityProvider Failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("身份提供商创建失败:"), error.message || error);
+        throw error;
+    }
+}
+
+module.exports = create;

package/src/identityProvider/delete.js

@@ -0,0 +1,61 @@
+const chalk = require("chalk");
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 删除身份提供商
+ * 接口: /samlSp/delete
+ * 用法：cc delete identityProvider <projectPath> <appId>
+ */
+async function remove(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const appId = argvs[3];
+
+        if (!appId) {
+            console.error();
+            console.error(chalk.red("Error: 缺少身份提供商 app ID"));
+            console.error(chalk.yellow("用法: cc delete identityProvider <projectPath> <appId>"));
+            console.error(chalk.yellow("示例: cc delete identityProvider . QbjH30d9Oy"));
+            console.error();
+            throw new Error("缺少必需参数: appId");
+        }
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green(`Deleting identity provider (${appId}), please wait...`));
+        console.error();
+
+        const result = await postClass(
+            config.setupSvc + "/api/samlSp/delete",
+            { app: appId },
+            config.accessToken
+        );
+
+        if (result && result.result) {
+            console.error();
+            console.error(chalk.green("Success! Identity provider deleted."));
+            console.error();
+            return result;
+        }
+
+        const msg = result && (result.returnInfo || result.message) ? (result.returnInfo || result.message) : "Unknown error";
+        console.error();
+        console.error(chalk.red("Error: " + msg));
+        console.error();
+        throw new Error("Delete IdentityProvider Failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("身份提供商删除失败:"), error);
+        throw error;
+    }
+}
+
+module.exports = remove;

package/src/identityProvider/doc.js

@@ -0,0 +1,46 @@
+/**
+ * identityProvider 文档入口：正文均在 `docs/` 目录。
+ */
+const fs = require("fs");
+const path = require("path");
+
+const DOCS_DIR = path.join(__dirname, "docs");
+
+function readDocFile(basename) {
+    return fs.readFileSync(path.join(DOCS_DIR, `${basename}.md`), "utf8");
+}
+
+/** 介绍文档：身份提供商能力、类型与入口 */
+function getIntroductionDoc() {
+    return readDocFile("introduction");
+}
+
+/** 开发指导：CLI 创建/查询/删除等 */
+function getDevGuideDoc() {
+    return readDocFile("devguide");
+}
+
+/**
+ * cc doc identityProvider <introduction|devguide>
+ * @param {string[]} argvs [doc, type, introduction|devguide, ...]
+ */
+function doc(argvs) {
+    const subType = argvs[2];
+    const key = String(subType || "").trim().toLowerCase();
+    if (!key) {
+        throw new Error("cc doc identityProvider 需要子命令：introduction 或 devguide");
+    }
+    if (key === "introduction") {
+        const content = getIntroductionDoc();
+        console.log(content);
+        return content;
+    }
+    if (key === "devguide") {
+        const content = getDevGuideDoc();
+        console.log(content);
+        return content;
+    }
+    throw new Error(`doc 不支持的子命令: ${subType}，请使用 introduction 或 devguide`);
+}
+
+module.exports = doc;

package/src/identityProvider/docs/devguide.md

@@ -0,0 +1,107 @@
+# CloudCC 身份提供商 CLI 命令说明
+
+## 支持的命令
+
+| 操作 | 说明 |
+|------|------|
+| `create` | 创建新身份提供商 |
+| `get` | 查询身份提供商列表 |
+| `delete` | 删除身份提供商 |
+| `download` | 下载身份提供商证书 |
+
+## CLI 命令详解
+
+### 创建身份提供商
+
+```bash
+cc create identityProvider <path> <entityid> <acsurl>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 是 | 项目路径，`.` 表示当前目录 |
+| `entityid` | 是 | 实体 ID（Service Provider Entity ID）|
+| `acsurl` | 是 | ACS URL（Assertion Consumer Service URL）|
+
+**示例：**
+
+```bash
+# 创建身份提供商
+cc create identityProvider . "http://testdev.cloudcc.cn/ccdomaingateway/apisvc" "http://testdev.cloudcc.cn/ccdomaingateway/apisvc/saml2/sp/sso/acs"
+```
+
+### 查询身份提供商列表
+
+```bash
+cc get identityProvider <projectPath> [encodedCondJson]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `encodedCondJson` | 否 | URI 编码后的查询条件 JSON |
+
+**查询条件参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| `start` | number | 起始位置，默认 0 |
+| `limit` | number | 每页条数，默认 30 |
+| `keyword` | string | 搜索关键词 |
+
+**示例：**
+
+```bash
+# 获取所有身份提供商
+cc get identityProvider .
+
+# 带查询条件（搜索关键词）
+cc get identityProvider . '%7B%22keyword%22%3A%22test%22%2C%22limit%22%3A50%7D'
+```
+
+### 删除身份提供商
+
+```bash
+cc delete identityProvider <projectPath> <appId>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `appId` | 是 | 身份提供商的 app 字段值（从列表接口获取）|
+
+**示例：**
+
+```bash
+# 删除身份提供商
+cc delete identityProvider . QbjH30d9Oy
+```
+
+### 下载身份提供商证书
+
+```bash
+cc download identityProvider <projectPath> [savePath]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `savePath` | 否 | 证书保存路径，默认当前目录 |
+
+**示例：**
+
+```bash
+# 下载证书到当前目录
+cc download identityProvider .
+
+# 下载证书到指定路径
+cc download identityProvider . ./certificates
+```

package/src/identityProvider/docs/introduction.md

@@ -0,0 +1,31 @@
+# 身份提供商介绍
+
+## 功能概述
+
+身份提供商（Identity Provider）模块用于管理 CloudCC 平台的 SAML 身份提供商配置，支持以下功能：
+
+- **查看身份提供商列表**：查询已配置的所有 SAML 身份提供商
+- **新建身份提供商**：创建新的 SAML 身份提供商配置
+- **删除身份提供商**：删除已配置的 SAML 身份提供商
+- **下载证书**：下载身份提供商的 SAML 证书
+
+## 适用场景
+
+- 企业单点登录（SSO）集成
+- SAML 2.0 身份提供商配置
+- 多身份提供商管理
+
+## 字段说明
+
+### 身份提供商字段
+
+| 字段名 | 说明 | 默认值 |
+|--------|------|--------|
+| `entityid` | Service Provider Entity ID | 用户输入 |
+| `acsurl` | Assertion Consumer Service URL | 用户输入 |
+| `issuername` | 签发者名称 | 空字符串 |
+| `nameidtype` | Name ID 类型 | FederationId |
+| `nameidformat` | Name ID 格式 | 1 |
+| `enablelogout` | 启用注销 | false |
+| `logouturl` | 注销 URL | 空字符串 |
+| `custattrname` | 自定义属性名称 | 空字符串 |

package/src/identityProvider/download.js

@@ -0,0 +1,105 @@
+const chalk = require("chalk");
+const fs = require("fs");
+const path = require("path");
+const axios = require("axios");
+const https = require("https");
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+const httpsAgent = new https.Agent({
+    rejectUnauthorized: false,
+});
+
+/**
+ * 下载身份提供商证书
+ * 接口: /LoginHistory/getExportReportURL 获取下载链接，然后下载文件
+ * 用法：cc download identityProvider <projectPath> [savePath]
+ */
+async function download(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const savePath = argvs[3] || process.cwd();
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green("Downloading certificate, please wait..."));
+        console.error();
+
+        // 确保证书保存目录存在
+        if (!fs.existsSync(savePath)) {
+            fs.mkdirSync(savePath, { recursive: true });
+        }
+
+        // 第一步：调用接口获取下载 URL
+        const result = await postClass(
+            config.setupSvc + "/api/LoginHistory/getExportReportURL",
+            {},
+            config.accessToken
+        );
+
+        if (result && result.result && result.data) {
+            const downloadUrl = result.data;
+
+            console.error(chalk.gray(`Got download URL: ${downloadUrl}`));
+            console.error(chalk.gray(`Downloading file...`));
+            console.error();
+
+            // 第二步：根据返回的 URL 下载文件
+            const response = await axios({
+                method: 'get',
+                url: downloadUrl,
+                httpsAgent: httpsAgent,
+                responseType: 'arraybuffer',
+                timeout: 120000
+            });
+
+            // 尝试从响应头获取文件名
+            let filename = "identity-provider.crt";
+            const contentDisposition = response.headers['content-disposition'];
+            if (contentDisposition) {
+                const match = contentDisposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/);
+                if (match && match[1]) {
+                    filename = match[1].replace(/['"]/g, '');
+                }
+            }
+
+            // 如果 URL 中包含文件名，也尝试从中提取
+            const urlPath = new URL(downloadUrl).pathname;
+            const urlFilename = urlPath.split('/').pop();
+            if (urlFilename && urlFilename.includes('.')) {
+                filename = urlFilename;
+            }
+
+            const filePath = path.join(savePath, filename);
+            fs.writeFileSync(filePath, response.data);
+
+            console.error();
+            console.error(chalk.green("Success! Certificate downloaded."));
+            console.error(chalk.gray(`Saved to: ${filePath}`));
+            console.error();
+
+            return {
+                result: true,
+                filePath: filePath,
+                filename: filename,
+                downloadUrl: downloadUrl
+            };
+        }
+
+        const msg = result && (result.returnInfo || result.message) ? (result.returnInfo || result.message) : "Unknown error";
+        throw new Error("Get download URL failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("证书下载失败:"), error.message || error);
+        throw error;
+    }
+}
+
+module.exports = download;

package/src/identityProvider/get.js

@@ -0,0 +1,70 @@
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+const chalk = require("chalk");
+
+/**
+ * 查询身份提供商列表
+ * 接口: /samlSp/queryList
+ * 用法：cc get identityProvider <projectPath> [encodedCondJson]
+ */
+async function get(argvs, isMcp = false) {
+    const projectPath = argvs[2] || process.cwd();
+    const condArg = argvs[3];
+
+    let body = {};
+    if (condArg) {
+        try {
+            body = JSON.parse(decodeURI(condArg));
+        } catch (e) {
+            try {
+                body = JSON.parse(condArg);
+            } catch (e2) {
+                throw new Error("Get IdentityProvider Failed: encodedCondJson 解析失败，请传 encodeURI(JSON.stringify(...))");
+            }
+        }
+    }
+
+    const config = await getPackageJson(projectPath);
+
+    const res = await postClass(
+        config.setupSvc + "/api/samlSp/queryList",
+        {
+            start: 0,
+            limit: 30,
+            keyword: "",
+            ...body
+        },
+        config.accessToken
+    );
+
+    if (res && res.result) {
+        const data = res.data;
+        let rawList = [];
+        if (Array.isArray(data)) {
+            rawList = data;
+        } else if (data && Array.isArray(data.list)) {
+            rawList = data.list;
+        } else if (data && Array.isArray(data.data)) {
+            rawList = data.data;
+        } else if (data && typeof data === "object") {
+            rawList = Object.keys(data)
+                .filter((key) => /list$/i.test(key) && Array.isArray(data[key]))
+                .flatMap((key) =>
+                    data[key].map((item) => ({
+                        ...item,
+                        __group: key
+                    }))
+                );
+        }
+
+        if (!isMcp) {
+            console.log(JSON.stringify(rawList, null, 2));
+        }
+        return rawList;
+    }
+
+    const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+    throw new Error("Get IdentityProvider Failed: " + msg);
+}
+
+module.exports = get;

package/src/identityProvider/index.js

@@ -0,0 +1,12 @@
+const cc = {}
+cc.create = require("./create")
+cc.delete = require("./delete")
+cc.get = require("./get")
+cc.download = require("./download")
+cc.doc = require("./doc")
+
+function main(action, argvs) {
+    cc[action](argvs)
+}
+
+module.exports = main;

package/src/permission/add.js

@@ -0,0 +1,164 @@
+const chalk = require('chalk');
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+const inquirer = require('inquirer');
+
+/**
+ * 获取用户视图ID
+ * @param {Object} config - 项目配置
+ * @returns {Promise<string>} 视图ID
+ */
+async function getUserViewId(config) {
+    const res = await postClass(
+        config.setupSvc + "/api/usermange/queryUser",
+        {},
+        config.accessToken
+    );
+
+    if (res && res.result && res.data) {
+        // 优先使用返回的 viewId
+        if (res.data.viewId) {
+            return res.data.viewId;
+        }
+        // 否则使用 viewList 中的第一个
+        if (Array.isArray(res.data.viewList) && res.data.viewList.length > 0) {
+            return res.data.viewList[0].id;
+        }
+    }
+
+    throw new Error("未找到用户视图");
+}
+
+/**
+ * 查询可选用户列表
+ * @param {Object} config - 项目配置
+ * @param {string} viewId - 视图ID
+ * @param {string} keyword - 搜索关键词
+ * @returns {Promise<Array>} 用户列表
+ */
+async function queryUserList(config, viewId, keyword = '') {
+    const res = await postClass(
+        config.setupSvc + "/api/usermange/queryUserList",
+        {
+            start: 0,
+            limit: 10000,
+            viewId: viewId,
+            keyword: keyword,
+            notisusering: "true"
+        },
+        config.accessToken
+    );
+
+    if (res && res.result && res.data) {
+        return res.data.list || [];
+    }
+
+    throw new Error("查询用户列表失败");
+}
+
+/**
+ * 添加权限集分配用户
+ * 用法：cc add permission <projectPath> <permsetId> [userIds...]
+ * 如果不指定 userIds，会进入交互式选择
+ * @param {Array} argvs - 命令行参数数组
+ * @param {boolean} isMcp - 是否为MCP模式
+ * @returns {Promise<Object>} 添加结果
+ */
+async function add(argvs, isMcp = false) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const permsetId = argvs[3];
+        // 从第4个参数开始是用户ID
+        let userIds = argvs.slice(4);
+
+        if (!permsetId) {
+            console.error();
+            console.error(chalk.red('Error: 缺少权限集ID'));
+            console.error('用法: cc add permission <path> <permsetId> [userId1] [userId2] ...');
+            console.error('示例:');
+            console.error('  cc add permission . "cac20258F0E4ABBnTxwi"                        # 交互式选择用户');
+            console.error('  cc add permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT"   # 直接指定用户ID');
+            console.error();
+            throw new Error('缺少必需参数: permsetId');
+        }
+
+        const config = await getPackageJson(projectPath);
+
+        // 如果没有指定用户ID，进入交互式选择
+        if (userIds.length === 0) {
+            console.log();
+            console.log(chalk.blue('正在获取用户列表...'));
+
+            const viewId = await getUserViewId(config);
+            const userList = await queryUserList(config, viewId);
+
+            if (userList.length === 0) {
+                console.log(chalk.yellow("没有可用的用户"));
+                return { success: false, message: "没有可用的用户" };
+            }
+
+            // 交互式选择用户
+            const choices = userList.map(user => ({
+                name: `${user.name || '未命名'} (${user.loginname || ''}) - ${user.id}`,
+                value: user.id,
+                short: user.name || user.id
+            }));
+
+            const { selectedUsers } = await inquirer.prompt([
+                {
+                    type: 'checkbox',
+                    name: 'selectedUsers',
+                    message: '请选择要分配的用户（使用空格键选择，回车确认）:',
+                    choices: choices,
+                    validate: (input) => input.length > 0 || '请至少选择一个用户'
+                }
+            ]);
+
+            userIds = selectedUsers;
+        }
+
+        if (userIds.length === 0) {
+            console.log(chalk.yellow("未选择任何用户"));
+            return { success: false, message: "未选择任何用户" };
+        }
+
+        console.log();
+        console.log(chalk.blue(`正在为权限集 ${permsetId} 分配 ${userIds.length} 个用户...`));
+
+        const res = await postClass(
+            config.setupSvc + "/api/permissionGroup/addUsersetup",
+            {
+                id: permsetId,
+                ids: userIds.join(',')
+            },
+            config.accessToken
+        );
+
+        if (res && res.result) {
+            if (!isMcp) {
+                console.log();
+                console.log(chalk.green('✓ 用户分配成功'));
+                console.log(`  权限集ID: ${permsetId}`);
+                console.log(`  分配用户数: ${userIds.length}`);
+                console.log();
+            }
+            return {
+                success: true,
+                permsetId: permsetId,
+                userCount: userIds.length,
+                userIds: userIds
+            };
+        }
+
+        const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+        throw new Error("分配用户失败: " + msg);
+
+    } catch (error) {
+        if (!isMcp) {
+            console.error(chalk.red("Error: " + error.message));
+        }
+        throw error;
+    }
+}
+
+module.exports = add;