First use

第一次使用 SandIAM

本页给第一次配置应用的管理员。先由宿主管理员完成安装与升级，确认你能打开 SandIAM → 总览，并拥有该应用的管理权限。

选择这次要完成的目标

总览的“这次要完成什么？”按当前账号权限显示可办理事项。选择目标后，再选择已有应用；只有确实需要新应用且你有登记权限时才登记。不要为了继续向导重复创建客户主体、应用或环境。

你要完成什么	选择的目标	完成结果
给应用提供用户登录	让用户登录应用	账号能登录，错误密码和退出后的旧会话被拒绝。
管理已登录用户的访问权限	控制权限和数据范围	有权操作允许，无权操作和范围外访问拒绝。
让应用后端调用另一个服务	让后端调用服务	真实调用完成，错误受众、无权动作及撤销后的凭证被拒绝。

先完成一次用户登录

由应用负责人提供应用名称、允许的开户方式和初始账号信息；登录门户地址中的客户主体与应用代码由管理员提供，不用猜内部编号。

1. 在总览选择“让用户登录应用”，选择你负责的已有应用。
2. 按当前步骤核对认证设置，明确邀请开户还是开放注册；已有配置优先复用。
3. 配置并启用该应用的“内置门户登录外观”，核对应用显示名称、密码登录和注册方式。认证设置与部署开关也须允许所选方式。
4. 按邀请流程开通账号，或使用已开放的注册入口。到应用的实际登录门户登录；内置应用门户入口为 /app/sand-iam/account/，使用管理员提供的应用上下文。不要把 SandAdmin 后台管理员登录当作应用用户登录。
5. 验证正确密码登录、错误密码拒绝，再退出并确认旧会话不能继续访问账户。到本应用的审计入口核对对应结果。

看到后台记录保存成功只说明配置已保存；完成第 5 步才能确认这次登录目标已达成。自有应用登录界面接入由开发者按应用接入完成；本目标不要求先创建业务资源或权限策略。

遇到问题

• 没看到 SandIAM 菜单或总览：由宿主管理员核对安装结果、菜单权限及管理端构建激活。
• 没有某个目标或当前步骤无权办理：由该应用管理员完成对应步骤，不通过更换应用绕过权限。
• 提示登录外观未配置：核对应用、客户主体代码和已启用的登录外观；已有停用记录先确认是否恢复，不重复新建。
• 保存失败：按页面错误提示处理并保留草稿；返回目标后重新读取状态，不重复创建。

继续配置人员权限见管理员操作，应用用户日常操作见应用用户操作，系统调用见机器调用。

文档首页 · 版本更新

详细操作文档的维护入口统一在本 Wiki。本次源码整改后的后续构建不再复制整套指南；已公开 v0.8.3 的 1053 条目 ZIP 保留原载荷，本轮不重打包或替换发行件。离线操作前取得所选版本对应的指南。