AWS IoT SiteWise 以身分為基礎的原則

IAM 政策可讓您控制誰可以在中執行操作 AWS IoT SiteWise。您可以決定允許或不允許哪些動作，並為這些動作設定特定條件。例如，您可以針對誰可以查看或變更中的資訊制定規則 AWS IoT SiteWise。 AWS IoT SiteWise 支援特定動作、資源和條件索引鍵。若要了解您在 JSON 政策中使用的所有元素，請參閱《IAM 使用者指南》中的 IAM JSON 政策元素參考。

政策動作

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

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

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

中的策略動作在動作之前 AWS IoT SiteWise 使用下列前置詞：iotsitewise:例如，若要授 AWS IoT SiteWise 與某人透過 BatchPutAssetPropertyValue API 作業將資產屬性資料上傳至某人的權限，您可以將iotsitewise:BatchPutAssetPropertyValue動作納入他們的政策中。原則陳述式必須包含Action或NotAction元素。 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 獨立授權每個資料項目。對於要求中授權失敗的任何個別項目，會AccessDeniedException在傳回的錯誤清單中 AWS IoT SiteWise 包含一個。 AWS IoT SiteWise 接收授權並成功之任何項目的資料，即使相同要求中的另一個項目失敗也是如此。

重要

將資料內嵌到資料串流之前，請執行下列動作：

• 如果您使用屬性別名來識別time-series資料串流，請授權資源。

• 如果您使用asset資產 ID 識別包含關聯資產屬性的資產，請授權資源。

政策資源

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

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

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

"Resource": "*"

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

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

如需 ARN 格式的詳細資訊，請參閱 Amazon 資源名稱 (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 操作評估他們。如果您為單一條件索引鍵指定多個值，請使用邏輯OR運算來 AWS 評估條件。必須符合所有條件，才會授與陳述式的許可。

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

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

重要

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

AWS IoT SiteWise 定義了它自己的一組條件鍵，並且還支持使用一些全局條件鍵。若要查看所有 AWS 全域條件金鑰，請參閱《IAM 使用者指南》中的AWS 全域條件內容金鑰。

AWS IoT SiteWise 條件鍵
條件金鑰	描述	類型
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:iam	列出存取政策時，IAM 身分識別的 ARN。使用此條件金鑰可定義 IAM 身分的存取政策許可。 範例值：arn:aws:iam::123456789012:user/JohnDoe	字串、Null
iotsitewise:propertyAlias	識別資產屬性或資料串流的別名。使用此條件鍵可根據別名定義權限。	字串
iotsitewise:user	列出存取政策時，IAM 身分中心使用者的 ID。使用此條件金鑰可為 IAM 身分中心使用者定義存取政策許可。 範例值：a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE	字串、Null
iotsitewise:group	列出存取政策時，IAM 身分中心群組的 ID。使用此條件金鑰可定義 IAM 身分中心群組的存取政策許可。 範例值：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 以識別為基礎的原則範例