功能性使用者

功能性使用者是一種非人類的服務帳戶，旨在促進自動化作業及系統對系統的整合。與一般使用者不同，功能性使用者不會綁定特定個人或電子郵件地址，這能確保即使團隊成員有所變動或離開組織，自動化工作流程仍能持續運作不中斷。

建立功能性使用者

基於安全考量，僅有 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 回應中顯示一次，且必須儲存在本端。