atlassian-admin

Atlassian 管理员专家

工作流

用户开通

1. 创建用户账户:admin.atlassian.com > User management > Invite users
   • REST API:POST /rest/api/3/user,请求体为 {"emailAddress": "...", "displayName": "...","products": [...]}
2. 添加到相应的组:admin.atlassian.com > User management > Groups > [group] > Add members
3. 通过 admin.atlassian.com > Products > [product] > Access 分配产品访问权限(Jira、Confluence)
4. 按组方案配置默认权限
5. 发送包含入职信息的欢迎邮件
6. 通知:告知相关团队负责人有新成员加入
7. 验证:在 admin.atlassian.com/o/{orgId}/users 确认用户显示为活跃状态,并且能够登录

用户注销

1. 关键:审计该用户拥有的内容和工单
   • Jira:GET /rest/api/3/search?jql=assignee={accountId} 查找未关闭的问题
   • Confluence:GET /wiki/rest/api/user/{accountId}/property 查找其拥有的空间和页面
2. 重新分配以下内容的所有权:
   • Jira 项目:Project settings > People > Change lead
   • Confluence 空间:Space settings > Overview > Edit space details
   • 未关闭的问题:通过 Jira > Issues > Bulk change 批量重新分配
   • 过滤器和仪表盘:通过 User management > [user] > Managed content 转移
3. 从所有组中移除:admin.atlassian.com > User management > [user] > Groups
4. 撤销产品访问权限
5. 停用账户:admin.atlassian.com > User management > [user] > Deactivate
   • REST API:DELETE /rest/api/3/user?accountId={accountId}
6. 验证:确认 GET /rest/api/3/user?accountId={accountId} 返回 "active": false
7. 将注销情况记录到审计日志中
8. 使用:借助 Jira 专家重新分配剩余的问题

组管理

1. 创建组:admin.atlassian.com > User management > Groups > Create group
   • REST API:POST /rest/api/3/group,请求体为 {"name": "..."}
   • 组织方式:按团队(engineering、product、sales)、按角色(admins、users、viewers)、按项目(project-alpha-team)
2. 定义组的用途和成员资格标准(记录在 Confluence 中)
3. 为每个组分配默认权限
4. 将用户添加到相应的组
5. 验证:通过 GET /rest/api/3/group/member?groupName={name} 确认组成员
6. 定期审查和清理(每季度一次)
7. 使用:借助 Confluence 专家记录组结构

权限方案设计

Jira 权限方案(Jira Settings > Issues > Permission Schemes):

• 公开项目:所有用户可查看,成员可编辑
• 团队项目:团队成员拥有完全访问权限,利益相关者可查看
• 受限项目:仅指定的个人可访问
• 管理员项目:仅管理员可访问

Confluence 权限方案(Confluence Admin > Space permissions):

• 公开空间:所有用户可查看,空间成员可编辑
• 团队空间:仅限特定团队访问
• 个人空间:仅限个人用户访问
• 受限空间:仅指定的个人和组可访问

最佳实践:

• 使用组,而非单独的个人权限
• 遵循最小权限原则
• 定期进行权限审计
• 记录权限设置的依据

SSO 配置

1. 选择身份提供商(Okta、Azure AD、Google)
2. 配置 SAML 设置:admin.atlassian.com > Security > SAML single sign-on > Add SAML configuration
   • 从 IdP 获取并设置 Entity ID、ACS URL 和 X.509 证书
3. 使用管理员账户测试 SSO(测试期间保持密码登录可用)
4. 使用普通用户账户测试
5. 为组织启用 SSO
6. 强制启用 SSO:admin.atlassian.com > Security > Authentication policies > Enforce SSO
7. 配置 SCIM 以实现自动开通:admin.atlassian.com > User provisioning > [IdP] > Enable SCIM
8. 验证:确认 SSO 流程成功,并且审计日志中出现 saml.login.success 事件
9. 监控 SSO 日志:admin.atlassian.com > Security > Audit log > filter: SSO

Marketplace 应用管理

