AWS IoT SiteWise 搭配 IAM 的運作方式 - AWS IoT SiteWise

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

AWS IoT SiteWise 搭配 IAM 的運作方式

使用 IAM 來管理 AWS IoT SiteWise 的存取權之前,您應該先了解可與 AWS IoT SiteWise 搭配使用的 IAM 功能有哪些。

若要取得 AWS IoT SiteWise 和其他 AWS 服務如何搭配 IAM 使用的詳細資訊,請參閱 IAM 使用者指南中的可搭配 IAM 使用的 AWS 服務

AWS IoT SiteWise 身分型政策

使用 IAM 身分類型政策,您可以指定允許或拒絕的動作和資源,以及在何種條件下會允許或拒絕動作。AWS IoT SiteWise 支援特定動作、資源及條件索引鍵。若要了解您在 JSON 政策中使用的所有元素,請參閱《IAM 使用者指南》中的 IAM JSON 政策元素參考

動作

管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作

JSON 政策的 Action 元素描述您可以用來允許或拒絕政策中存取的動作。政策動作的名稱通常會和相關聯的 AWS API 操作相同。有一些例外狀況,例如沒有相符的 API 作業的僅限許可動作。也有一些作業需要政策中的多個動作。這些額外的動作稱為相依動作

政策會使用動作來授予執行相關聯操作的許可。

中的政策動作AWS IoT SiteWise執行動作前使用以下字首:iotsitewise:。 例如,若要授予某人將資產屬性資料上傳至AWS IoT SiteWise使用BatchPutAssetPropertyValueAPI 操作時,您可以包含iotsitewise:BatchPutAssetPropertyValue行動在他們的政策。政策陳述式必須包含 ActionNotAction 元素。AWS IoT SiteWise 會定義一組自己的動作,來描述您可以使用此服務執行的任務。

若要在單一陳述式中指定多個動作,請用逗號分隔,如下所示。

"Action": [ "iotsitewise:action1", "iotsitewise:action2" ]

您也可以使用萬用字元 (*) 來指定多個動作。例如,若要指定開頭是 Describe 文字的所有動作,請包含以下動作:

"Action": "iotsitewise:Describe*"

若要查看 AWS IoT SiteWise 動作的清單,請參閱《IAM 使用者指南》AWS IoT SiteWise 定義的動作

BatchPutAssetPropertyValue 授權

AWS IoT SiteWise授權存取BatchPutAssetPropertyValue行動在不尋常的方式。針對大部分的動作,當您允許或拒絕存取動作時如果未授予許可,該動作會傳回錯誤。使用 BatchPutAssetPropertyValue 時,您可以在單一 API 請求中將多個資料項目傳送至不同的資產和資產屬性,且 AWS IoT SiteWise 會獨立授權每個資料項目。針對要求中授權失敗的任何個別項目,AWS IoT SiteWise 會在傳回的錯誤清單中加入 AccessDeniedException。AWS IoT SiteWise 會接收任何進行授權並成功通過之項目的資料,即使相同請求中的另一個項目失敗也一樣。

重要

在將數據提取到數據流之前,請執行以下操作。

  • 所以此time-series如果使用屬性別名來標識數據流,則必須對資源進行授權。

  • 所以此asset如果您使用資產 ID 來標識包含關聯資產屬性的資產,則必須對資源進行授權。

資源

管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作

Resource JSON 政策元素可指定要套用動作的物件。陳述式必須包含 ResourceNotResource 元素。最佳實務是使用其 Amazon 資源名稱 (ARN) 來指定資源。您可以針對支援特定資源類型的動作 (稱為資源層級許可) 來這麼做。

對於不支援資源層級許可的動作 (例如列出作業),請使用萬用字元 (*) 來表示陳述式適用於所有資源。

"Resource": "*"

每個 IAM 政策陳述式都會套用到您使用其 ARN 指定的資源。ARN 一般的語法如下所示。

arn:${Partition}:${Service}:${Region}:${Account}:${ResourceType}/${ResourcePath}

如需 ARN 格式的詳細資訊,請參閱 Amazon Resource Name (ARN) 和 AWS 服務命名空間

例如,若要在陳述式中指定 ID 為 a1b2c3d4-5678-90ab-cdef-22222EXAMPLE 的資產,請使用下列 ARN。

"Resource": "arn:aws:iotsitewise:region:123456789012:asset/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"

若要指定屬於特定帳户的所有資料串流,請使用萬用字元 (*):

"Resource": "arn:aws:iotsitewise:region:123456789012:time-series/*"

