AWS IoT SiteWise 身分型政策範例 - AWS IoT SiteWise
政策最佳實務使用主控台允許使用者檢視他們自己的許可允許使用者在一個階層中將資料擷取至資產根據標籤檢視 AWS IoT SiteWise 資產

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

AWS IoT SiteWise 身分型政策範例

根據預設，實體 （使用者和角色） 沒有建立或修改 AWS IoT SiteWise 資源的許可。他們也無法使用 AWS 管理主控台、 AWS Command Line Interface (AWS CLI) 或 AWS API 執行任務。若要調整許可， AWS Identity and Access Management (IAM) 管理員必須執行下列動作：

  1. 建立 IAM 政策，授予使用者和角色對所需資源執行特定 API 操作的許可。

  2. 將這些政策連接到需要這些許可的使用者或群組。

若要了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱《IAM 使用者指南》中的在 JSON 標籤上建立政策。

政策最佳實務

身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除 AWS IoT SiteWise 資源。這些動作可能會讓您的 AWS 帳戶產生費用。當您建立或編輯身分型政策時，請遵循下列準則及建議事項：

  • 開始使用 AWS 受管政策並邁向最低權限許可 – 若要開始將許可授予您的使用者和工作負載，請使用將許可授予許多常見使用案例的 AWS 受管政策。它們可在您的 中使用 AWS 帳戶。我們建議您定義特定於使用案例 AWS 的客戶受管政策，以進一步減少許可。如需更多資訊，請參閱《IAM 使用者指南》中的 AWS 受管政策或任務職能的AWS 受管政策。

  • 套用最低權限許可 – 設定 IAM 政策的許可時，請僅授予執行任務所需的許可。為實現此目的，您可以定義在特定條件下可以對特定資源採取的動作，這也稱為最低權限許可。如需使用 IAM 套用許可的更多相關資訊，請參閱《IAM 使用者指南》中的 IAM 中的政策和許可。

  • 使用 IAM 政策中的條件進一步限制存取權 – 您可以將條件新增至政策，以限制動作和資源的存取。例如，您可以撰寫政策條件，指定必須使用 SSL 傳送所有請求。如果透過特定 例如 使用服務動作 AWS 服務，您也可以使用條件來授予其存取權 CloudFormation。如需詳細資訊，請參閱《IAM 使用者指南》中的 IAM JSON 政策元素：條件。

  • 使用 IAM Access Analyzer 驗證 IAM 政策，確保許可安全且可正常運作 – IAM Access Analyzer 驗證新政策和現有政策，確保這些政策遵從 IAM 政策語言 (JSON) 和 IAM 最佳實務。IAM Access Analyzer 提供 100 多項政策檢查及切實可行的建議，可協助您撰寫安全且實用的政策。如需詳細資訊，請參閱《IAM 使用者指南》中的使用 IAM Access Analyzer 驗證政策。

  • 需要多重要素驗證 (MFA) – 如果您的案例需要 IAM 使用者或 中的根使用者 AWS 帳戶，請開啟 MFA 以提高安全性。如需在呼叫 API 操作時請求 MFA，請將 MFA 條件新增至您的政策。如需詳細資訊，請參閱《IAM 使用者指南》中的透過 MFA 的安全 API 存取。

如需 IAM 中最佳實務的相關資訊，請參閱《IAM 使用者指南》中的 IAM 安全最佳實務。

使用 AWS IoT SiteWise 主控台

若要存取 AWS IoT SiteWise 主控台，您需要一組基本許可。這些許可可讓您查看和管理帳戶中 AWS IoT SiteWise 資源的詳細資訊 AWS 。

如果您設定的政策太嚴格，則主控台可能無法使用該政策的使用者或角色 （實體） 如預期般運作。為了確保這些實體仍然可以使用 AWS IoT SiteWise 主控台，請將 AWSIoTSiteWiseConsoleFullAccess 受管政策連接到這些實體，或定義這些實體的同等許可。如需詳細資訊，請參閱《IAM 使用者指南》中的新增許可到使用者。

如果實體僅使用 AWS Command Line Interface (CLI) 或 AWS IoT SiteWise API，而不是主控台，則不需要這些最低許可。在這種情況下，只要讓他們存取 API 任務所需的特定動作即可。

允許使用者檢視他們自己的許可

此範例會示範如何建立政策，允許 IAM 使用者檢視附加到他們使用者身分的內嵌及受管政策。此政策包含在主控台或使用 或 AWS CLI AWS API 以程式設計方式完成此動作的許可。

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}

允許使用者在一個階層中將資料擷取至資產

在此範例中，您想要授予 AWS 帳戶中的使用者從根資產 開始，將資料寫入特定資產階層中所有資產屬性的存取權a1b2c3d4-5678-90ab-cdef-22222EXAMPLE。政策會將 iotsitewise:BatchPutAssetPropertyValue 許可授予使用者。此政策會使用 iotsitewise:assetHierarchyPath 條件鍵來限制對階層路徑符合資產或其子代之資產的存取。

JSON
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "PutAssetPropertyValuesForHierarchy",
      "Effect": "Allow",
      "Action": "iotsitewise:BatchPutAssetPropertyValue",
      "Resource": "arn:aws:iotsitewise:*:*:asset/*",
      "Condition": {
        "StringLike": {
          "iotsitewise:assetHierarchyPath": [
            "/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
            "/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/*"
          ]
        }
      }
    }
  ]
}

根據標籤檢視 AWS IoT SiteWise 資產

使用身分型政策中的條件，根據標籤控制對 AWS IoT SiteWise 資源的存取。此範例說明如何建立允許資產檢視的政策。但是，只有在資產標籤 Owner 數值是該使用者的使用者名稱時，才會授予該許可。此政策也會授予在 主控台上完成此動作的許可。

JSON
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "ListAllAssets",
      "Effect": "Allow",
      "Action": [
        "iotsitewise:ListAssets",
        "iotsitewise:ListAssociatedAssets"
      ],
      "Resource": "*"
    },
    {
      "Sid": "DescribeAssetIfOwner",
      "Effect": "Allow",
      "Action": "iotsitewise:DescribeAsset",
      "Resource": "arn:aws:iotsitewise:*:*:asset/*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/Owner": "${aws:username}"
        }
      }
    }
  ]
}

將此政策連接至您帳戶中的使用者。如果名為 的使用者richard-roe嘗試檢視 AWS IoT SiteWise 資產，資產必須加上標籤 Owner=richard-roe或 owner=richard-roe。否則，Richard 會被拒絕存取。條件標籤金鑰名稱不區分大小寫。因此， 同時Owner符合 Owner和 owner。如需詳細資訊，請參閱《IAM 使用者指南》中的 IAM JSON 政策元素：條件。