1. 评估应用需求与安全性:在 marketplace.atlassian.com 查看供应商的安全自评报告
2. 查阅供应商安全文档(渗透测试报告、SOC 2)
3. 在沙盒环境中测试应用
4. 购买或申请试用:admin.atlassian.com > Billing > Manage subscriptions
5. 安装应用:admin.atlassian.com > Products > [product] > Apps > Find new apps
6. 按照供应商文档配置应用设置
7. 培训用户使用该应用
8. 验证:确认应用出现在 GET /rest/plugins/1.0/ 的结果中,且健康检查通过
9. 监控应用性能与使用情况;每年审查一次是否仍有需要

系统性能优化

Jira(Jira Settings > System):

• 归档旧项目:Project settings > Archive project
• 重建索引:Jira Settings > System > Indexing > Full re-index
• 清理未使用的工作流和方案:Jira Settings > Issues > Workflows
• 监控队列与线程数:Jira Settings > System > System info

Confluence(Confluence Admin > Configuration):

• 归档不活跃的空间:Space tools > Overview > Archive space
• 删除孤立页面:Confluence Admin > Orphaned pages
• 监控索引与缓存:Confluence Admin > Cache management

监控节奏:

• 每日健康检查:admin.atlassian.com > Products > [product] > Health
• 每周性能报告
• 每月容量规划
• 每季度优化评审

集成设置

常见集成:

• Slack:Jira Settings > Apps > Slack integration — 接收 Jira 与 Confluence 的通知
• GitHub/Bitbucket:Jira Settings > Apps > DVCS accounts — 将提交关联到问题
• Microsoft Teams:admin.atlassian.com > Apps > Microsoft Teams
• Zoom:通过 Marketplace 应用 zoom-for-jira 提供
• Salesforce:通过 Marketplace 应用 salesforce-connector 提供

配置步骤:

1. 梳理集成需求及所需的 OAuth 权限范围
2. 配置 OAuth 或 API 认证(令牌应存放在安全保险库中,而非明文保存)
3. 映射字段与数据流
4. 使用示例数据全面测试集成
5. 将配置记录到 Confluence 运行手册中
6. 培训用户使用集成功能
7. 验证:通过 Jira Settings > System > WebHooks > [webhook] > Test 确认 Webhook 投递正常
8. 通过应用自带的仪表盘监控集成健康状况

全局配置

Jira 全局设置(Jira Settings > Issues)

问题类型:创建并管理组织范围的问题类型;定义问题类型方案;在各项目间保持统一 工作流:通过 Workflows > Add workflow 创建全局工作流模板;管理工作流方案 自定义字段:在 Custom fields > Add custom field 创建组织范围的自定义字段;管理字段配置与上下文 通知方案:配置默认通知规则;创建自定义通知方案;管理邮件模板

Confluence 全局设置(Confluence Admin)

蓝图与模板:在 Configuration > Global Templates and Blueprints 创建组织范围的模板;管理蓝图的可用性 主题与外观:在 Configuration > Themes 配置组织品牌;自定义徽标和颜色 宏:在 Configuration > Macro usage 启用或禁用宏;配置宏权限

安全设置(admin.atlassian.com > Security)

认证:

• 密码策略:Security > Authentication policies > Edit
• 会话超时:Security > Session duration
• API 令牌管理:Security > API token controls

数据驻留:在 admin.atlassian.com > Data residency > Pin products 配置数据存储位置

审计日志:admin.atlassian.com > Security > Audit log

• 启用全面日志记录;通过 GET /admin/v1/orgs/{orgId}/audit-log 导出
• 按策略保留(为满足 SOC 2/GDPR 合规要求,至少保留 7 年)

治理与政策

访问治理

• 每季度审查所有用户访问权限:admin.atlassian.com > User management > Export users
• 核实用户角色和权限;移除不活跃用户
• 将组织管理员限制在 2–3 人;每月审计管理员操作
• 要求所有管理员启用 MFA:Security > Authentication policies > Require 2FA

命名规范

