# 登录、激活与找回密码

Raise 的统一身份登录与凭据设置页面。用于进入工作台、账号管理或组织应用前的身份验证，支持通过密码、通行密钥或公司账号登录，并提供新成员激活设置密码与找回密码流程。

## 谁能用

所有需要访问[工作台](/guide/workspace)、[账号设置](/guide/account)或组织应用的成员与用户均可打开登录页。打开登录页不要求已具备组织成员身份，但实际登录受账号状态与组织策略控制：

- **未被邀请的外部账号**：如果组织未开启公司账号自动创建账号功能，且管理员尚未邀请你加入，使用公司账号登录后会提示「你的公司账号还没有在这里开通。请联系你们的管理员，邀请你加入。」。
- **账号被锁定**：当凭据输入错误尝试次数过多时，账号会被系统锁定，界面提示「失败次数太多，账号已被锁定。请联系你们的管理员。」。
- **运营与开发者账号**：运营或开发者账号可以通过同一登录页完成验证，但尝试进入[工作台](/guide/workspace)会被系统拒绝（详见 [产品介绍与架构](/guide/what-is)）。
- **组织策略控制**：组织管理员在「我的组织」的「安全」设置（见 [安全设置](/admin/security)）中配置登录策略，决定是否允许通行密钥、是否强制执行第二重验证，以及接入哪些公司账号。

## 怎么打开

1. 在浏览器中访问[工作台](/guide/workspace)（`https://app.{base}` 或组织专属域名），处于未登录状态时，系统会自动跳转到统一登录页。
2. 收到邀请邮件或管理员提供的邀请信息时，打开其中的「登录地址：」`https://{组织主机}`，浏览器同样会自动进入登录流程。
3. 使用公司账号登录时，在外部公司平台完成认证后，浏览器会回到本系统继续登录。
4. 身份验证成功后，页面会自动跳转回最初发起登录的应用（通常是工作台，或邀请/链接指定的业务页面）。

> **注意**
>
> 请不要将登录页面地址直接保存为浏览器书签或设为首页。登录须从工作台或邀请地址跳转进入，单独打开登录页会提示过期或无法登录。

## 界面一览

在宽屏设备上，登录页面左侧展示产品品牌与核心特点，右侧显示交互表单；在手机等窄屏设备上，页面仅显示交互表单，顶部展示产品标志与语言切换。

### 公共外壳

- **语言切换**：页面右上角提供「简体中文」与「English」切换按钮。
- **页脚链接**：若组织品牌配置了相关地址，页脚会显示「需要帮助」「联系支持」「隐私政策」与「服务条款」。
- **品牌卖点**：宽屏左侧默认展示核心特点（组织可自定义覆盖）：
  - 核心标语：「人机高效协同，关键操作由人把关。」
  - 说明：Raise 将智能对话、业务数据与核心应用整合在同一工作台中。
  - 三项要点：
    - 「安全可控：助手仅读取授权数据，改动先起草、由人确认」
    - 「同屏协同：智能对话与业务应用并排展示，无需多系统切换」
    - 「合规可溯：关键操作全程留痕，提供完整不可篡改的审计记录」
- **加载提示**：页面数据加载时，辅助阅读提示为「加载中」。

### 流程界面说明

登录页面的交互步骤由系统根据账号状态与组织策略推进：

