功能用户

功能用户是一种非人工服务帐户，旨在协助完成自动化任务和系统到系统集成。与标准用户不同，功能用户并不会与特定的个人或电子邮件地址绑定，这可确保即使团队成员发生变动或离职，自动化工作流也不会中断。

创建功能用户

为了安全起见，只有 Administrator 可以创建功能用户，并且只能通过 API 进行创建。

使用 /api/v4/User/CreateFunctionalUser API 端点创建功能用户。至少包含以下参数：

  1. FirstName：描述性帐户名称（例如，“Jira_Automation_Service”）。

  2. RoleId：要分配给功能用户的角色。使用以下 API 检索 RoleId：
    api/v4/Roles
提示：
  • 有效的电子邮件地址为可选，但您可以根据需要分配一个。
  • 如果用户不是 Administrator，则将该用户与资产组相关联。您可以稍后添加此项，但用户必须在与应用程序相关的上下文中执行任务。
  • 使用以下 API 检索 AssetGroupIds：
    api/v4/AssetGroups

在成功发起 POST 请求后，响应中将包含 API key，并且系统将创建一个功能用户，其用户名采用 <FirstName>_Func_<OrgID> 的格式自动生成。

重要： API key 仅显示一次。请立即复制并将其存储在安全位置（如密钥管理器）。它将不会在 UI 中显示，也无法通过后续的 API 调用进行访问。

在 UI 中管理功能用户

在您通过 API 创建功能用户后，这些用户将与所有其他用户一起显示在用户管理表中，并被视为标准用户。有关可用操作，请参阅用户管理页面。

要过滤功能用户列表，请搜索关键字 "func"。

API 密钥轮换

您可以根据需要轮换 API 密钥。

  • 流程：通过 API 执行密钥轮换。

  • 立即失效：生成新的 API 密钥时，先前的密钥将立即失效。请立即更新您的自动化脚本和集成，以防止发生停机。

  • 一次性视图：与初始创建时相同，新密钥仅在 API 响应中返回一次，必须将其保存到本地。