版本类型操作系统要求附属物配置本地日志文件更改日志

秘密经理

密钥管理器组件 (aws.greengrass.SecretManager) 将机密从部署Amazon Secrets Manager到 Greengrass 核心设备。使用此组件可以在 Greengrass 核心设备的自定义组件中安全地使用密码（例如密码）。有关 Secrets Manager 的更多信息，请参阅什么是Amazon Secrets Manager？在Amazon Secrets Manager用户指南中。

要在您的自定义 Greengrass 组件中访问此组件的密钥，请使用中的GetSecretValueAmazon IoT Device SDK操作。有关更多信息，请参阅使用Amazon IoT Device SDK与 Greengrass 原子核、其他组件进行通信，以及Amazon IoT Core 和检索秘密值。

此组件对核心设备上的机密进行加密，以保护您的凭据和密码的安全，直到您需要使用它们。它使用核心设备的私钥来加密和解密机密。

版本

此组件有以下版本：

2.1.x
2.0.x

类型

这个组件是一个插件组件 (aws.greengrass.plugin)。Greengrass 核在与核心相同的 Java 虚拟机 (JVM) 中运行此组件。当您在核心设备上更改此组件的版本时，nucleus 会重新启动。

此组件使用与 Greengrass 核相同的日志文件。有关更多信息，请参阅监控Amazon 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"
      ]
    }
  ]
}
```
注意
如果您使用客户管理的密Amazon Key Management Service钥加密机密，则设备角色也必须允许该kms:Decrypt操作。

有关 Secrets Manager 的 IAM 策略的更多信息，请参阅Amazon Secrets Manager用户指南中的以下内容：
- 的身份验证和访问控制 Amazon Secrets Manager
- 您可以在 IAM 策略或密钥策略中使用的操作、资源和上下文密钥 Amazon Secrets Manager
自定义组件必须定义授权策略，aws.greengrass#GetSecretValue允许获取您存储在此组件中的密钥。在此授权策略中，您可以限制组件对特定机密的访问。有关更多信息，请参阅密钥管理器 IPC 授权。
（可选）如果您将核心设备的私钥和证书存储在硬件安全模块 (HSM) 中，则 HSM 必须支持 RSA 密钥，私钥必须具有unwrap权限，公钥必须具有权限。wrap

端点和端口

除了基本操作所需的端点和端口外，此组件还必须能够对以下端点和端口执行出站请求。有关更多信息，请参阅允许设备流量通过代理或防火墙：

Endpoint	端口	必填	描述
`secretsmanager.region.amazonaws.com`	443	是	将机密下载到核心设备。

附属物

部署组件时，Amazon IoT Greengrass还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本节列出了此组件的已发布版本的依赖关系以及定义每个依赖关系的组件版本的语义版本限制。您还可以在Amazon IoT Greengrass控制台中查看每个版本的组件的依赖关系。在组件详细信息页面上，查找 “依赖关系” 列表。

2.1.6

下表列出了此组件版本 2.1.6 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.5.0 <2.12.0	软性

2.1.5

下表列出了此组件版本 2.1.5 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.5.0 <2.11.0	软性

2.1.4

下表列出了此组件版本 2.1.4 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.5.0 <2.10.0	软性

2.1.3

下表列出了此组件版本 2.1.3 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.5.0 <2.9.0	软性

2.1.2

下表列出了此组件版本 2.1.2 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.5.0 <2.8.0	软性

2.1.1

下表列出了此组件版本 2.1.1 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.5.0 <2.7.0	软性

2.1.0

下表列出了此组件版本 2.1.0 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.5.0 <2.6.0	软性

2.0.9

下表列出了此组件版本 2.0.9 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.0.0 <2.5.0	软性

2.0.8

下表列出了此组件版本 2.0.8 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.0.0 <2.4.0	软性

2.0.7

下表列出了此组件版本 2.0.7 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.0.0 <2.3.0	软性

2.0.6

下表列出了此组件版本 2.0.6 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.0.0 <2.2.0	软性

2.0.4 and 2.0.5

下表列出了此组件版本 2.0.4 和 2.0.5 的依赖关系。

依赖关系	兼容版本	依赖关系类型
绿草核	>=2.0.3 <2.1.0	软性

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件提供以下配置参数，您可以在部署组件时自定义这些参数。

cloudSecrets

要部署到核心设备的 Secrets Manager 密钥列表。您可以指定标签来定义要部署每个密钥的哪个版本。如果您未指定版本，则此组件将部署AWSCURRENT附有暂存标签的版本。有关更多信息，请参阅《Amazon Secrets Manager用户指南》中的 “暂存标签”。

每个对象都包含以下信息：

arn

要部署的密钥的 ARN。

labels

（可选）用于标识要部署到核心设备的密钥版本的标签列表。

每个标签必须是一个字符串。

例示例：配置合并更新


{
  "cloudSecrets": [
    {
      "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
    }
  ]
}

本地日志文件

此组件使用与 Greengrass 核组件相同的日志文件。

查看此组件的日志

在核心设备上运行以下命令以实时查看此组件的日志文件。将 /greengrass/v2 或 C:\greengrass\v2 替换为根文件夹的路径。Amazon IoT Greengrass
Linux
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```

更改日志

下表描述了该组件的每个版本中的更改。

Version	变化
2.1.6	Greengrass nucleus 版本 2.11.0 版本的版本已更新。
2.1.5	Greengrass nucleus 版本 2.10.0 版本的版本已更新。
2.1.4	错误修复和改进修复了部署密钥管理器并重新启动 Greengrass nucleus 时缓存的密钥被删除的问题。 Greengrass nucleus 版本 2.9.0 版本的版本已更新。
2.1.3	Greengrass nucleus 版本 2.8.0 版本的版本已更新。
2.1.2	Greengrass nucleus 版本 2.7.0 版本的版本已更新。
2.1.1	Greengrass nucleus 版本 2.6.0 版本的版本已更新。
2.1.0	新功能增加了对硬件安全集成的支持。密钥管理器组件可以使用存储在硬件安全模块 (HSM) 中的私钥对机密进行加密和解密。有关更多信息，请参阅硬件安全性集成：错误修复和改进 Greengrass nucleus 版本 2.5.0 版本的版本已更新。
2.0.9	Greengrass nucleus 版本 2.4.0 版本的版本已更新。
2.0.8	Greengrass nucleus 版本 2.3.0 版本的版本已更新。
2.0.7	Greengrass nucleus 版本 2.2.0 版本的版本已更新。
2.0.6	Greengrass nucleus 版本 2.1.0 版本的版本已更新。
2.0.5	改进添加对Amazon中国地区和Amazon GovCloud (US)地区的支持。
2.0.4	初始版本。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

PKCS #11 提供商

安全隧道