| 步骤界面 | 关键元素与说明 |
|---|---|
| 「登录」（识别） | 输入「登录名」（若组织已提供可自动预填），点击按钮「下一步」。若组织允许通行密钥，显示按钮「用通行密钥登录」；若组织配置了公司账号，显示「或者用公司账号登录」区域及对应的「用……登录」按钮（按钮文字显示配置的公司名称）。 |
| 「输入密码」 | 顶部显示当前填写的登录名，附带链接「更换」（点击返回重新输入登录名）；输入「密码」，点击按钮「登录」；下方提示「第一次登录（还没有密码），或忘记了密码？」，提供按钮「输入激活码 / 验证码，设置密码」。 |
| 「用验证码设置密码」 | 用于新成员激活或找回密码。顶部显示登录名并提供链接「返回」（点击返回密码步骤）。若配置了邮件服务，显示说明「验证码将发到账号邮箱，邀请邮件里的验证码也可用。」及按钮「发送验证码」（发送后提示「如果这个账号存在，验证码已发到它的邮箱。几分钟内没收到，请看垃圾邮件，或再发一次。」，倒计时期间显示几秒后可重发，倒计时结束后显示按钮「重新发送验证码」）；若未配置邮件服务，显示说明「未配置邮件服务，请向管理员索取验证码。」，不提供发送按钮。提供输入字段「验证码」「新密码」「再输一次」；需设置用户名时显示「你的用户名」；底部提交按钮为「设置密码并登录」或「设置密码、用户名并登录」。 |
| 「第二重验证」 | 账号配置了验证器 App 时，说明提示「输入验证器 App 显示的 6 位数字。」，输入「验证码」，点击按钮「验证」；若仅配置了通行密钥，说明提示「用你的通行密钥确认是你本人。」，提供按钮「用通行密钥验证」；两者均有时以验证器为主，「用通行密钥验证」作为次要选项。 |
| 「设置第二重验证」 | 组织要求强制启用验证器 App 时出现。说明提示「组织要求使用验证器 App。扫描二维码或输入密钥，再输入 6 位数字。」展示用于扫描的二维码（图片说明为「用验证器 App 扫描的二维码」）以及密钥展示区「手动输入的密钥」（支持复制），输入「验证码」后点击按钮「完成设置」。 |
| 「设置通行密钥？」 | 登录成功后出现。说明提示「下次可以不用密码，用指纹、面容或设备的解锁码登录。」包含按钮「设置通行密钥」「以后再说」以及「不再提示」（附带脚注「之后想设置，可以在账号设置里重新打开提示。」）。 |
| 「需要另一种验证方式」 | 当账号设置了当前登录页暂不支持的第二因子时出现。说明提示「账号设置了……，此登录页暂不支持。请联系管理员，或添加验证器 App。」（涉及方式包括「安全密钥」「通行密钥」「短信验证码」「邮件验证码」「验证器 App」）。 |
| 「无法登录」 | 标题为「无法登录」，正文显示具体的错误原文，提供按钮「回到首页」（点击后回到登录首页）。常在身份服务不可达或企业登录失败时出现。 |
| 「这次登录已经过期」 | 说明提示「请回到应用重新登录。」提供按钮「返回」（触发浏览器后退）。在认证请求过期或会话中断时出现。 |
| 「正在进入…」 | 说明提示「马上就好。」完成全部验证后短暂显示，随后自动跳转回发起登录的应用。 |

## 常用操作

### 用密码登录

![登录页：先输入登录名](/shots/signin-identify.webp)

图：登录页：先输入登录名

1. 「登录名」：邮箱或用户名
2. 「下一步」：进入输入密码

1. 在[工作台](/guide/workspace)等应用中进入登录页面。
2. 在「登录名」输入框中输入邮箱或用户名。若未输入即点击，提示「请输入登录名（通常是邮箱）」；若输入超过 200 个字，提示「登录名太长」。
3. 点击「下一步」，页面进入「输入密码」步骤。
4. 在「密码」输入框中输入密码。若未输入即点击，提示「请输入密码」；若输入超过 512 个字符，提示「密码太长」。
5. 点击「登录」。验证通过后进入第二重验证、通行密钥提醒或直接进入应用；若登录名或密码有误，提示「登录名或密码不对。」。

### 第一次登录激活或找回密码

新成员首次激活账号与忘记密码找回走相同的操作路径：

![「用验证码设置密码」：第一次登录或忘记密码时](/shots/signin-activate.webp)

图：「用验证码设置密码」：第一次登录或忘记密码时

1. 「验证码」：管理员给你的激活码，或邮件里的验证码
2. 「新密码」：按组织的密码规则设置
3. 「再输一次」：与新密码一致

