使用服務帳戶使用 Grafana HTTP API 進行身份驗證 - Amazon Managed Grafana
服務帳戶字符服務帳戶權益建立服務帳戶將令牌添加到服務帳戶將角色指派給服務帳戶

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用服務帳戶使用 Grafana HTTP API 進行身份驗證

您可以使用服務帳戶在 Grafana 中執行自動化工作負載，例如儀表板佈建、設定或報告產生。使用 Grafana 主控台或 Amazon 受管的 Grafana API 建立服務帳戶和權杖來驗證應用程式，例如 Terraform。

注意

服務帳戶可在 Grafana 9.x 和更新版本中使用，並取代 API 金鑰作為驗證與 Grafana 互動之應用程式的主要方式。

建立服務帳戶的常見使用案例是對自動化或觸發的工作執行作業。您可以使用服務帳戶來：

  • 在您的系統中定義要在 Grafana 中使用的警報

  • 在不以使用者身分登入的情況下與 Grafana 互動

注意

出於計費目的，每個服務帳戶都被視為用戶。

服務帳戶字符

服務帳戶令牌是生成的隨機字符串，在使用 Grafana 的 HTTP API 進行身份驗證時，可作為密碼的替代方法。

建立服務帳戶時，您可以將一或多個存取權杖與其關聯。您可以使用與 API 金鑰相同的方式使用服務存取權杖，例如透過程式設計方式存取 Grafana HTTP API。

您可以為同一個服務帳戶創建多個令牌。如果出現以下情況，您可能需要這樣做

  • 多個應用程式使用相同的權限，但您想要分別稽核或管理其動作。

  • 您需要旋轉或替換受感染的令牌。

服務帳戶訪問令牌繼承服務帳戶的權限。

服務帳戶權益

服務帳戶對 API 金鑰的額外好處包括：

  • 服務帳戶與 Grafana 使用者類似，可以啟用/停用、授與特定權限，並保持作用中狀態，直到刪除或停用它們為止。API 密鑰僅在到期日期之前有效。

  • 服務帳戶可以與多個令牌相關聯。

  • 與 API 密鑰不同，服務帳戶令牌與特定用戶沒有關聯，這意味著即使刪除了 Grafana 用戶，也可以對應用程序進行身份驗證。

  • 您可以使用與授予權限給使用者的方式相同，將權限授予服務帳戶。

    如需許可的詳細資訊，請參閱「使用權限」。

建立服務帳戶

注意

建立服務帳戶的使用者也可以讀取、更新和刪除他們所建立的服務帳戶，以及與該服務帳戶相關聯的權限。

必要條件

確定您具有建立和編輯服務帳戶的權限。依預設，建立和編輯服務帳戶需要組織管理員角色。如需許可的詳細資訊，請參閱「使用權限」。

若要建立服務帳戶

  1. 登入您的 Amazon 受管 Grafana 工作區，然後從左側功能表中選取管理。

  2. 選取 [服務帳戶]。

  3. 選取 [新增服務帳戶]。

  4. 輸入「顯示名稱」。

  5. 顯示名稱必須是唯一的，因為它決定了與服務帳戶相關聯的 ID。

    • 建議您在命名服務帳戶時使用一致的命名慣例。一致的命名慣例可協助您在 future 擴展和維護服務帳戶。

    • 您可以隨時變更顯示名稱。

  6. 選擇建立。

注意

您也可以使用 Amazon 受管的 Grafana AWS API 建立服務帳戶。使用以程式設計方式建立服務帳戶。CreateWorkspaceServiceAccount

將令牌添加到服務帳戶

服務帳戶令牌是生成的隨機字符串，在使用 Grafana 的 HTTP API 進行身份驗證時，可作為密碼的替代方法。

必要條件

確定您具有建立和編輯服務帳戶的權限。依預設，建立和編輯服務帳戶需要組織管理員角色。如需許可的詳細資訊，請參閱「使用權限」。

若要將權杖新增至服務帳戶

  1. 登入 Grafana 並在左側選單中選擇「管理」。

  2. 選擇 [服務帳戶]。

  3. 選取您要新增權杖的服務帳戶。

  4. 選擇 [新增服務帳戶權杖]。

  5. 輸入權杖的名稱。

  6. 選取 [設定到期日]，然後輸入權杖的到期日。

    • 到期日會指定您希望金鑰有效的時間長度。

    • 您最多可以 future 到期日設定為 30 天。

    • 如果您不確定到期日，建議您將權杖設定為在短時間後過期，例如幾個小時或更短的時間。這限制了與長時間有效令牌相關的風險。

  7. 選擇 Generate token (產生字符)。

注意

您也可以使用 Amazon 受管的 Gra AWS fana API 來建立服務帳戶權杖。使用以程式設計方式建立服務帳戶 Token。CreateWorkspaceServiceAccountToken

將角色指派給服務帳戶

您可以將角色指派給 Grafana 服務帳戶，以控制相關服務帳戶權杖的存取權。您可以使用 Grafana 使用者介面或透過 API 將角色指派給服務帳戶。

必要條件

確定您具有建立和編輯服務帳戶的權限。依預設，建立和編輯服務帳戶需要組織管理員角色。如需許可的詳細資訊，請參閱「使用權限」。

若要指派角色給服務帳戶

  1. 登入 Grafana 並在左側選單中選擇「管理」。

  2. 選擇 [服務帳戶]。

  3. 選取您要指派角色的服務帳戶。您也可以在清單檢視中尋找服務帳戶。

  4. 使用要更新的角色選擇器指派角色。