Secret Manager - Access task

透過「Secret Manager - Access」工作，您可以從整合服務存取儲存在 Cloud Secret Manager 中的密鑰版本。存取 Secret 版本會傳回該 Secret 的內容，以及 Secret 版本的其他中繼資料，例如標籤和複製資訊。

Cloud Secret Manager 是 Google Cloud 服務，可讓您儲存、存取及管理機密設定資料，例如應用程式在執行階段所需的資料庫密碼、API 金鑰或 TLS 憑證。

事前準備

請務必先在 Google Cloud 專案中執行下列工作，再設定「Secret Manager - Access」工作：

啟用 Secret Manager API (secretmanager.googleapis.com)。
啟用 Secret Manager API
建立驗證設定檔。Application Integration 會使用驗證設定檔，連線至 Secret Manager - Access 工作的驗證端點。
注意：如果您要建立「服務帳戶」類型的驗證設定檔，請務必為服務帳戶指派包含下列 IAM 權限的 IAM 角色：
- secretmanager.secretAccessor
如要瞭解 IAM 權限和授予這些權限的預先定義 IAM 角色，請參閱 IAM 權限參考資料。

如要瞭解如何授予服務帳戶其他角色或權限，請參閱「授予、變更及撤銷存取權」。

設定 Secret Manager - Access 工作

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「Application Integration」
在導覽選單中，按一下「整合」。
系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中可用的所有整合功能。
選取現有整合，或按一下「建立整合」建立新整合。
如要建立新的整合項目：
1. 在「建立整合」窗格中輸入名稱和說明。
2. 選取整合作業的區域。
  注意：「區域」下拉式選單只會列出 Google Cloud 專案中佈建的區域。如要佈建新區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」。
3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
  注意：只有在您為所選區域啟用整合控管功能時，系統才會顯示選取服務帳戶的選項。
4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。
在整合編輯器的導覽列中，按一下「Tasks」(工作)，即可查看可用工作和連結器的清單。
在整合服務編輯器中，按一下並放置「Secret Manager - Access」元素。
在設計工具中，按一下「Secret Manager - Access」(Secret Manager - Access) 元素，即可查看「Secret Manager - Access」(Secret Manager - Access) 任務設定窗格。
前往「驗證」，然後選取要使用的現有驗證設定檔。
(選用步驟) 如果您尚未建立驗證設定檔，請在設定工作前按一下「+ 新增驗證設定檔」，然後按照「建立新的驗證設定檔」一文中的步驟操作。
前往「Task Input」(任務輸入內容)，然後使用下列「Task input parameters」(任務輸入參數) 表格，設定顯示的輸入欄位。
系統會自動儲存輸入欄位的變更。

工作輸入參數

下表說明「Secret Manager - Access」工作的輸入參數：

資源	資料類型	說明
Projectsid	字串	您的 Google Cloud 專案 ID。
Secretsid	字串	密鑰的 ID。
Versionsid	字串	祕密的版本 ID 或別名。如要存取密鑰的最新版本，請將 `latest` 指定為版本 ID。

工作輸出

「Secret Manager - Access」工作會傳回回應 payload.data，其中包含密鑰版本的 base64 編碼內容。您必須解碼 Base64 編碼的值，才能取得輸出字串。

錯誤處理策略

工作錯誤處理策略會指定工作因暫時性錯誤而失敗時，系統應採取的動作。如要瞭解如何使用錯誤處理策略，以及不同類型的錯誤處理策略，請參閱「錯誤處理策略」。

配額與限制

如要瞭解配額和限制，請參閱配額和限制。