1. 在登录识别步骤输入登录名，点击「下一步」，进入「输入密码」步骤。
2. 在页面下方「第一次登录（还没有密码），或忘记了密码？」区域，点击按钮「输入激活码 / 验证码，设置密码」，页面切换至「用验证码设置密码」。
3. 获取验证码：
   - 若系统已配置邮件服务：在表单上方点击「发送验证码」，系统发送验证码并提示「如果这个账号存在，验证码已发到它的邮箱。几分钟内没收到，请看垃圾邮件，或再发一次。」。如需重新发送，等待 60 秒倒计时结束后点击「重新发送验证码」。如果已有邀请邮件中的验证码，可直接使用。
   - 若系统未配置邮件服务：页面说明提示「未配置邮件服务，请向管理员索取验证码。」，此时没有发送按钮，需向组织管理员索取一次性验证码。
4. 在「验证码」框中输入收到的验证码（最多 32 个字符）。未输入即提交提示「请输入邮件里的验证码」；验证码错误或过期提示「验证码不对或已过期。可以重新发送一个。」。
5. 在「新密码」与「再输一次」框中输入新密码。未设置提示「请设置一个密码」；密码过弱提示「密码不符合要求：请用更长的密码，并混合大小写字母、数字和符号。」；两次输入不一致提示「两次输入的密码不一致」。
6. 若页面显示「你的用户名」框，输入希望使用的用户名（规则为「小写字母、数字、点、下划线、连字符，3–32 位，首尾必须是字母或数字」）。未输入提示「请先选一个用户名，再设置密码。」；格式不符提示「用户名格式不对：」附带规则说明；已被占用提示「这个用户名已被占用，请换一个。」；格式合规可用时提示「可以使用」，或参考「试试：」给出的建议。
7. 在表单底部点击「设置密码并登录」（需填写用户名时按钮为「设置密码、用户名并登录」）。设置成功后，账号完成激活或找回密码，并直接登录进入应用。

### 用通行密钥登录

1. 确认组织已允许使用通行密钥（在[安全设置](/admin/security)中开启「允许通行密钥」），且你的账号已在此前登记过通行密钥。
2. 在「登录名」输入框中输入登录名（建议先填登录名）。
3. 点击输入框下方的「用通行密钥登录」，浏览器弹出系统生物识别或安全验证窗口。
4. 在设备弹窗中通过指纹、面容或设备解锁码确认本人身份（必须包含用户验证方可作为首要登录因子）。
5. 验证通过后直接进入应用。若在设备弹窗中点击取消，提示「已取消通行密钥操作。」；若生物识别未通过，提示「通行密钥没有通过验证。请再试一次，或用密码登录。」；若账号未绑定通行密钥、组织未允许或账号不存在，提示「这个账号没有可用的通行密钥，请用密码登录。」。

### 用公司账号登录

1. 在「或者用公司账号登录」区域，点击对应的「用……登录」按钮（按钮名称显示组织配置的公司显示名）。
   - **企业微信**：登录卡片直接换成企业微信二维码（「用企业微信扫码登录」，卡片里只有二维码），页面不跳走。用手机企业微信扫码并确认后自动进入应用。二维码过期时在二维码上点刷新；二维码显示不出来时，点下方「二维码显示不出来？打开企业微信登录页」改到企业微信官方页面扫码；想换别的方式点「用其他方式登录」。
   - **其他公司身份源**：页面跳转至外部公司身份认证平台。
2. 在二维码或外部公司平台页面中完成身份认证。
3. 认证成功后，浏览器自动进入系统完成登录。若认证失败，提示「企业登录没有成功，请重试，或用账号密码登录。」或「企业登录没有成功。」，点「重新登录」回到这次登录重新开始，点「回到首页」回到你要进入的应用首页；若组织未开启自动创建账号且你未收到邀请，提示「你的公司账号还没有在这里开通。请联系你们的管理员，邀请你加入。」；若使用公司邮箱的账号已存在但未关联，提示「用你们公司邮箱的账号已经存在（可能还没和公司账号关联）。请联系管理员处理。」。

> **提示**
>
> 系统目前尚未在真实企业微信环境中完成验证，实际使用请以组织具体对接情况为准。

