登录与身份认证

PawSQL 使用身份认证确认“谁在访问”，再通过组织、项目、角色和工作空间权限决定“可以访问什么”。能够成功登录并不表示用户自动拥有全部功能权限。

​

目标

了解 PawSQL Web、IDE、MCP 和 API 的认证方式，安全管理账号、密码和访问令牌。

​

准备工作

• 已拥有 PawSQL 账号或管理员发放的凭据；
• 知晓所连接 PawSQL 环境的服务地址。

​

认证与授权的区别

当用户可以登录但看不到菜单、项目或工作空间时，通常需要检查授权，而不是重新设置密码。

​

不同入口的认证方式

​

登录 Web 控制台

​

使用访问令牌

创建令牌时建议：

• 为 IDE、MCP、CI/CD 和临时测试分别创建令牌；
• 使用能够识别用途的令牌名称；
• 只授予任务所需的权限范围；
• 设置合理有效期，并建立轮换计划；
• 创建后立即保存到密码管理器、系统密钥链或平台密钥库；
• 不再使用时及时吊销。

​

客户端凭据配置

优先级建议如下：

1. 客户端或操作系统提供的安全凭据存储；
2. CI/CD 平台的加密变量或密钥管理；
3. 权限受限且不进入版本控制的环境配置；
4. 避免使用命令行明文参数，因为它可能进入终端历史或进程信息。

客户端配置完成后，应执行连接测试，并确认令牌绑定的是正确账号和环境。

​

账号安全

• 每位用户使用独立账号，不共享管理员账号。
• 使用组织支持的强身份验证方式。
• 定期检查高权限账号、长期未使用账号和活动令牌。
• 离职、转岗或项目结束后及时回收权限和吊销令牌。
• 发现凭据可能泄露时，立即吊销并创建新凭据，同时检查相关审计日志。

​

预期结果

登录成功后看到账号、组织和项目，所需菜单与工作空间也可见。

​

验证

登录后确认账号、组织和项目与预期一致，并检查所需功能与工作空间是否可见。

​

常见问题

​

提示账号或密码错误

确认服务地址和账号环境正确，再使用平台支持的密码重置或联系管理员处理。不要连续尝试大量密码。

​

访问令牌无效

检查令牌是否过期、被吊销、复制不完整或连接到了错误的 PawSQL 服务。

​

认证成功但没有权限

确认组织成员关系、项目角色、工作空间权限和 License。认证成功只说明身份有效。

​

统一身份认证后返回登录页

检查浏览器 Cookie、系统时间、回调地址、域名和企业身份服务配置，并保存相关错误信息交由管理员排查。

​

下一步