기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS IoT SiteWise 자격 증명 기반 정책
IAM 정책을 사용하면 AWS IoT SiteWise에서 누가 어떤 작업을 수행할 수 있는지 제어할 수 있습니다. 허용되는 작업을 결정하고 이러한 작업에 대한 구체적인 조건을 설정할 수 있습니다. 예를 들어에서 정보를 보거나 변경할 수 있는 사용자에 대한 규칙을 만들 수 있습니다 AWS IoT SiteWise.는 특정 작업, 리소스 및 조건 키를 AWS IoT SiteWise 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알아보려면 IAM 사용자 설명서의 IAM JSON 정책 요소 참조를 참조하세요.
정책 작업
관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 엔터티가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.
JSON 정책의 Action요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.
의 정책 작업은 작업 앞에 접두사를 AWS IoT SiteWise 사용합니다iotsitewise:. 예를 들어 API BatchPutAssetPropertyValue 작업을 사용하여에 자산 속성 데이터를 업로드할 수 AWS IoT SiteWise 있는 권한을 부여하려면 해당 정책에 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리소스에 권한을 부여합니다. -
연결된 자산 속성이 포함된 자산을 식별하기 위해 자산 ID를 사용하는 경우
asset리소스에 권한을 부여합니다.
정책 리소스
관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 위탁자가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.
Resource JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 Amazon 리소스 이름(ARN)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(*)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.
"Resource": "*"
각 IAM 정책 명령문은 ARN을 사용하여 지정한 리소스에 적용됩니다. ARN의 일반적인 구문은 다음과 같습니다.
arn:${Partition}:${Service}:${Region}:${Account}:${ResourceType}/${ResourcePath}
ARN 형식에 대한 자세한 내용은 Amazon AWS 리소스 이름(ARNs)을 사용하여 리소스 식별을 참조하세요.
예를 들어 명령문에서 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 리소스 유형 및 해당 ARNs 목록을 보려면 IAM 사용 설명서의에서 정의한 리소스 유형을 AWS IoT SiteWise 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 AWS IoT SiteWise에서 정의한 작업을 참조하세요.
정책 조건 키
관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 엔터티가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.
Condition 요소는 정의된 기준에 따라 문이 실행되는 시기를 지정합니다. 같음(equals) 또는 미만(less than)과 같은 조건 연산자를 사용하여 정책의 조건을 요청의 값과 일치시키는 조건식을 생성할 수 있습니다. 모든 AWS 전역 조건 키를 보려면 IAM 사용 설명서의 AWS 전역 조건 컨텍스트 키를 참조하세요.
중요
여러 조건 키들이 하나의 리소스에 딸려 있고, 일부 API 작업은 다수의 리소스를 사용합니다. 조건 키로 정책 설명문을 작성하려면 설명문의 Resource 요소를 사용해 조건 키가 적용되는 리소스를 지정합니다. 그렇게 하지 않으면, 조건 키가 해당되지 않는 리소스에 대해서는 조건 검사가 실패하여 정책이 사용자로 하여금 작업을 전혀 수행하지 못하게 막을 수도 있습니다. 리소스를 지정하고 싶지 않거나 다수의 API 작업을 포함하도록 정책의 Action 요소를 작성했다면, 반드시 ...IfExists 조건 유형을 사용해 조건 키가 그것을 사용하지 않는 리소스에 대해서는 무시되도록 해야 합니다. 자세한 내용은 IAM 사용 설명서의 ...IfExists 조건을 참조하세요.
AWS IoT SiteWise 는 자체 조건 키 세트를 정의하고 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 IAM 사용 설명서의 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | 유형 |
|---|---|---|
iotsitewise:isAssociatedWithAssetProperty |
데이터 스트림이 자산 속성과 연결되어 있는지 여부입니다. 이 조건 키를 사용하여 데이터 스트림에 대한 관련 자산 속성의 존재 여부에 따라 권한을 정의할 수 있습니다. 예제 값: |
문자열 |
iotsitewise:assetHierarchyPath |
슬래시로 구분된 자산 ID의 문자열인 자산의 계층 구조 경로입니다. 이 조건 키를 사용하여 계정에 있는 모든 자산의 계층 구조 하위 집합을 기반으로 권한을 정의할 수 있습니다. 예제 값: |
문자열 |
iotsitewise:propertyId |
자산 속성의 ID입니다. 자산 모델의 지정된 속성을 기반으로 사용 권한을 정의하려면 이 조건 키를 사용합니다. 이 조건 키는 해당 모델의 모든 자산에 적용됩니다. 예제 값: |
문자열 |
iotsitewise:childAssetId |
다른 자산에 대한 하위 자산으로 연결된 자산 ID입니다. 이 조건 키를 사용하여 하위 자산을 기반으로 사용 권한을 정의합니다. 상위 자산을 기반으로 권한을 정의하려면 정책 설명의 리소스 섹션을 사용합니다. 예제 값: |
문자열 |
iotsitewise:iam |
액세스 정책을 나열할 때 IAM ID의 ARN입니다. 이 조건 키를 사용하여 IAM ID에 대한 액세스 정책 권한을 정의합니다. 예제 값: |
String, Null |
iotsitewise:propertyAlias |
자산 속성 또는 데이터 스트림을 식별하는 별칭입니다. 이 조건 키를 사용하여 별칭을 기반으로 사용 권한을 정의합니다. |
문자열 |
iotsitewise:user |
액세스 정책을 나열할 때 IAM Identity Center 사용자의 ID입니다. 이 조건 키를 사용하여 IAM Identity Center 사용자에 대한 액세스 정책 권한을 정의합니다. 예제 값: |
String, Null |
iotsitewise:group |
액세스 정책을 나열할 때 IAM Identity Center 그룹의 ID입니다. 이 조건 키를 사용하여 IAM Identity Center 그룹에 대한 액세스 정책 권한을 정의합니다. 예제 값: |
String, Null |
iotsitewise:portal |
액세스 정책의 포털 ID입니다. 포털을 기반으로 액세스 정책 권한을 정의하려면 이 조건 키를 사용합니다. 예제 값: |
String, Null |
iotsitewise:project |
액세스 정책의 프로젝트 ID 또는 대시보드에 대한 프로젝트 ID입니다. 이 조건 키를 사용하여 프로젝트를 기반으로 대시보드 또는 액세스 정책 권한을 정의할 수 있습니다. 예제 값: |
String, Null |
조건 키를 사용할 수 있는 작업과 리소스를 알아보려면 에서 정의한 작업을 AWS IoT SiteWise 참조하세요.
예제
자격 AWS IoT SiteWise 증명 기반 정책의 예를 보려면 섹션을 참조하세요AWS IoT SiteWise 자격 증명 기반 정책 예제.