### 「上次使用」标签

在同一个浏览器里再次打开登录页时，上一次**成功登录**所用的方式按钮右上角会显示「上次使用」：账号密码登录标在「下一步」上，通行密钥标在「用通行密钥登录」上，公司账号标在对应的「用……登录」上。只有登录页同时提供两种以上方式时才显示。

上一次用的是企业微信时，登录页打开后直接显示企业微信二维码；点「用其他方式登录」回到账号输入，本次不再自动弹出。

这个记录只存在当前浏览器里（不会上传），清除浏览器网站数据或用无痕窗口时不显示。

### 完成第二重验证与设置

#### 验证已有第二因子

1. 若账号配置了验证器 App：
   - 打开手机中的验证器应用，查看当前显示的 6 位动态验证码。
   - 在「第二重验证」界面的「验证码」框中输入 6 位数字。
   - 点击「验证」，通过后进入应用。若验证码输入错误，提示「验证码不对，请看验证器 App 里最新的一个。」。
2. 若账号配置了通行密钥（或需用通行密钥验证）：
   - 在「第二重验证」界面点击「用通行密钥验证」。
   - 在设备弹窗中通过指纹、面容或解锁码确认本人身份，通过后进入应用。

#### 设置验证器 App

1. 登录后若组织要求使用验证器 App，页面自动进入「设置第二重验证」。
2. 打开手机验证器应用，扫描屏幕上的二维码（二维码图片说明为「用验证器 App 扫描的二维码」），或复制「手动输入的密钥」区域的密钥手动录入验证器。
3. 在「验证码」框中输入验证器当前生成的 6 位数字。
4. 点击「完成设置」，绑定成功后完成验证并进入后续流程。

### 设置或跳过通行密钥

登录成功后，若组织允许使用通行密钥、当前账号尚未登记通行密钥，且你此前未选择过不再提示，页面会显示「设置通行密钥？」。

1. **立即设置**：
   - 点击「设置通行密钥」。
   - 在浏览器弹出的系统弹窗中，通过指纹、面容或设备锁屏密码完成登记。登记后下次登录即可免密进入。
2. **本次跳过**：
   - 点击「以后再说」。系统直接进入应用，下次登录时仍会继续提示。
3. **不再提示**：
   - 点击「不再提示」。系统直接进入应用，后续登录不再弹窗提示（该偏好与账号关联，更换浏览器同样生效）。如后续想重新设置，可前往[账号设置](/guide/account)重新开启提示。

## 状态说明

### 账号状态流转

在管理员的成员列表中，新添加但尚未设置密码的账号处于「待激活」状态：

`待激活 → 正常`

成员在登录页通过验证码成功设置密码并登录后，账号状态自动转为正常。

### 登录步骤流转

登录过程由系统按不同登录方式分别推进：

- **密码登录路径**：`「登录」（识别） → 「输入密码」 → （必要时「第二重验证」） → （符合条件时「设置通行密钥？」） → 「正在进入…」`
- **激活与找回路径**：`「登录」（识别） → 「输入密码」（点击设置密码） → 「用验证码设置密码」 → 「正在进入…」`
- **通行密钥登录路径**：`「登录」（识别） → 系统生物识别 / 设备码验证 → 「正在进入…」`
- **公司账号登录路径**：`「登录」（识别） → 跳转企业身份源认证 → 企业回调验证 → 「正在进入…」`

## 让助手帮你做

助手无法在登录页面执行任何操作。

登录页面独立于[工作台](/guide/workspace)，运行在独立的身份验证服务中。出于系统安全与凭据保护限制：

- 助手不能代填登录名或密码。
- 助手不能代收、代填激活码或动态验证码。
- 助手不能绕过或代办生物识别与第二重验证。
- 助手不能修改组织的登录与安全策略。

如果遇到登录或凭据问题，请按照页面提示自行操作，或联系组织管理员处理。

## 设置

### 成员个人设置