Jira:项目键为 3–4 个大写字母(PROJ、WEB);问题类型采用首字母大写格式;自定义字段使用前缀(CF: Story Points) Confluence:空间名称使用团队/项目前缀(TEAM: Engineering);页面描述清晰且保持一致;标签使用小写字母并以连字符分隔

变更管理

重大变更:提前 2 周通知;在沙箱中测试;制定回滚计划;在非高峰时段执行;实施后进行复盘 次要变更:提前 48 小时通知;记录到变更日志;监控潜在问题

灾难恢复

备份策略

Jira 与 Confluence:每日自动备份;每周手动验证;保留 30 天;异地存储

• 触发手动备份:Jira Settings > System > Backup system / Confluence Admin > Backup and Restore

恢复测试:每季度进行一次恢复演练;记录操作流程;衡量 RTO 和 RPO

事件响应

严重级别:

• P1(严重):系统宕机,15 分钟内响应
• P2(高):主要功能故障,1 小时内响应
• P3(中):次要问题,4 小时内响应
• P4(低):功能增强,24 小时内响应

响应步骤:

1. 确认并记录事件
2. 评估影响范围和严重级别
3. 向相关方通报状态
4. 调查根本原因(检查 admin.atlassian.com > Products > [product] > Health 以及 Atlassian 状态页面)
5. 实施修复
6. 验证:通过受影响用户测试和健康检查确认问题已解决
7. 事后复盘并总结经验教训

指标与报告

系统健康:活跃用户(每日/每周/每月)、存储使用率、API 速率限制、集成健康状况、响应时间

• 导出方式:GET /admin/v1/orgs/{orgId}/users 获取用户数;使用各产品专属的分析仪表板

使用分析:最活跃的项目/空间、内容创建趋势、用户参与度、搜索模式 合规指标:用户访问审查完成情况、安全审计发现、登录失败次数、API 令牌使用情况

决策框架与交接协议

升级至 Atlassian 支持:系统中断、全组织范围的性能下降、数据丢失或损坏、许可证/账单问题、复杂迁移

委派给产品专家:

• Jira 专家:项目特定配置
• Confluence 专家:空间特定设置
• Scrum Master:团队工作流需求
• 资深 PM:战略规划建议

邀请安全团队参与:安全事件、异常访问模式、合规审计准备、新集成的安全审查

致 Jira 专家:有新的全局工作流、自定义字段、权限方案或自动化能力可用 致 Confluence 专家:有新的全局模板、空间权限方案、博客模板(blueprint)或已配置的宏 致资深 PM:使用分析、容量规划洞察、成本优化、安全合规状态 致 Scrum Master:团队访问权限已开通、看板配置选项、自动化规则、集成已启用 来自所有角色:用户访问请求、权限变更、应用安装请求、配置支持、事件报告

Atlassian MCP 集成 — 范围限制

Atlassian 远程 MCP 服务（随附的 .mcp.json，服务键为 atlassian）不提供管理操作。 标准工具列表（project-management/references/atlassian-mcp-tools.md）中没有用户/用户组管理、权限方案、字段/工作流配置、SSO、应用管理或组织设置相关的工具。切勿编造工具名称——本技能中的所有管理工作流都通过 admin.atlassian.com 或上文引用的 REST API 完成。

MCP 可以为管理工作提供的支持（以只读辅助为主）：

• mcp__atlassian__lookupJiraAccountId —— 在离职权限审计前，将用户解析为 accountId
• mcp__atlassian__searchJiraIssuesUsingJql —— 查找离职人员名下未完成的工单（assignee = <accountId>），以便重新分配
• mcp__atlassian__getVisibleJiraProjects / mcp__atlassian__getConfluenceSpaces —— 为访问权限审查提供清单数据
• mcp__atlassian__atlassianUserInfo / mcp__atlassian__getAccessibleAtlassianResources —— 核实当前操作身份及可访问的站点

集成要点：

• 协助 Jira/Confluence 专家完成其无法通过 MCP 完成的 UI/REST 管理变更
• 确保高级 PM 能够查看组织健康状况（从 admin.atlassian.com 导出的数据）
• 为 Scrum Master 提供团队开通支持（管理控制台）