CLI 身份验证

在本地登录、提供 CI 凭据,并确认命令将使用的身份。

CLI 按以下顺序使用首个可用凭据:本次调用的全局 --api-key、LINGO_API_KEY,最后是 ~/.lingo/credentials.json 中保存的密钥或浏览器会话。切换账号时,请注意:新保存的登录信息无法覆盖 shell 已提供的密钥。

登录 #

sh
lingo login
lingo whoami

登录时若未提供密钥,CLI 会打开浏览器进行 OAuth 身份验证,并保存会话。CLI 会在会话即将过期时自动刷新;如果刷新失败,请重新登录。

登录成功并不代表组织设置已完成,也不代表已满足每个组织的 SSO 要求。如果关联操作将你引导回网页应用,请先完成该组织的设置或 SSO 登录,再重试。

lingo login --api-key <value> 会验证并保存密钥,而其他命令中的全局 --api-key 仅对该次调用生效。参数与值分开的形式和 --api-key=value 形式均可识别。建议通过机密注入提供凭据,避免在命令行中直接传入机密,以免其出现在 shell 历史记录、进程检查结果或诊断信息中。

CLI 创建凭据目录时使用 0700 权限模式,创建凭据文件时使用 0600 权限模式。

查看当前身份 #

sh
lingo whoami --json

结果会显示身份验证类型,以及可用的组织和本地化引擎上下文。查看当前身份的命令会在线验证凭据。连接失败时,可能返回有限的已保存信息;如果身份验证被拒绝,则无法确认身份有效。

在关联 checkout 之前,请确认当前身份。保存的资源 ID 只用于指定要使用的资源,并不会赋予凭据使用该资源的权限。

退出登录 #

sh
lingo logout

退出登录会移除持久化保存的凭据,但环境变量中的密钥或调用标志仍可用于后续命令的身份验证。如果不再打算使用这些覆盖设置,请将其从 shell 中移除。退出登录不会撤销密钥、删除资源或解除项目关联。

CI #

通过运行器的机密管理机制提供 LINGO_API_KEY,并仅提交不含机密的项目配置。请在目标项目的根目录下运行 CLI,不要将开发者主目录中的会话复制到 CI 中。

原生 GitHub 集成有自己的授权和运行审批机制,与自行管理的 CLI 运行器相互独立。