| 设置项 | 作用 | 选项 | 默认值 |
|---|---|---|---|
| 语言切换 | 控制登录页面显示的语言 | 「简体中文」「English」 | 未设置时为简体中文 |
| 通行密钥提示 | 控制后续登录是否继续提示设置通行密钥 | 「以后再说」「不再提示」 | 会再次提示（未选择不再提示时） |

> **提示**
>
> 若此前在登录时选择了「不再提示」，后续想重新绑定通行密钥，可以在登录进入应用后，前往[账号设置](/guide/account)重新开启「登录后提醒我设置通行密钥」。

### 组织全局策略

以下安全策略由管理员在[安全设置](/admin/security)中配置，登录成员仅承受配置结果：

- 是否开启「允许通行密钥」。
- 是否强制启用「第二重验证」。
- 接入的企业身份源列表及按钮显示名称。
- 公司账号首次登录时是否自动创建账号。
- 邮件服务是否配置（决定激活与找回界面是否有「发送验证码」按钮）。

## 注意事项

- **安全防枚举设计**：
  - 输入不存在的登录名或错误的密码时，系统均统一提示「登录名或密码不对。」，避免攻击者探测系统中是否存在该账号。
  - 账号未登记通行密钥、组织不允许使用通行密钥或账号不存在时，系统均统一提示「这个账号没有可用的通行密钥，请用密码登录。」。
- **登录频次与限流限制**：
  - 系统以 10 分钟为一个时间窗口统计请求频次。
  - 同一 IP 地址在 10 分钟内限制约 40 次请求；同一登录名在 10 分钟内限制约 10 次请求。
  - 触发限流时，页面提示「尝试得太频繁了，请等几分钟再试。」。
  - 连续输入错误导致账号被锁定时，页面提示「失败次数太多，账号已被锁定。请联系你们的管理员。」。
- **认证请求有效期与会话状态**：
  - 登录会话与认证请求受时效限制。若请求过期，页面提示「这次登录请求已经过期，请回到应用重新登录。」或直接展示「这次登录已经过期」界面。
  - 登录会话若中途异常中断，页面提示「登录已中断，请重新开始。」。
  - 若身份服务暂时不可达，提示「身份服务暂时连不上，稍后再试。」或展示「无法登录」界面。
  - 若管理员在后台停用了某种登录方式，提交时提示「这种登录方式不可用。」。
- **输入字段长度与格式规范**：
  - 「登录名」：不能超过 200 个字。
  - 「密码」：不能超过 512 个字符。
  - 「验证码」：邮件验证码为 4–32 位字母与数字，输入框最多允许输入 32 个字符；验证器动态码为 6–8 位数字（输入框要求输入 6 位数字）。
  - 「你的用户名」：小写字母、数字、点、下划线、连字符，3–32 位，首尾必须是字母或数字。
- **通行密钥登记范围与限制**：通行密钥的凭据范围绑定在登录服务域名（`id.{base}`），无法在[账号设置](/guide/account)页面直接登记或管理。账号设置页只能重新开启登录提示，不能当场新增、列出、重命名或删除通行密钥。「不再提示」的偏好记录保存在账号中，更换浏览器后依然有效。
- **注册限制**：系统未开启成员自主注册功能，普通用户无法自行申请开通账号，必须由管理员邀请加入或通过企业身份源授权。

### 错误提示速查

