用途:在 JFrog Platform 上创建用户和组,通常在 onboarding 流程中发现清单引用的用户或组不存在时调用,也可单独使用。
主要能力:接收 users、groups 和 default_password 输入;先创建组再创建用户,支持创建时分配组;创建用户后自动调用密码过期接口,强制用户首次登录 Artifactory 时修改密码;创建完成后可校验用户与组是否存在。
使用方式:优先使用 jf api,curl 为回退方案。凭据从 JFROG_URL、JFROG_ACCESS_TOKEN 读取,未设置时尝试加载 .env。默认密码按清单 jfrog.default_password 或交互式提示获取,需至少 8 位且含大小写字母和数字。创建组:jf api /access/api/v2/groups -X POST;创建用户:jf api /access/api/v2/users -X POST;密码过期:jf api /access/api/v2/users/$JFROG_USER_NAME/password/expire -X POST。创建前先 GET 检查是否已存在,200 跳过,404 则创建。
适用场景:onboarding 编排中补齐缺失成员;批量创建用户与组并分配组;独立执行用户/组创建。
限制与注意:需要 full_network 权限;组必须先于用户创建;每个用户至少属于一个组,未指定时默认 readers(内置组无需创建);循环中不要用 USERNAME 变量名,改用 JFROG_USER_NAME 等;不要记录或回显密码;清单中的 default_password 属敏感信息,建议用 .env 管理。错误处理:201 成功,409 视为已存在跳过,400 报告后继续,403 中止,415 需补 Content-Type 头。