AWS IoT Greengrass Version 1 於 2023 年 6 月 30 日進入延長使用壽命階段。如需詳細資訊，請參閱AWS IoT Greengrass V1 維護政策。在此日期之後， AWS IoT Greengrass V1 將不會發行提供功能、增強功能、錯誤修正或安全性修補程式的更新。在上運行的設備 AWS IoT Greengrass V1 不會中斷，並將繼續運行並連接到雲。我們強烈建議您移轉至 AWS IoT Greengrass Version 2，這會增加重要的新功能，並支援其他平台。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS IoT Greengrass 搭配 IAM 的運作方式
在您使用 IAM 管理存取權限之前AWS IoT Greengrass，您應該了解可搭配使用的 IAM 功能AWS IoT Greengrass。
IAM 功能 |
受到 Greengrass 支援？ |
|---|---|
| 是 | |
| 否 | |
| 否 | |
| 是 | |
| 是 | |
| 否 | |
| 是 |
如需其他AWS服務如何與 IAM 搭配運作的高階檢視，請參閱 IAM 使用者指南中的與 IAM 搭配使用的AWS服務。
適用於 AWS IoT Greengrass 的身分型政策
使用 IAM 身分型政策，您可以指定允許或拒絕的動作和資源，以及在何種條件下允許或拒絕動作。AWS IoT Greengrass 支援特定動作、資源及條件金鑰。若要了解您在政策中使用的所有元素，請參閱 IAM 使用者指南中的 IAM JSON 政策元素參考資料。
動作
管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說，哪個主體在什麼條件下可以對什麼資源執行哪些動作。
JSON 政策的 Action 元素描述您可以用來允許或拒絕政策中存取的動作。政策動作的名稱通常會和相關聯的 AWS API 操作相同。有一些例外狀況，例如沒有相符的 API 操作的僅限許可動作。也有一些操作需要政策中的多個動作。這些額外的動作稱為相依動作。
政策會使用動作來授與執行相關聯操作的許可。
AWS IoT Greengrass 的政策動作會在動作之前使用 greengrass: 字首。例如，若要允許某人使用 ListGroups API 作業列出其中的群組AWS 帳戶，您可以在其政策中加入該greengrass:ListGroups動作。政策陳述式必須包含 Action 或 NotAction 元素。AWS IoT Greengrass 會定義一組自己的動作，來描述您可以使用此服務執行的任務。
若要在單一陳述式中指定多個動作，請將它們列在括號 ([]) 之間，並以逗號分隔它們，如下所示：
"Action": [ "greengrass:action1", "greengrass:action2", "greengrass:action3" ]
您可以使用萬用字元 (*) 來指定多個動作。例如，若要指定開頭是 List 文字的所有動作，請包含以下動作：
"Action": "greengrass:List*"
注意
建議您避免使用萬用字元來指定服務的所有可用動作。最佳實務是，您應該在政策中授予最低權限和範圍較窄的許可。如需詳細資訊，請參閱 盡可能授予最低的許可。
如需AWS IoT Greengrass動作的完整清單，請參閱《IAM 使用者指南》AWS IoT Greengrass中的 「定義動作」。
資源
管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說，哪個主體在什麼條件下可以對什麼資源執行哪些動作。
Resource JSON 政策元素可指定要套用動作的物件。陳述式必須包含 Resource 或 NotResource 元素。最佳實務是使用其 Amazon Resource Name (ARN) 來指定資源。您可以針對支援特定資源類型的動作 (稱為資源層級許可) 來這麼做。
對於不支援資源層級許可的動作 (例如列出作業)，請使用萬用字元 (*) 來表示陳述式適用於所有資源。
"Resource": "*"
下表包含可用於政策陳述式的 Resource 元素中的 AWS IoT Greengrass 資源 ARN。如需AWS IoT Greengrass動作支援的資源層級許可對應，請參閱《IAM 使用者指南》AWS IoT Greengrass中的「定義動作」。
| 資源 | ARN |
|---|---|
| Group |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}
|
| GroupVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}/versions/${VersionId}
|
| CertificateAuthority |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}/certificateauthorities/${CertificateAuthorityId}
|
| Deployment |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/groups/${GroupId}/deployments/${DeploymentId}
|
| BulkDeployment |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/bulk/deployments/${BulkDeploymentId}
|
| ConnectorDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/connectors/${ConnectorDefinitionId}
|
| ConnectorDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/connectors/${ConnectorDefinitionId}/versions/${VersionId}
|
| CoreDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/cores/${CoreDefinitionId}
|
| CoreDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/cores/${CoreDefinitionId}/versions/${VersionId}
|
| DeviceDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/devices/${DeviceDefinitionId}
|
| DeviceDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/devices/${DeviceDefinitionId}/versions/${VersionId}
|
| FunctionDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/functions/${FunctionDefinitionId}
|
| FunctionDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/functions/${FunctionDefinitionId}/versions/${VersionId}
|
| LoggerDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/loggers/${LoggerDefinitionId}
|
| LoggerDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/loggers/${LoggerDefinitionId}/versions/${VersionId}
|
| ResourceDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/resources/${ResourceDefinitionId}
|
| ResourceDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/resources/${ResourceDefinitionId}/versions/${VersionId}
|
| SubscriptionDefinition |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/subscriptions/${SubscriptionDefinitionId}
|
| SubscriptionDefinitionVersion |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/definition/subscriptions/${SubscriptionDefinitionId}/versions/${VersionId}
|
| ConnectivityInfo |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
|
下列範例Resource元素會指定美國西部 (奧勒岡) 區域中群組的 ARN：AWS 帳戶123456789012
"Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
或者，若要指定屬於特定群組AWS 帳戶中的所有群組AWS 區域，請使用萬用字元代替群組 ID：
"Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/*"
某些 AWS IoT Greengrass 動作 (例如，某些列示操作) 無法在特定資源上執行。在這些情況下，您必須使用萬用字元 (*)。
"Resource": "*"
若要在陳述式中指定多個資源 ARN，請將它們列在括號 ([]) 之間，並以逗號分隔，如下所示：
"Resource": [ "resource-arn1", "resource-arn2", "resource-arn3" ]
如需 ARN 格式的詳細資訊，請參閱中的 Amazon 資源名稱 (ARN) 和AWS服務命名空間。Amazon Web Services 一般參考
條件索引鍵
管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說，哪個主體在什麼條件下可以對什麼資源執行哪些動作。
Condition 元素 (或 Condition 區塊) 可讓您指定使陳述式生效的條件。Condition 元素是選用項目。您可以建立使用條件運算子的條件運算式 (例如等於或小於)，來比對政策中的條件和請求中的值。
若您在陳述式中指定多個 Condition 元素，或是在單一 Condition 元素中指定多個索引鍵，AWS 會使用邏輯 AND 操作評估他們。若您為單一條件索引鍵指定多個值，AWS 會使用邏輯 OR 操作評估條件。必須符合所有條件，才會授與陳述式的許可。
您也可以在指定條件時使用預留位置變數。例如，您可以只在使用者使用其 IAM 使用者名稱標記時，將存取資源的許可授與該 IAM 使用者。如需更多資訊，請參閱《IAM 使用者指南》中的 IAM 政策元素：變數和標籤。
AWS 支援全域條件索引鍵和服務特定的條件索引鍵。若要查看 AWS 全域條件索引鍵，請參閱《IAM 使用者指南》中的 AWS 全域條件內容索引鍵。
AWS IoT Greengrass 支援下列全域條件鍵。
| 金錀 | 描述 |
|---|---|
aws:CurrentTime |
在日期/時間條件中檢查目前日期和時間，以篩選存取權。 |
aws:EpochTime |
在日期/時間條件中檢查以 epoch 或 Unix 時間表示的目前日期和時間，以篩選存取權。 |
aws:MultiFactorAuthAge |
檢查多久以前 (以秒為單位) 在請求中使用 MFA 發出由多重驗證 (MFA) 來驗證的安全登入資料，以篩選存取權。 |
aws:MultiFactorAuthPresent |
檢查是否使用多重驗證 (MFA) 來驗證發出目前請求的臨時安全登入資料，以篩選存取權。 |
aws:RequestTag/${TagKey} |
根據每個強制標籤的允許值集來篩選建立請求。 |
aws:ResourceTag/${TagKey} |
根據與資源相關聯的標籤值來篩選動作。 |
aws:SecureTransport |
檢查是否使用 SSL 傳送請求，以篩選存取權。 |
aws:TagKeys |
根據請求中是否存在強制標籤來篩選建立請求。 |
aws:UserAgent |
依請求者的用戶端應用程式來篩選存取權。 |
如需詳細資訊，請參閱《IAM 使用者指南》中的AWS 全域條件內容金鑰。
範例
若要檢視 AWS IoT Greengrass 身分型政策範例，請參閱 AWS IoT Greengrass 的身分型政策範例。
AWS IoT Greengrass 的資源型政策
AWS IoT Greengrass 不支援資源型政策。
存取控制清單 (ACL)
AWS IoT Greengrass 不支援 ACL。
以 AWS IoT Greengrass 標籤為基礎的授權
您可以將標籤連接到支援的 AWS IoT Greengrass 資源，或是在請求中將標籤傳遞給 AWS IoT Greengrass。若要根據標籤控制存取，您可以使用、或條件索引鍵在原則的「aws:ResourceTag/${TagKey}條aws:TagKeys件」元素中提供標籤資訊。aws:RequestTag/${TagKey}如需詳細資訊，請參閱 標記您的 AWS IoT Greengrass 資源。
AWS IoT Greengrass 的 IAM 角色
IAM 角色是您 AWS 帳戶 中具備特定許可的實體。
將臨時憑證與 AWS IoT Greengrass 搭配使用
臨時登入資料用於使用聯合登入、擔任 IAM 角色或擔任跨帳戶角色。您可以透過呼叫AssumeRole或等 AWS STS API 作業來取得臨時安全登入資料GetFederationToken。
在 Greengrass 核心上，群組角色的臨時登入資料可供使用者定義的 Lambda 函數和連接器使用。如果您的 Lambda 函數使用 AWS SDK，則不需要新增邏輯來取得認證，因為 AWS SDK 會為您執行此動作。
服務連結角色
AWS IoT Greengrass 不支援服務連結角色。
服務角色
此功能可讓服務代表您擔任服務角色。此角色可讓服務存取其他服務中的資源，以代表您完成動作。服務角色會出現在您的 IAM 帳戶中，且由該帳戶所擁有。這表示 IAM 管理員可以變更此角色的許可。不過，這樣可能會破壞此服務的功能。
AWS IoT Greengrass 會使用服務角色代表您存取部分 AWS 資源。如需詳細資訊，請參閱 Greengrass 服務角色。
在AWS IoT Greengrass主控台中選擇 IAM 角色
在AWS IoT Greengrass主控台中，您可能需要從帳戶中的 IAM 角色清單中選擇 Greengrass 服務角色或 Greengrass 群組角色。
-
Greengrass 服務角色允許 AWS IoT Greengrass 代表您存取其他服務中的 AWS 資源。一般而言，您不需要選擇服務角色，因為主控台可以為您建立和設定服務角色。如需詳細資訊，請參閱 Greengrass 服務角色。
-
Greengrass 群組角色可用來允許群組中的 Greengrass Lambda 函數和連接器存取您的資源。AWS它也可以AWS IoT Greengrass授與將串流匯出至AWS服務和寫入 CloudWatch 記錄的權限。如需更多詳細資訊，請參閱 Greengrass 群組角色。
