Confluence 权限映射要解决的是“谁能看到什么、能改什么”在迁移后是否仍然成立。做法是先把源站的空间、页面树、用户组和权限类型盘清，再按目标平台的权限模型建立对照表，用样本空间试迁移逐项核验，确认后再分批切换并保留回退点。本文以 Confluence 迁往已确定目标平台为前提，聚焦权限映射这一阶段。
要点总览（TL;DR）
- 先锁定映射范围：方向固定为 Confluence 到已确定的目标平台，分开盘点全局权限、空间权限、页面限制三类来源，并写明附件、评论、历史版本是否纳入。
- 映射表按“空间—页面—用户组—权限动作”四层建立，用空间 ID 和页面 ID 关联；无法直接对应的权限标注为降级、合并或人工审批，并进入例外清单。
- 映射前收齐空间与页面树导出、权限清单、用户组名单、目标平台角色说明和账号对应表，重点处理同名不同人、离职账号和外部协作账号。
- 选含多层级页面树、多用户组和页面限制的样本空间试迁移，用空间管理员、编辑成员、只读成员、受限个人四类真实账号核验可见性与编辑权，差异项回填映射表。
- 敏感空间权限无法确认时暂停该空间切换；出现越权可见或编辑权限丢失立即回退样本，保留源站只读窗口期，通过标准由迁移负责人和目标平台管理员共同签收。
来源与目标：先锁定 Confluence 权限映射的范围
权限映射开始前，需要把方向固定为“Confluence 到目标平台”，并写进迁移任务说明。方向一旦含糊，盘点口径和角色对照都会跟着混乱。范围清单至少包含四项：源站版本与部署方式、目标平台及版本、本次覆盖的空间清单、本次覆盖的用户与用户组范围。
Confluence 的权限来源分三层，盘点时要分开记录，不能混在一张表里：
- 全局权限：决定账号能否登录、能否创建空间、能否安装插件等站点级能力，通常由站点管理员维护。
- 空间权限：按空间授予用户组或个人的查看、编辑、评论、管理空间等动作，是迁移映射的主体。
- 页面限制：在空间权限之上对单页或页面树追加的查看、编辑限制，优先级高于空间权限，最容易在迁移中被忽略。
对象范围也要提前写明。附件、评论、历史版本是否纳入本次映射，直接影响核验工作量。若附件沿用了页面级限制，映射时需单独标注；评论权限通常跟随页面可见性，但仍要在核验时抽查。范围清单建议由迁移负责人、目标平台管理员和业务确认人三方签字，作为后续映射表的边界依据。
本阶段输入及依赖：做权限映射前要准备什么
映射表如果建在缺失信息上，后面每改一次都要返工。开工前应把输入材料收齐，并指定每项材料的提供人和确认人。
| 输入材料 | 用途 | 责任人 |
|---|---|---|
| 空间清单与页面树导出 | 确定映射对象和层级关系 | Confluence 站点管理员 |
| 空间权限与页面限制清单（导出或截图） | 作为源权限的原始记录 | 站点管理员 |
| 用户与用户组名单 | 建立账号对应关系 | IT 或 HR 系统负责人 |
| 目标平台权限模型说明与可用角色 | 确定可映射的目标角色集合 | 目标平台管理员 |
| 账号对应表（同名、离职、外部协作账号） | 处理无法自动匹配的账号 | IT 负责人 |
| 敏感空间清单及业务确认人 | 对高风险空间做人工签收 | 业务负责人 |
账号对应关系需要特别处理三类情况：同名不同人、已离职但权限未回收的账号、外部协作方账号。前两类应在映射前完成清理或标注，外部账号则要确认目标平台是否允许同类外部访问，再决定映射方式。目标平台的权限模型说明必须来自实际配置，不能凭印象填写角色清单。
权限映射方法：四层对照表怎么建
映射表按“空间—页面—用户组—权限动作”四层组织。空间层确定整体归属，页面层记录限制与继承，用户组层完成主体对应，权限动作层完成角色对应。四层分开建表，再用空间 ID 和页面 ID 关联，比一张大宽表更容易核对和回填。
第一步：建立空间与页面的层级底表
把每个空间及其页面树导出为带层级编号的清单，标注哪些页面存在页面限制、限制作用于单页还是整棵子树。继承关系要写清楚：子页面默认继承父级限制，一旦子页面单独设置限制就会覆盖父级。映射时若目标平台只支持空间级角色，这类覆盖关系就必须转为例外项处理。
第二步：完成用户组与账号对应
Confluence 中大量权限授予的是用户组而非个人。先做用户组到目标平台用户组或角色的对应，再处理个人授权。个人授权数量少但往往涉及敏感页面，应逐条列出，避免在批量映射中被吞掉。
第三步：把权限动作对应到目标角色
Confluence 的查看、编辑、评论、限制等动作，需要逐项对照目标平台的角色定义。对照时以目标平台实际具备的角色为准，不假设存在一一对应关系。
| 源权限（Confluence） | 目标角色（示例） | 处理方式 | 确认人 |
|---|---|---|---|
| 空间查看（用户组） | 空间只读成员 | 直接对应 | 目标平台管理员 |
| 空间编辑（用户组） | 空间编辑成员 | 直接对应 | 目标平台管理员 |
| 空间评论 | 评论权限或编辑成员附带 | 合并到编辑角色，需业务确认 | 业务确认人 |
| 页面查看限制（个人） | 页面级可见范围 | 目标平台无页面级限制时降级为独立空间或人工审批 | 业务确认人 |
| 页面编辑限制（个人） | 页面级编辑范围 | 标注例外，逐条确认 | 业务确认人 |
| 空间管理 | 空间管理员 | 直接对应，数量从严控制 | 迁移负责人 |
表中“示例”列需替换为目标平台实际角色名称。无法直接对应的权限统一标注为降级、合并或人工审批三种处理方式之一，并写明理由。降级意味着目标权限弱于源权限，合并意味着多个源权限收敛为一个目标角色，人工审批意味着切换前必须由业务确认人逐条签收。三类处理都要进入例外清单，不能只在表里留一个备注。
试迁移与核验：用样本空间验证映射结果
映射表完成后，选一个样本空间做试迁移。样本应包含多层级页面树、至少两个用户组、若干页面限制和附件，覆盖越全面，暴露的问题越早。
核验用真实账号登录完成，不用管理员视角代替。至少准备四类账号：空间管理员、编辑成员、只读成员、仅被页面限制授权的个人。每类账号逐一检查以下项目：
- 能否看到应可见的空间与页面，看不到应受限的页面；
- 能否编辑授权范围内的页面，编辑范围外的页面是否被正确拦截；
- 页面限制是否生效，子页面继承与覆盖关系是否与源站一致；
- 附件是否随页面可见性正确开放，评论权限是否符合预期。
每项核验记录“预期结果、实际结果、差异说明、修正动作”四列，差异项回填映射表并重新核验。核验记录本身要留存，作为切换评审的证据。若目标平台为 ONES Wiki，其迁移方案覆盖用户、用户组、空间权限与页面权限，并支持页面正文、附件、图片、常用宏及批注的迁移；逐条权限动作的对应细则仍需在实施中按实际配置确认，试迁移核验正是确认这些细则的环节。映射表、核验记录和例外清单可以放在同一份迁移文档中维护，用工作项跟踪每个差异项的修正状态和确认人，切换评审时直接查看关闭情况。
回退与停止条件：哪些情况先不切换
权限问题的影响是“看错”或“改错”，一旦发生在敏感空间，代价高于延期。以下情况应暂停或回退：
- 敏感空间的权限无法确认对应关系，暂停该空间切换，其余空间可继续；
- 试迁移中出现越权可见，立即回退样本空间并排查映射表；
- 出现编辑权限丢失且影响业务连续，回退样本并重新核验账号对应关系；
- 页面限制在目标平台无法表达且业务不接受降级方案，该页面树暂不迁移。
回退操作需要提前写好步骤：保留源站只读窗口期、记录回退触发人和执行人、明确回退后样本空间的处理方式。切换前的通过标准建议写成可核验的条目，例如样本空间全部核验项通过、例外清单全部签收、敏感空间确认人书面确认。通过标准由迁移负责人和目标平台管理员共同签收，签收记录与核验记录一并归档，作为后续分批切换的依据。
常见问题
Confluence 的页面限制在目标平台没有对应能力时，应该怎么处理？
先把这类页面限制逐条列入例外清单，再按业务影响选择处理方式：能收敛到独立空间的，拆成单独空间并授予原受限人员；业务不接受降级方案的，该页面树暂不迁移；影响范围小且可控的，由业务确认人逐条签收后按降级处理。三种方式都要写明理由和确认人，切换评审时逐条核对关闭情况。
用户组数量很多、成员交叉严重时，映射表怎么避免越做越乱？
先做用户组到目标角色的对应，再处理个人授权，不要一开始就按人展开。对成员高度重叠的用户组，可以合并为同一目标角色，但要在例外清单中记录合并依据和影响的空间范围。个人授权数量少、往往涉及敏感页面，应单独成表逐条确认，避免在批量映射中被忽略。
试迁移核验时，用管理员账号检查一遍是否足够？
不够。管理员视角通常能看到全部内容，无法暴露越权可见或权限丢失的问题。核验要用空间管理员、编辑成员、只读成员、仅被页面限制授权的个人四类真实账号分别登录，逐项检查应可见与应受限的页面、编辑范围、页面限制的继承与覆盖、附件和评论权限。每项记录预期结果、实际结果、差异说明和修正动作。
迁移后出现个别页面越权可见，应该整体回退还是只处理该页面？
先回退样本空间或该批次，控制影响范围，再排查映射表中对应的权限条目。若问题集中在单条映射错误，修正映射表并重新核验通过后可恢复切换；若涉及目标平台权限模型无法表达的限制，应将该页面树列入暂不迁移范围，由业务确认人决定后续方案。回退步骤、触发人和执行人需在切换前写好。
ONES Wiki 作为迁移目标时，权限映射有哪些需要提前确认的点？
ONES 的 Confluence 数据迁移范围包括用户、用户组、空间权限与页面权限，并支持页面正文、附件、图片、常用宏及批注的迁移。逐条权限动作与目标角色的对应细则，现有资料未给出完整规则，需要在实施中按实际配置确认，试迁移核验正是确认这些细则的环节。映射表、核验记录和例外清单可以放在同一份迁移文档中维护，用工作项跟踪差异项的修正状态。