若要指定屬於特定帳戶的所有資產,請使用萬用字元 (*):

"Resource": "arn:aws:iotsitewise:region:123456789012:asset/*"

有些 AWS IoT SiteWise 動作 (例如用來建立資源的動作) 無法在特定資源上執行。在這些情況下,您必須使用萬用字元 (*)。

"Resource": "*"

若要在單一陳述式中指定多項資源,請使用逗號分隔 ARN。

"Resource": [ "resource1", "resource2" ]

若要查看 AWS IoT SiteWise 資源類型及其 ARN 的清單,請參閱《IAM 使用者指南》中的 AWS IoT SiteWise 定義的資源。若要了解您可以使用哪些動作指定每個資源的 ARN,請參閱 AWS IoT SiteWise 定義的動作

條件金鑰

管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作

Condition 元素 (或 Condition 區塊) 可讓您指定使陳述式生效的條件。Condition 元素是選用項目。您可以建立使用條件運算子的條件表達式 (例如等於或小於),來比對政策中的條件和請求中的值。

若您在陳述式中指定多個 Condition 元素,或是在單一 Condition 元素中指定多個金鑰,AWS 會使用邏輯 AND 操作評估他們。若您為單一條件索引鍵指定多個值,AWS 會使用邏輯 OR 操作評估條件。必須符合所有條件,才會授予陳述式的許可。

您也可以在指定條件時使用預留位置變數。例如,您可以只在使用者使用其 IAM 使用者名稱標記時,將存取資源的許可授予該 IAM 使用者。如需詳細資訊,請參閱《IAM 使用者指南》中的 IAM 政策元素:變數和標籤

AWS 支援全域條件索引鍵和服務特定的條件索引鍵。若要查看 AWS 全域條件金鑰,請參閱《IAM 使用者指南》中的 AWS 全域條件內容金鑰

重要

許多條件鍵均為資源專屬,而且部分 API 動作使用多個資源。若您撰寫的政策陳述式具備條件鍵,請使用陳述式的 Resource 元素來指定套用該條件鍵的資源。如果您未這麼做,該政策可能會導致使用者完全無法執行該動作,因為未套用條件鍵之資源的條件檢查會失敗。若您不希望指定資源,或者若已撰寫政策的 Action 元素來納入多個 API 動作,則您必須使用 ...IfExists 條件類型,以確保未使用該條件鍵的資源,忽略該條件鍵。如需詳細資訊,請參閱「」... IfExists 條件中的IAM User Guide

AWS IoT SiteWise 會定義自己的一組條件索引鍵,也支援一些全域條件索引鍵的使用。若要查看 AWS 全域條件金鑰,請參閱《IAM 使用者指南》中的 AWS 全域條件內容金鑰

AWS IoT SiteWise 條件索引鍵
條件金鑰 Description (描述) 類型
iotsitewise:isAssociatedWithAssetProperty

數據流是否與資產屬性相關聯。使用此條件鍵可根據存在的資產屬性來定義許可。

範例值:true

字串
iotsitewise:assetHierarchyPath

資產的階層路徑,也就是資產 ID 的字串,每個都以正斜線分隔。使用此條件鍵可根據帳戶中所有資產階層的子集來定義許可。

範例值:/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/a1b2c3d4-5678-90ab-cdef-66666EXAMPLE

字串
iotsitewise:propertyId

資產屬性的 ID。使用此條件鍵可根據資產模型的指定屬性來定義許可。此條件鍵適用於該模型的所有資產。

範例值:a1b2c3d4-5678-90ab-cdef-33333EXAMPLE

字串
iotsitewise:childAssetId

資產的 ID,此資產是其他資產相關聯的子系。使用此條件鍵可根據子資產定義許可。若要根據父資產來定義許可,請使用政策陳述式的資源區段。

範例值:a1b2c3d4-5678-90ab-cdef-66666EXAMPLE

字串
iotsitewise:iamArn

列出存取政策時的 IAM 身份 ARN。使用此條件機碼可定義 IAM 身份的存取政策許可。

範例值:arn:aws:iam::123456789012:user/JohnDoe

字串、Null
iotsitewise:user

列出存取政策時的 AWS SSO 使用者 ID。使用此條件鍵來定義使用 AWS SSO 使用者的存取政策許可。

範例值:a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE

字串、Null
iotsitewise:group

列出存取政策時的 AWS SSO 群組 ID。使用此條件機碼可定義 AWS SSO 群組的存取政策許可。

範例值:a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE

字串、Null
iotsitewise:portal

存取政策中入口網站的 ID。使用此條件鍵,根據入口網站定義存取政策許可。

範例值:a1b2c3d4-5678-90ab-cdef-77777EXAMPLE

字串、Null
iotsitewise:project

存取政策中專案的 ID,或儀表板的專案 ID。使用此條件鍵,根據專案定義儀表板或存取政策許可。

範例值:a1b2c3d4-5678-90ab-cdef-88888EXAMPLE

字串、Null

若要了解您可以針對何種動作及資源使用條件索引鍵,請參閱 AWS IoT SiteWise 定義的動作

範例

若要檢視 AWS IoT SiteWise 身分型政策範例,請參閱 AWS IoT SiteWise 身分型政策範例

AWS IoT SiteWise 資源型政策

AWS IoT SiteWise 不支援資源型政策

存取控制清單 (ACL)

AWS IoT SiteWise 不支援 ACL

以 AWS IoT SiteWise 標籤為基礎的授權

您可以將標籤連接到 AWS IoT SiteWise 資源,或是在請求中將標籤傳遞給 AWS IoT SiteWise。若要根據標籤控制存取,請使用 aws:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 條件索引鍵,在政策的條件元素中,提供標籤資訊。如需標記 AWS IoT SiteWise 資源的詳細資訊,請參閱 標記您的 AWS IoT SiteWise 資源

若要檢視身分型政策範例,以根據該資源上的標籤來限制存取資源,請參閱 根據標籤檢視 AWS IoT SiteWise 資產

AWS IoT SiteWise IAM 角色

IAM 角色是您 AWS 帳戶中具備特定許可的實體。

將臨時憑證與 AWS IoT SiteWise 搭配使用

您可以搭配聯合使用臨時憑證、擔任 IAM 角色,或是擔任跨帳戶角色。您取得臨時安全憑證的方式是透過呼叫 AWS STS API 操作 (例如,AssumeRoleGetFederationToken)。

AWS IoT SiteWise 支援使用臨時憑證。

SiteWise 智能監視器支援聯合使用者存取入口網站。門户用户使用AWS SSO或者IAM 登入資料。

重要

IAM 用户或角色必須具有iotsitewise:DescribePortal登入入使用者的許可。

使用者登入入口網站時, SiteWise 監視器會產生提供下列許可的會話政策:

  • 您帳戶 AWS IoT SiteWise 中資產和資產資料的唯讀存取權,由該入口網站角色提供存取。

  • 存取該入口網站中使用者具有管理員 (專案擁有者) 或唯讀 (專案檢視者) 存取權的專案。

如需聯合入口網站使用者許可的詳細資訊,請參閱使用適用於 AWS IoT SiteWise Monitor 的服務角色

服務連結角色

服務連結角色可讓 AWS 服務存取其他服務中的資源,以代您完成動作。服務連結角色會顯示在您的 IAM 帳戶中,並由該服務所擁有。IAM 管理員可以檢視,但不能編輯服務連結角色的許可。

AWS IoT SiteWise 支援服務連結角色。如需建立或管理 AWS IoT SiteWise 服務連結角色的詳細資訊,請參閱使用 AWS IoT SiteWise 的服務連結角色

服務角色

此功能可讓服務代表您擔任服務角色。此角色可讓服務存取其他服務中的資源,以代表您完成動作。服務角色會出現在您的 IAM 帳戶中,且由該帳戶所擁有。這表示 IAM 管理員可以變更此角色的許可。不過,這樣可能會破壞此服務的功能。

AWS IoT SiteWise使用服務角色允許 SiteWise 監控門户用户以訪問AWS IoT SiteWise資源。如需詳細資訊,請參閱 使用適用於 AWS IoT SiteWise Monitor 的服務角色

您必須具有所需的權限,然後才能創建AWS IoT Events中的警示模型AWS IoT SiteWise。如需詳細資訊,請參閱 設定 的許可AWS IoT Events警報

在 AWS IoT SiteWise 中選擇 IAM 角色

建立portal資源AWS IoT SiteWise,您必須選擇角色,以允許 SiteWise 監視門户以訪問AWS IoT SiteWise會代表您執行。如果您之前已建立服務角色,則 AWS IoT SiteWise 會提供一個角色清單供您選擇。否則,您可以在建立入口網站時建立具有必要許可的角色。請務必選擇允許存取您資產和資產資料的角色。如需詳細資訊,請參閱 使用適用於 AWS IoT SiteWise Monitor 的服務角色