| 界面提示原文 | 触发原因与处理方法 |
|---|---|
| 「登录名或密码不对。」 | 登录名不存在或密码输入错误。 |
| 「验证码不对，请看验证器 App 里最新的一个。」 | 验证器 App 动态验证码输入错误或已失效。 |
| 「验证码不对或已过期。可以重新发送一个。」 | 邮件激活码或管理员给出的验证码错误或已过有效期。 |
| 「密码不符合要求：请用更长的密码，并混合大小写字母、数字和符号。」 | 密码强度过低，未满足长度或字符复杂度要求。 |
| 「失败次数太多，账号已被锁定。请联系你们的管理员。」 | 凭据错误尝试次数超限导致账号锁定，需管理员协助解锁。 |
| 「尝试得太频繁了，请等几分钟再试。」 | 10 分钟内同一 IP 地址或登录名尝试次数超出上限，需等待几分钟。 |
| 「这次登录请求已经过期，请回到应用重新登录。」 | 登录页面停留超时导致认证请求失效，请返回应用重新发起。 |
| 「身份服务暂时连不上，稍后再试。」 | 身份验证后端服务暂时不可用，请稍后刷新重试。 |
| 「登录已中断，请重新开始。」 | 登录会话中断，需重新开始登录流程。 |
| 「这种登录方式不可用。」 | 组织未允许或已停用当前选择的登录验证方式。 |
| 「用你们公司邮箱的账号已经存在（可能还没和公司账号关联）。请联系管理员处理。」 | 公司邮箱对应的账号已存在，但尚未完成与企业身份源的绑定。 |
| 「请先选一个用户名，再设置密码。」 | 激活账号时未填写用户名。 |
| 「用户名格式不对：……」 | 用户名字段不符合规范字符集或长度要求（附带规则说明）。 |
| 「这个用户名已被占用，请换一个。」 | 填写的用户名已被组织内其他成员使用。 |
| 「这个账号没有可用的通行密钥，请用密码登录。」 | 账号未绑定通行密钥、组织未开启通行密钥或账号不存在。 |
| 「通行密钥没有通过验证。请再试一次，或用密码登录。」 | 设备生物识别或锁屏密码校验未通过。 |
| 「已取消通行密钥操作。」 | 主动取消了系统或浏览器的通行密钥调用弹窗。 |
| 「你的公司账号还没有在这里开通。请联系你们的管理员，邀请你加入。」 | 组织未开启自动创建账号且管理员尚未邀请该企业账号。 |
| 「出错了，请重试。」 | 其他未分类系统异常。 |

## 目前不支持

- 登录页面中未提供名为「忘记密码」的独立按钮或独立密码重置链接（找回密码走验证码设置密码流程）。
- 在[账号设置](/guide/account)中查看通行密钥列表、重命名、删除或直接登记通行密钥。
- 安全密钥（U2F）作为当前登录页面可直接完成的第二因子（会落入「需要另一种验证方式」提示）。
- 短信验证码或邮件验证码作为当前登录页面可直接完成的第二因子。
- 普通成员自主注册账号。
- 组织在前端界面自助接入企业微信、钉钉、飞书或 SAML 等企业身份源（需由平台协助配置）。

## 常见问题

#### 忘记密码后，为什么在登录页找不到「忘记密码」按钮？
登录页面未设置名为「忘记密码」的按钮。找回密码与新成员激活使用同一流程：在输入登录名后进入「输入密码」步骤，点击下方的「输入激活码 / 验证码，设置密码」，通过邮箱接收验证码或向管理员索取验证码后，即可重新设置密码并完成登录。

#### 为什么点击「用通行密钥登录」提示「这个账号没有可用的通行密钥，请用密码登录。」？
可能由三种情况导致：你的账号尚未在当前设备绑定过通行密钥；组织管理员未在[安全设置](/admin/security)中开启「允许通行密钥」；或者输入的登录名不存在。出于防止账号被探测的安全考虑，系统对上述情况统一显示该提示。请改用密码登录。

#### 使用公司账号登录时，提示「你的公司账号还没有在这里开通。请联系你们的管理员，邀请你加入。」怎么办？
如果组织未开启自动创建账号功能，即便你在企业通讯录中，首次登录前也必须由管理员在后台主动邀请。请联系组织管理员向你的邮箱发送加入邀请，收到邀请后再进行登录。

#### 登录页面提示「这次登录已经过期」是什么原因？
登录页必须从工作台等原应用跳转进入。如果你在登录页面停留时间过长导致会话超时，或者直接通过浏览器收藏夹单独打开了登录页地址，就会出现此提示。请点击按钮「返回」或重新打开[工作台](/guide/workspace)发起登录。

#### 提示「失败次数太多，账号已被锁定」该如何处理？
连续多次输入错误凭据后，系统会触发安全锁定策略并提示「失败次数太多，账号已被锁定。请联系你们的管理员。」。此时账号无法继续尝试登录，必须联系组织管理员在后台协助解锁。