秘密經理 - AWS IoT Greengrass

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

秘密經理

密碼管理員元件 (aws.greengrass.SecretManager) 會將密碼從 AWS Secrets Manager Greengrass 核心裝置部署。使用此元件可在 Greengrass 核心裝置的自訂元件中安全地使用認證,例如密碼。如需有關 Secrets Manager 的詳細資訊,請參閱什麼是AWS Secrets Manager?《AWS Secrets Manager使用者指南》中。

若要在自訂 Greengrass 元件中存取此元件的密碼,請使GetSecretValue用. AWS IoT Device SDK 如需詳細資訊,請參閱 使AWS IoT Device SDK用與 Greengrass 核、其他元件和通訊 AWS IoT Core擷取秘密值

此元件會加密核心裝置上的密碼,以確保您的憑證和密碼安全,直到您需要使用它們為止。它使用核心裝置的私密金鑰來加密和解密密碼。

版本

此元件具有下列版本:

  • 2.1.x

  • 2.0.x

Type

這個組件是一個插件組件(aws.greengrass.plugin)。Greengrass 核在與核相同的 Java 虛擬機(JVM)中運行此組件。當您在核心裝置上變更此元件的版本時,核心會重新啟動。

此組件使用與 Greengrass 核相同的日誌文件。如需詳細資訊,請參閱 監控AWS IoT Greengrass日誌

如需詳細資訊,請參閱 元件類型

作業系統

此元件可安裝在執行下列作業系統的核心裝置上:

  • Linux

  • Windows

要求

此元件具有下列需求:

  • Greengrass 裝置角色必須允許secretsmanager:GetSecretValue動作,如下列 IAM 政策範例所示。

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:region:123456789012:secret:MySecret" ] } ] }
    注意

    如果您使用客戶管理的AWS Key Management Service金鑰來加密密碼,則裝置角色也必須允許該kms:Decrypt處理行動。

    如需有關 Secrets Manager 的身分與存取權管理政策的詳細資訊,請參閱AWS Secrets Manager使用者指南中的下列

  • 自訂元件必須定義授權原則,aws.greengrass#GetSecretValue以取得您儲存在此元件的密碼。在此授權原則中,您可以限制元件對特定機密的存取。如需詳細資訊,請參閱密碼管理員 IPC 授權

  • (選擇性) 如果將核心裝置的私密金鑰和憑證儲存在硬體安全性模組 (HSM) 中,則 HSM 必須支援 RSA 金鑰、私密金鑰必須具有unwrap權限,且公開金鑰必須具有權限。wrap

端點和連接埠

除了基本作業所需的端點和連接埠之外,此元件還必須能夠對下列端點和連接埠執行輸出要求。如需詳細資訊,請參閱 允許裝置流量透過 Proxy 或防火牆

端點 連線埠 必要 描述

secretsmanager.region.amazonaws.com

443

將秘密下載到核心設備。

相依性

部署元件時,AWS IoT Greengrass也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的需求,才能成功部署元件。本節列出此元件之已發行版本的相依性,以及定義每個相依性之元件版本的語意版本條件約束。您也可以在AWS IoT Greengrass主控台中檢視元件每個版本的相依性。在元件詳細資料頁面上,尋找 [相依性] 清單。

2.1.7

下表列出此元件 2.1.7 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.5.0 軟式
2.1.6

下表列出此元件 2.1.6 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.5.0 軟式
2.1.5

下表列出此元件 2.1.5 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.5.0 軟式
2.1.4

下表列出此元件 2.1.4 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.5.0 軟式
2.1.3

下表列出此元件 2.1.3 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.5.0 軟式
2.1.2

下表列出此元件 2.1.2 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.5.0 軟式
2.1.1

下表列出此元件 2.1.1 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.5.0 軟式
2.1.0

下表列出此元件 2.1.0 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.5.0 軟式
2.0.9

下表列出此元件 2.0.9 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
2.0.8

下表列出此元件 2.0.8 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
2.0.7

下表列出此元件 2.0.7 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
2.0.6

下表列出此元件 2.0.6 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
2.0.4 and 2.0.5

下表列出此元件 2.0.4 和 2.0.5 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.3 軟式

如需有關元件相依性的詳細資訊,請參閱元件方案參考

組態

此元件提供下列組態參數,您可以在部署元件時自訂這些參數。

cloudSecrets

要部署到核心裝置的密碼清單。您可以指定標籤來定義要部署的每個密碼版本。如果您未指定版本,則此元件會部署AWSCURRENT附加測試標籤的版本。如需詳細資訊,請參閱AWS Secrets Manager使用指南中的暫存標籤

密碼管理員元件會在本機快取密碼。如果秘密值在 Secrets Manager 中發生變更,此元件不會自動擷取新值。若要更新本機副本,請為機密提供新標籤,並將此元件設定為擷取新標籤所識別的密碼。

每個物件都包含下列資訊:

arn

要部署之密碼的 ARN。秘密的 ARN 可以是完整的 ARN 或部分 ARN。我們建議您指定完整的 ARN,而不是部分 ARN。如需詳細資訊,請參閱從部分 ARN 尋找密碼。以下是完整 ARN 和部分 ARN 的示例:

  • 全 ARN: arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName-abcdef

  • 部分 ARN:arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName

labels

(選擇性) 標籤清單,用於識別要部署到核心裝置的密碼版本。

每個標籤必須是一個字符串。

範例:組態合併更新
{ "cloudSecrets": [ { "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef" } ] }

本機記錄檔

此元件使用與 Greengrass 核元件相同的記錄檔。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
若要檢視此元件的記錄
  • 在核心裝置上執行下列命令,即時檢視此元件的記錄檔。以AWS IoT Greengrass根資料夾的路徑取代/greengrass/v2C:\greengrass\v2

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

變更記錄

下表說明元件每個版本的變更。

版本

變更

2.1.7

版本更新 Greengrass 2.12.0 版本釋放。

2.1.6

版本更新了 Greengrass 核 2.11.0 版本釋放。

2.1.5

版本更新了 Greengrass 2.10.0 版本。

2.1.4

錯誤修復和改進

修正部署秘密管理員且 Greengrass 核心重新啟動時,會移除快取密碼的問題。

版本更新 Greengrass 2.9.0 版本釋放。

2.1.3

版本更新 Greengrass 2.8.0 版本的版本。

2.1.2

版本更新了 Greengrass 核 2.7.0 版本釋放。

2.1.1

版本更新 Greengrass 2.6.0 版本發布。

2.1.0

新功能
  • 添加對硬件安全集成的支持。秘密管理員元件可以使用您儲存在硬體安全性模組 (HSM) 中的私密金鑰來加密和解密密碼。如需詳細資訊,請參閱 硬體安全整合

錯誤修復和改進
  • 版本更新了 Greengrass 核 2.5.0 版本。

2.0.9

版本更新 Greengrass 2.4.0 版本的版本。

2.0.8

版本更新了 Greengrass 核 2.3.0 版本。

2.0.7

版本更新了 Greengrass 核 2.2.0 版本。

2.0.6

版本更新 Greengrass 2.1.0 版本發布。

2.0.5

改善項目
  • 新增對AWS中國地區和AWS GovCloud (US)地區的支援。

2.0.4

初始版本。