기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 에 대한 자격 증명 및 액세스 관리 AWS IoT SiteWise AWS Identity and Access Management (IAM)는 관리자가 AWS 리소스에 대한 액세스를 안전하게 제어하는 데 도움이 AWS 서비스 되는 입니다. IAM 관리자는 누가 AWS IoT SiteWise 리소스를 사용할 수 있는 *인증*(로그인) 및 *권한*(권한 있음)을 받을 수 있는지 제어합니다. IAM은 추가 비용 없이 사용할 수 AWS 서비스 있는 입니다. **Topics** + [ # AWS IoT SiteWise 보안 대상 ](security_iam_audience.md) + [ # 에서 자격 증명으로 인증 AWS IoT SiteWise ](security_iam_authentication.md) + [ # AWS IoT SiteWise 에서 IAM을 사용하는 방법 ](security_iam_service-with-iam.md) + [ # AWS 에 대한 관리형 정책 AWS IoT SiteWise ](security-iam-awsmanpol.md) + [ # 에 대한 서비스 연결 역할 사용 AWS IoT SiteWise ](using-service-linked-roles.md) + [ # 에서 이벤트 경보에 대한 권한 설정 AWS IoT SiteWise ](alarms-iam-permissions.md) + [ # 의 교차 서비스 혼동된 대리자 방지 AWS IoT SiteWise ](cross-service-confused-deputy-prevention.md) + [ # AWS IoT SiteWise 자격 증명 및 액세스 문제 해결 ](security_iam_troubleshoot.md) # AWS IoT SiteWise 보안 대상 AWS Identity and Access Management (IAM)를 사용하는 방법은 역할에 따라 다릅니다. + **서비스 사용자** - 기능에 액세스할 수 없는 경우 관리자에게 권한 요청(참조[AWS IoT SiteWise 자격 증명 및 액세스 문제 해결](security_iam_troubleshoot.md)) + **서비스 관리자** - 사용자 액세스 결정 및 권한 요청 제출([AWS IoT SiteWise 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md) 참조) + **IAM 관리자** - 액세스를 관리하기 위한 정책 작성([AWS IoT SiteWise 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md) 참조) # 에서 자격 증명으로 인증 AWS IoT SiteWise 인증은 자격 증명 자격 증명을 AWS 사용하여에 로그인하는 방법입니다. AWS 계정 루트 사용자, IAM 사용자 또는 IAM 역할을 수임하여 인증되어야 합니다. AWS IAM Identity Center (IAM Identity Center), Single Sign-On 인증 또는 Google/Facebook 자격 증명과 같은 자격 증명 소스의 자격 증명을 사용하여 페더레이션 자격 증명으로 로그인할 수 있습니다. 로그인하는 방법에 대한 자세한 내용은 *AWS Sign-In 사용 설명서*의 [AWS 계정에 로그인하는 방법](https://docs.aws.amazon.com/signin/latest/userguide/how-to-sign-in.html) 섹션을 참조하세요. 프로그래밍 방식 액세스를 위해는 요청에 암호화 방식으로 서명할 수 있는 SDK 및 CLI를 AWS 제공합니다. 자세한 내용은 *IAM 사용 설명서*의 [API 요청용AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 섹션을 참조하세요. ## AWS 계정 루트 사용자 를 생성할 때 모든 AWS 서비스 및 리소스에 대한 완전한 액세스 권한이 있는 AWS 계정 *theroot 사용자*라는 하나의 로그인 자격 증명으로 AWS 계정시작합니다. 일상적인 태스크에 루트 사용자를 사용하지 않을 것을 강력히 권장합니다. 루트 사용자가 필요한 작업 목록은 *IAM 사용자 설명서*의 [루트 사용자 자격 증명이 필요한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)을 참조하세요. ## IAM 사용자 및 그룹 *[IAM 사용자](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html)*는 단일 개인 또는 애플리케이션에 대한 특정 권한을 가진 ID입니다. 장기 자격 증명이 있는 IAM 사용자 대신 임시 자격 증명을 사용하는 것이 좋습니다. 자세한 내용은 *IAM 사용 설명서*의 자격 [증명 공급자와의 페더레이션을 사용하여 임시 자격 증명을 AWS 사용하여에 액세스하도록 인간 사용자에게 요구](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)하기를 참조하세요. [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html)은 IAM 사용자 모음을 지정하고 대규모 사용자 집합에 대한 관리 권한을 더 쉽게 만듭니다. 자세한 내용은 *IAM 사용 설명서*의 [IAM 사용자 사용 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/gs-identities-iam-users.html) 섹션을 참조하세요. ## IAM 역할 *[IAM 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)*은 임시 자격 증명을 제공하는 특정 권한이 있는 자격 증명입니다. [사용자에서 IAM 역할(콘솔)로 전환하거나 또는 API 작업을 호출하여 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) 수임할 수 있습니다. AWS CLI AWS 자세한 내용은 *IAM 사용 설명서*의 [역할 수임 방법](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html)을 참조하세요. IAM 역할은 페더레이션 사용자 액세스, 임시 IAM 사용자 권한, 교차 계정 액세스, 교차 서비스 액세스 및 Amazon EC2에서 실행되는 애플리케이션에 유용합니다. 자세한 내용은 *IAM 사용 설명서*의 [교차 계정 리소스 액세스](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)를 참조하세요. # AWS IoT SiteWise 에서 IAM을 사용하는 방법 AWS Identity and Access Management (IAM)를 사용하여 액세스를 관리하기 전에 어떤 IAM 기능을 사용할 수 있는지 이해해야 AWS IoT SiteWise합니다 AWS IoT SiteWise. | IAM 특성 | 에서 지원하나요 AWS IoT SiteWise? | | --- | --- | | [리소스 수준 권한이 있는 자격 증명 기반 정책](security_iam_service-with-iam-id-based-policies.md) | 예 | | [정책 작업](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-actions) | 예 | | [정책 리소스](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-resources) | 예 | | [정책 조건 키](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-conditionkeys) | 예 | | 리소스 기반 정책 | 아니요 | | 액세스 제어 목록(ACL) | 아니요 | | [태그 기반 권한 부여(ABAC)](security_iam_service-with-iam-tags.md) | 예 | | [임시 보안 인증](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-tempcreds) | 예 | | [전달 액세스 세션(FAS)](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-principal-permissions) | 예 | | [서비스 연결 역할](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service-linked) | 예 | | [서비스 역할](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service-linked) | 예 | AWS IoT SiteWise 및 기타 AWS 서비스에서 IAM을 사용하는 방법을 개괄적으로 알아보려면 *IAM 사용 설명서*의 [AWS IAM으로 작업하는 서비스를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하세요. **Contents** + [ # AWS IoT SiteWise IAM 역할 ](security_iam_service-with-iam-roles.md) + [ ## 에서 임시 자격 증명 사용 AWS IoT SiteWise ](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-tempcreds) + [ ## 에 대한 전달 액세스 세션(FAS) AWS IoT SiteWise ](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-principal-permissions) + [ ## 서비스 연결 역할 ](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service-linked) + [ ## 서비스 역할 ](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-service) + [ ## 에서 IAM 역할 선택 AWS IoT SiteWise ](security_iam_service-with-iam-roles.md#security_iam_service-with-iam-roles-choose) + [ # AWS IoT SiteWise 태그 기반 권한 부여 ](security_iam_service-with-iam-tags.md) + [ # AWS IoT SiteWise 자격 증명 기반 정책 ](security_iam_service-with-iam-id-based-policies.md) + [ ## 정책 작업 ](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-actions) + [ ### BatchPutAssetPropertyValue 권한 부여 ](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-batchputassetpropertyvalue-action) + [ ## 정책 리소스 ](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-resources) + [ ## 정책 조건 키 ](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-conditionkeys) + [ ## 예제 ](security_iam_service-with-iam-id-based-policies.md#security_iam_service-with-iam-id-based-policies-examples) + [ # AWS IoT SiteWise 자격 증명 기반 정책 예제 ](security_iam_id-based-policy-examples.md) + [ ## 정책 모범 사례 ](security_iam_id-based-policy-examples.md#security_iam_service-with-iam-policy-best-practices) + [ ## AWS IoT SiteWise 콘솔 사용 ](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-console) + [ ## 사용자가 자신의 고유한 권한을 볼 수 있도록 허용 ](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-own-permissions) + [ ## 사용자가 하나의 계층에서 자산에 데이터를 수집할 수 있도록 허용 ](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-ingest-to-one-asset-hierarchy) + [ ## 태그를 기반으로 AWS IoT SiteWise 자산 보기 ](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags) + [ # 의 정책을 사용하여 액세스 관리 AWS IoT SiteWise ](security_iam_access-manage.md) + [ ## ID 기반 정책 ](security_iam_access-manage.md#security_iam_access-manage-id-based-policies) + [ ## 리소스 기반 정책 ](security_iam_access-manage.md#security_iam_access-manage-resource-based-policies) + [ ## 액세스 제어 목록(ACL) ](security_iam_access-manage.md#security_iam_access-manage-acl) + [ ## 기타 정책 타입 ](security_iam_access-manage.md#security_iam_access-manage-other-policies) + [ ## 여러 정책 유형 ](security_iam_access-manage.md#security_iam_access-manage-multiple-policies) # AWS IoT SiteWise IAM 역할 IAM [역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)은 특정 권한을 가지고 있는 AWS 계정 내 엔터티입니다. ## 에서 임시 자격 증명 사용 AWS IoT SiteWise 임시 보안 인증을 사용하여 페더레이션을 통해 로그인하거나, IAM 역할을 맡거나, 교차 계정 역할을 맡을 수 있습니다. [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) 또는 [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html) 같은 AWS STS API 작업을 호출하여 임시 보안 인증을 가져옵니다. AWS IoT SiteWise 는 임시 자격 증명 사용을 지원합니다. SiteWise Monitor에서는 페더레이션 사용자가 포털에 액세스할 수 있도록 지원합니다. 포털 사용자는 IAM Identity Center 또는 IAM 보안 인증으로 인증합니다. **중요** 사용자 또는 역할에는 포털에 로그인할 수 있는 `iotsitewise:DescribePortal` 권한이 있어야 합니다. 사용자가 포털에 로그인하면 SiteWise Monitor에서는 다음 권한을 제공하는 세션 정책을 생성합니다. + 해당 포털의 역할이 액세스를 제공하는 계정의 AWS IoT SiteWise 에 있는 자산 및 자산 데이터에 대한 읽기 전용 액세스입니다. + 사용자에게 관리자(프로젝트 소유자) 또는 읽기 전용(프로젝트 뷰어) 액세스 권한이 있는 포털의 프로젝트에 액세스합니다. 페더레이션 포털 사용자 권한에 대한 자세한 내용은 [에 대한 서비스 역할 사용 AWS IoT SiteWise Monitor](monitor-service-role.md)을 참조하세요. ## 에 대한 전달 액세스 세션(FAS) AWS IoT SiteWise **전달 액세스 세션(FAS) 지원:** 예 전달 액세스 세션(FAS)은를 호출하는 보안 주체의 권한을 다운스트림 서비스에 AWS 서비스 대한 요청과 AWS 서비스함께 사용합니다. FAS 요청 시 정책 세부 정보는 [전달 액세스 세션](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)을 참조하세요. ## 서비스 연결 역할 [서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts) 사용하면 AWS 서비스가 다른 서비스의 리소스에 액세스하여 사용자를 대신하여 작업을 완료할 수 있습니다. 서비스 연결 역할은 AWS 계정에 표시되며 서비스가 소유합니다. IAM 관리자는 서비스 연결 역할의 권한을 볼 수 있지만 편집할 수 없습니다. AWS IoT SiteWise 는 서비스 연결 역할을 지원합니다. AWS IoT SiteWise 서비스 연결 역할을 생성 또는 관리하는 방법에 대한 자세한 내용은 [에 대한 서비스 연결 역할 사용 AWS IoT SiteWise](using-service-linked-roles.md)을 참조하세요. ## 서비스 역할 이 기능을 사용하면 서비스가 사용자를 대신하여 [서비스 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts)을 수임할 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 AWS 계정에 나타나며 계정이 소유합니다. 즉, IAM 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다. AWS IoT SiteWise 는 서비스 역할을 사용하여 SiteWise Monitor 포털 사용자가 사용자를 AWS IoT SiteWise 대신하여 일부 리소스에 액세스할 수 있도록 허용합니다. 자세한 내용은 [에 대한 서비스 역할 사용 AWS IoT SiteWise Monitor](monitor-service-role.md) 단원을 참조하십시오. AWS IoT Events 경보 모델을 생성하려면 먼저 필요한 권한이 있어야 합니다 AWS IoT SiteWise. 자세한 내용은 [에서 이벤트 경보에 대한 권한 설정 AWS IoT SiteWise](alarms-iam-permissions.md) 단원을 참조하십시오. ## 에서 IAM 역할 선택 AWS IoT SiteWise 에서 `portal` 리소스를 생성할 때 SiteWise Monitor 포털의 페더레이션 사용자가 AWS IoT SiteWise 사용자를 대신하여에 액세스할 수 있도록 허용하는 역할을 선택해야 AWS IoT SiteWise합니다. 이전에 서비스 역할을 생성한 경우는 선택할 수 있는 역할 목록을 AWS IoT SiteWise 제공합니다. 그렇지 않으면 포털을 만들 때 필요한 권한이 있는 역할을 만들 수 있습니다. 자산 및 자산 데이터에 대한 액세스를 허용하는 역할을 선택하는 것이 중요합니다. 자세한 내용은 [에 대한 서비스 역할 사용 AWS IoT SiteWise Monitor](monitor-service-role.md) 단원을 참조하십시오. # AWS IoT SiteWise 태그 기반 권한 부여 AWS IoT SiteWise 리소스에 태그를 연결하거나 요청에 태그를 전달할 수 있습니다 AWS IoT SiteWise. 태그에 근거하여 액세스를 제어하려면 `aws:ResourceTag/key-name`, `aws:RequestTag/key-name`또는 `aws:TagKeys`조건 키를 사용하여 정책의 [조건 요소](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)에 태그 정보를 제공합니다. AWS IoT SiteWise 리소스 태깅에 대한 자세한 내용은 [AWS IoT SiteWise 리소스에 태그 지정](tag-resources.md)을 참조하세요. 리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예시는 [태그를 기반으로 AWS IoT SiteWise 자산 보기](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags)에서 확인할 수 있습니다. # AWS IoT SiteWise 자격 증명 기반 정책 IAM 정책을 사용하면 AWS IoT SiteWise에서 누가 어떤 작업을 수행할 수 있는지 제어할 수 있습니다. 허용되는 작업을 결정하고 이러한 작업에 대한 구체적인 조건을 설정할 수 있습니다. 예를 들어에서 정보를 보거나 변경할 수 있는 사용자에 대한 규칙을 만들 수 있습니다 AWS IoT SiteWise.는 특정 작업, 리소스 및 조건 키를 AWS IoT SiteWise 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알아보려면 *IAM 사용자 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요. ## 정책 작업 관리자는 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" ] ``` 와일드카드(\$1)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, `Describe`라는 단어로 시작하는 모든 작업을 지정하려면 다음 작업을 포함합니다. ``` "Action": "iotsitewise:Describe*" ``` AWS IoT SiteWise 작업 목록을 보려면 *IAM 사용 설명서*의에서 [정의한 작업을 AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions) 참조하세요. ### BatchPutAssetPropertyValue 권한 부여 AWS IoT SiteWise 는 비정상적인 방식으로 [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) 작업에 대한 액세스를 승인합니다. 대부분의 작업에서 액세스를 허용하거나 거부하면 권한이 부여되지 않은 경우 해당 작업에서 오류가 반환됩니다. `BatchPutAssetPropertyValue`를 사용하면 단일 API 요청에서 여러 데이터 항목을 서로 다른 자산 및 자산 속성으로 보낼 수 있으며, 각 데이터 항목에 독립적으로 AWS IoT SiteWise 권한을 부여할 수 있습니다. 요청에서 권한 부여에 실패한 개별 항목의 경우는 반환된 오류 목록에 `AccessDeniedException`를 AWS IoT SiteWise 포함합니다.는 동일한 요청의 다른 항목이 실패하더라도 권한을 부여하고 성공하는 모든 항목에 대한 데이터를 AWS IoT SiteWise 수신합니다. **중요** 데이터 스트림으로 데이터를 수집하기 전에 다음을 수행하세요. 데이터 스트림을 식별하기 위해 속성 별칭을 사용하는 경우 `time-series` 리소스에 권한을 부여합니다. 연결된 자산 속성이 포함된 자산을 식별하기 위해 자산 ID를 사용하는 경우 `asset` 리소스에 권한을 부여합니다. ## 정책 리소스 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. `Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\$1)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다. ``` "Resource": "*" ``` 각 IAM 정책 명령문은 ARN을 사용하여 지정한 리소스에 적용됩니다. ARN의 일반적인 구문은 다음과 같습니다. ``` arn:${Partition}:${Service}:${Region}:${Account}:${ResourceType}/${ResourcePath} ``` ARN 형식에 대한 자세한 내용은 [Amazon AWS 리소스 이름(ARNs)을 사용하여 리소스 식별을 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). 예를 들어 명령문에서 ID가 `a1b2c3d4-5678-90ab-cdef-22222EXAMPLE`인 자산을 지정하려면 다음 ARN을 사용합니다. ``` "Resource": "arn:aws:iotsitewise:region:123456789012:asset/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" ``` 특정 계정에 속하는 모든 데이터 스트림을 지정하려면 와일드카드(\$1)를 사용합니다. ``` "Resource": "arn:aws:iotsitewise:region:123456789012:time-series/*" ``` 특정 계정에 속하는 모든 자산을 지정하려면 와일드카드(\$1)를 사용합니다. ``` "Resource": "arn:aws:iotsitewise:region:123456789012:asset/*" ``` 리소스를 생성하기 위한 작업과 같은 일부 AWS IoT SiteWise 작업은 특정 리소스에서 수행할 수 없습니다. 이러한 경우, 와일드카드(\$1)를 사용해야 합니다. ``` "Resource": "*" ``` 단일 문에서 여러 리소스를 지정하려면 ARN을 쉼표로 구분합니다. ``` "Resource": [ "resource1", "resource2" ] ``` AWS IoT SiteWise 리소스 유형 및 해당 ARNs 목록을 보려면 *IAM 사용 설명서*의에서 [정의한 리소스 유형을 AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies) 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 [AWS IoT SiteWise에서 정의한 작업](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions)을 참조하세요. ## 정책 조건 키 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. `Condition` 요소는 정의된 기준에 따라 문이 실행되는 시기를 지정합니다. 같음(equals) 또는 미만(less than)과 같은 [조건 연산자](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)를 사용하여 정책의 조건을 요청의 값과 일치시키는 조건식을 생성할 수 있습니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 참조하세요. **중요** 여러 조건 키들이 하나의 리소스에 딸려 있고, 일부 API 작업은 다수의 리소스를 사용합니다. 조건 키로 정책 설명문을 작성하려면 설명문의 `Resource` 요소를 사용해 조건 키가 적용되는 리소스를 지정합니다. 그렇게 하지 않으면, 조건 키가 해당되지 않는 리소스에 대해서는 조건 검사가 실패하여 정책이 사용자로 하여금 작업을 전혀 수행하지 못하게 막을 수도 있습니다. 리소스를 지정하고 싶지 않거나 다수의 API 작업을 포함하도록 정책의 `Action` 요소를 작성했다면, 반드시 `...IfExists` 조건 유형을 사용해 조건 키가 그것을 사용하지 않는 리소스에 대해서는 무시되도록 해야 합니다. 자세한 내용은 *IAM 사용 설명서*의 [...IfExists 조건](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Conditions_IfExists)을 참조하세요. AWS IoT SiteWise 는 자체 조건 키 세트를 정의하고 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 참조하세요. **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 ID의 ARN입니다. 이 조건 키를 사용하여 IAM ID에 대한 액세스 정책 권한을 정의합니다. 예제 값: `arn:aws:iam::123456789012:user/JohnDoe` | String, Null | | iotsitewise:propertyAlias | 자산 속성 또는 데이터 스트림을 식별하는 별칭입니다. 이 조건 키를 사용하여 별칭을 기반으로 사용 권한을 정의합니다. | 문자열 | | iotsitewise:user | 액세스 정책을 나열할 때 IAM Identity Center 사용자의 ID입니다. 이 조건 키를 사용하여 IAM Identity Center 사용자에 대한 액세스 정책 권한을 정의합니다. 예제 값: `a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE` | String, Null | | iotsitewise:group | 액세스 정책을 나열할 때 IAM Identity Center 그룹의 ID입니다. 이 조건 키를 사용하여 IAM Identity Center 그룹에 대한 액세스 정책 권한을 정의합니다. 예제 값: `a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE` | String, Null | | iotsitewise:portal | 액세스 정책의 포털 ID입니다. 포털을 기반으로 액세스 정책 권한을 정의하려면 이 조건 키를 사용합니다. 예제 값: `a1b2c3d4-5678-90ab-cdef-77777EXAMPLE` | String, Null | | iotsitewise:project | 액세스 정책의 프로젝트 ID 또는 대시보드에 대한 프로젝트 ID입니다. 이 조건 키를 사용하여 프로젝트를 기반으로 대시보드 또는 액세스 정책 권한을 정의할 수 있습니다. 예제 값: `a1b2c3d4-5678-90ab-cdef-88888EXAMPLE` | String, Null | 조건 키를 사용할 수 있는 작업과 리소스를 알아보려면 [에서 정의한 작업을 AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions) 참조하세요. ## 예제 자격 AWS IoT SiteWise 증명 기반 정책의 예를 보려면 섹션을 참조하세요[AWS IoT SiteWise 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md). # AWS IoT SiteWise 자격 증명 기반 정책 예제 기본적으로 엔터티(사용자 및 역할)에는 AWS IoT SiteWise 리소스를 생성하거나 수정할 수 있는 권한이 없습니다. 또한 AWS Management Console, AWS Command Line Interface (AWS CLI) 또는 AWS API를 사용하여 작업을 수행할 수 없습니다. 권한을 조정하려면 AWS Identity and Access Management (IAM) 관리자가 다음을 수행해야 합니다. 1. 필요한 리소스에서 특정 API 작업을 수행할 수 있는 권한을 사용자와 역할에 부여하는 IAM 정책을 생성합니다. 1. 해당 권한이 필요한 사용자 또는 그룹에 이러한 정책을 연결합니다. 이러한 예제 JSON 정책 문서를 사용하여 IAM ID 기반 정책을 생성하는 방법을 알아보려면 *IAM 사용자 설명서*의 [JSON 탭에서 정책 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)을 참조하세요. **Topics** + [ ## 정책 모범 사례 ](#security_iam_service-with-iam-policy-best-practices) + [ ## AWS IoT SiteWise 콘솔 사용 ](#security_iam_id-based-policy-examples-console) + [ ## 사용자가 자신의 고유한 권한을 볼 수 있도록 허용 ](#security_iam_id-based-policy-examples-view-own-permissions) + [ ## 사용자가 하나의 계층에서 자산에 데이터를 수집할 수 있도록 허용 ](#security_iam_id-based-policy-examples-ingest-to-one-asset-hierarchy) + [ ## 태그를 기반으로 AWS IoT SiteWise 자산 보기 ](#security_iam_id-based-policy-examples-view-asset-tags) ## 정책 모범 사례 자격 증명 기반 정책에 따라 계정에서 사용자가 AWS IoT SiteWise 리소스를 생성, 액세스 또는 삭제할 수 있는지 여부가 결정됩니다. 이 작업으로 인해 AWS 계정에 비용이 발생할 수 있습니다. ID 기반 정책을 생성하거나 편집할 때는 다음 지침과 권장 사항을 따르세요. + ** AWS 관리형 정책을 시작하고 최소 권한으로 전환 -** 사용자 및 워크로드에 권한 부여를 시작하려면 많은 일반적인 사용 사례에 대한 권한을 부여하는 *AWS 관리형 정책을* 사용합니다. 에서 사용할 수 있습니다 AWS 계정. 사용 사례에 맞는 AWS 고객 관리형 정책을 정의하여 권한을 추가로 줄이는 것이 좋습니다. 자세한 내용은 *IAM 사용 설명서*의 [AWS 관리형 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) 또는 [AWS 직무에 대한 관리형 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)을 참조하세요. + **최소 권한 적용** – IAM 정책을 사용하여 권한을 설정하는 경우, 작업을 수행하는 데 필요한 권한만 부여합니다. 이렇게 하려면 *최소 권한*으로 알려진 특정 조건에서 특정 리소스에 대해 수행할 수 있는 작업을 정의합니다. IAM을 사용하여 권한을 적용하는 방법에 대한 자세한 정보는 *IAM 사용 설명서*에 있는 [IAM의 정책 및 권한](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)을 참조하세요. + **IAM 정책의 조건을 사용하여 액세스 추가 제한** – 정책에 조건을 추가하여 작업 및 리소스에 대한 액세스를 제한할 수 있습니다. 예를 들어, SSL을 사용하여 모든 요청을 전송해야 한다고 지정하는 정책 조건을 작성할 수 있습니다. AWS 서비스와 같은 특정를 통해 사용되는 경우 조건을 사용하여 서비스 작업에 대한 액세스 권한을 부여할 수도 있습니다 CloudFormation. 자세한 내용은 *IAM 사용 설명서*의 [IAM JSON 정책 요소: 조건](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)을 참조하세요. + **IAM Access Analyzer를 통해 IAM 정책을 확인하여 안전하고 기능적인 권한 보장** - IAM Access Analyzer에서는 IAM 정책 언어(JSON)와 모범 사례가 정책에서 준수되도록 새로운 및 기존 정책을 확인합니다. IAM Access Analyzer는 100개 이상의 정책 확인 항목과 실행 가능한 추천을 제공하여 안전하고 기능적인 정책을 작성하도록 돕습니다. 자세한 내용은 *IAM 사용 설명서*의 [IAM Access Analyzer에서 정책 검증](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)을 참조하세요. + **다중 인증(MFA) 필요 -**에서 IAM 사용자 또는 루트 사용자가 필요한 시나리오가 있는 경우 추가 보안을 위해 MFA를 AWS 계정켭니다. API 작업을 직접적으로 호출할 때 MFA가 필요하면 정책에 MFA 조건을 추가합니다. 자세한 내용은 *IAM 사용 설명서*의 [MFA를 통한 보안 API 액세스](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)를 참조하세요. IAM의 모범 사례에 대한 자세한 내용은 *IAM 사용 설명서*의 [IAM의 보안 모범 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)를 참조하세요. ## AWS IoT SiteWise 콘솔 사용 AWS IoT SiteWise 콘솔에 액세스하려면 기본 권한 집합이 필요합니다. 이러한 권한을 통해 AWS 계정의 AWS IoT SiteWise 리소스에 대한 세부 정보를 보고 관리할 수 있습니다. 너무 제한적인 정책을 만들면 콘솔이 해당 정책의 사용자 또는 역할(엔터티)에 대해 예상대로 작동하지 않을 수 있습니다. 이러한 엔터티가 AWS IoT SiteWise 콘솔을 계속 사용할 수 있도록 하려면 [AWSIoTSiteWiseConsoleFullAccess](https://console.aws.amazon.com/iam/home#/policies/policies/arn:aws:iam::aws:policy/AWSIoTSiteWiseConsoleFullAccess) 관리형 정책을 해당 엔터티에 연결하거나 해당 엔터티에 대해 동등한 권한을 정의합니다. 자세한 내용은 *IAM 사용 설명서*의 [사용자에게 권한 추가](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)를 참조하세요. 엔터티가 콘솔이 아닌 AWS Command Line Interface (CLI) 또는 AWS IoT SiteWise API만 사용하는 경우 이러한 최소 권한이 필요하지 않습니다. 이 경우 API 작업에 필요한 특정 작업에 대한 액세스 권한을 부여하기만 하면 됩니다. ## 사용자가 자신의 고유한 권한을 볼 수 있도록 허용 이 예제는 IAM 사용자가 자신의 사용자 ID에 연결된 인라인 및 관리형 정책을 볼 수 있도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이 정책에는 콘솔에서 또는 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}" } } } ] } ``` ------ 이 정책을 계정의 사용자에게 연결합니다. 라는 사용자가 AWS IoT SiteWise 자산을 보려고 `richard-roe` 하면 자산에 `Owner=richard-roe` 또는 태그를 지정해야 합니다`owner=richard-roe`. 그러지 않으면 Richard는 액세스가 거부됩니다. 조건 태그 키 이름은 대/소문자를 구분하지 않습니다. `Owner`는 `Owner`와 `owner` 둘 다와 일치합니다. 자세한 정보는 *IAM 사용 설명서*의 [IAM JSON 정책 요소: 조건](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)을 참조하세요. # 의 정책을 사용하여 액세스 관리 AWS IoT SiteWise 정책을 AWS 생성하고 자격 증명 또는 리소스에 연결하여 AWS 에서 액세스를 제어합니다. 정책은 자격 증명 또는 리소스와 연결될 때 권한을 정의합니다.는 보안 주체가 요청할 때 이러한 정책을 AWS 평가합니다. 대부분의 정책은에 JSON 문서 AWS 로 저장됩니다. JSON 정책 문서에 대한 자세한 내용은 *IAM 사용 설명서*의 [JSON 정책 개요](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json) 섹션을 참조하세요. 정책을 사용하여 관리자는 어떤 **보안 주체**가 어떤 **리소스**에 대해 어떤 **조건**에서 **작업**을 수행할 수 있는지 정의하여 누가 무엇을 액세스할 수 있는지 지정합니다. 기본적으로 사용자 및 역할에는 어떠한 권한도 없습니다. IAM 관리자는 IAM 정책을 생성하고 사용자가 수임할 수 있는 역할에 추가합니다. IAM 정책은 작업을 수행하기 위해 사용하는 방법과 관계없이 작업에 대한 권한을 정의합니다. ## ID 기반 정책 ID 기반 정책은 ID(사용자, 사용자 그룹 또는 역할)에 연결하는 JSON 권한 정책 문서입니다. 이러한 정책은 자격 증명이 수행할 수 있는 작업, 대상 리소스 및 이에 관한 조건을 제어합니다. ID 기반 정책을 생성하는 방법을 알아보려면 *IAM 사용 설명서*에서 [고객 관리형 정책으로 사용자 지정 IAM 권한 정의](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)를 참조하세요. ID 기반 정책은 *인라인 정책*(단일 ID에 직접 포함) 또는 *관리형 정책*(여러 ID에 연결된 독립 실행형 정책)일 수 있습니다. 관리형 정책 또는 인라인 정책을 선택하는 방법을 알아보려면 *IAM 사용 설명서*의 [관리형 정책 및 인라인 정책 중에서 선택](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html) 섹션을 참조하세요. ## 리소스 기반 정책 리소스 기반 정책은 리소스에 연결하는 JSON 정책 설명서입니다. 예를 들어 IAM *역할 신뢰 정책* 및 Amazon S3 *버킷 정책*이 있습니다. 리소스 기반 정책을 지원하는 서비스에서 서비스 관리자는 이러한 정책을 사용하여 특정 리소스에 대한 액세스를 통제할 수 있습니다. 리소스 기반 정책에서 [보안 주체를 지정](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)해야 합니다. 리소스 기반 정책은 해당 서비스에 있는 인라인 정책입니다. 리소스 기반 정책에서는 IAM의 AWS 관리형 정책을 사용할 수 없습니다. ## 액세스 제어 목록(ACL) 액세스 제어 목록(ACL)은 어떤 위탁자(계정 멤버, 사용자 또는 역할)가 리소스에 액세스할 수 있는 권한을 가지고 있는지를 제어합니다. ACL은 JSON 정책 문서 형식을 사용하지 않지만 리소스 기반 정책과 유사합니다. Amazon S3 AWS WAF및 Amazon VPC는 ACLs. ACL에 관한 자세한 내용은 *Amazon Simple Storage Service 개발자 가이드*의 [액세스 제어 목록(ACL) 개요](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html)를 참조하세요. ## 기타 정책 타입 AWS 는 보다 일반적인 정책 유형에서 부여한 최대 권한을 설정할 수 있는 추가 정책 유형을 지원합니다. + **권한 경계** - ID 기반 정책에서 IAM 엔터티에 부여할 수 있는 최대 권한을 설정합니다. 자세한 정보는 *IAM 사용 설명서*의 [IAM 엔터티의 권한 범위](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)를 참조하세요. + **서비스 제어 정책(SCP)** - AWS Organizations내 조직 또는 조직 단위에 대한 최대 권한을 지정합니다. 자세한 내용은AWS Organizations 사용 설명서의 [서비스 제어 정책](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)을 참조하세요.** + **리소스 제어 정책(RCP)** – 계정의 리소스에 사용할 수 있는 최대 권한을 설정합니다. 자세한 내용은 *AWS Organizations 사용 설명서*의 [리소스 제어 정책(RCP)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_rcps.html)을 참조하세요. + **세션 정책** – 역할 또는 페더레이션 사용자에 대해 임시 세션을 프로그래밍 방식으로 생성할 때 파라미터로 전달하는 고급 정책입니다. 자세한 내용은 *IAM 사용 설명서*의 [세션 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session)을 참조하세요. ## 여러 정책 유형 여러 정책 유형이 요청에 적용되는 경우, 결과 권한은 이해하기가 더 복잡합니다. 에서 여러 정책 유형이 관련될 때 요청을 허용할지 여부를 AWS 결정하는 방법을 알아보려면 *IAM 사용 설명서*의 [정책 평가 로직](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html)을 참조하세요. # AWS 에 대한 관리형 정책 AWS IoT SiteWise 정책을 직접 작성하는 대신 AWS 관리형 정책을 사용하여 사용자, 그룹 및 역할에 권한을 추가하는 작업을 간소화합니다. 팀에 정확한 권한을 제공하는 [IAM 고객 관리형 정책을 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)하기 위해서는 시간과 전문 지식이 필요합니다. 더 빠른 설정을 위해 일반적인 사용 사례에 관리 AWS 형 정책을 사용하는 것이 좋습니다. AWS 계정에서 AWS 관리형 정책을 찾습니다. AWS 관리형 정책에 대한 자세한 정보는 [IAM 사용 설명서](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)에서 *AWS 관리형 정책*을 참조하세요. AWS 서비스는 AWS 관리형 정책을 업데이트하고 유지 관리합니다. 즉, 이러한 정책의 권한을 수정할 수 없습니다. 경우에 따라는 새 기능을 수용할 AWS IoT SiteWise 수 있는 권한을 추가하여 정책이 연결된 모든 자격 증명에 영향을 미칠 수 있습니다. 이러한 업데이트는 새로운 서비스 또는 기능을 도입할 때 흔히 발생합니다. 그러나 권한은 제거되지 않으므로 설정이 그대로 유지됩니다. 또한는 여러 서비스에 걸쳐 있는 직무에 대한 관리형 정책을 AWS 지원합니다. 예를 들어 **ReadOnlyAccess** AWS 관리형 정책은 모든 AWS 서비스 및 리소스에 대한 읽기 전용 액세스를 제공합니다. 서비스가 새 기능을 시작하면는 새 작업 및 리소스에 대한 읽기 전용 권한을 AWS 추가합니다. 직무 정책의 목록과 설명은 *IAM 사용 설명서*의 [직무에 관한AWS 관리형 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)을 참조하세요. ## AWS 관리형 정책: AWSIoTSiteWiseReadOnlyAccess `AWSIoTSiteWiseReadOnlyAccess` AWS 관리형 정책을 사용하여에 대한 읽기 전용 액세스를 허용합니다 AWS IoT SiteWise. `AWSIoTSiteWiseReadOnlyAccess` 정책을 IAM ID에 연결할 수 있습니다. **서비스 수준 권한** 이 정책은 읽기 전용 SQL 쿼리를 실행할 수 있는 권한을 포함하여 AWS IoT SiteWise에 대한 읽기 전용 액세스를 제공합니다. 이 정책에 다른 서비스 권한은 포함되지 않습니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:BatchGetAssetPropertyAggregates", "iotsitewise:BatchGetAssetPropertyValue", "iotsitewise:BatchGetAssetPropertyValueHistory", "iotsitewise:DescribeAccessPolicy", "iotsitewise:DescribeAction", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetCompositeModel", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetModelCompositeModel", "iotsitewise:DescribeAssetModelInterfaceRelationship", "iotsitewise:DescribeAssetProperty", "iotsitewise:DescribeBulkImportJob", "iotsitewise:DescribeComputationModel", "iotsitewise:DescribeComputationModelExecutionSummary", "iotsitewise:DescribeDashboard", "iotsitewise:DescribeDataset", "iotsitewise:DescribeDefaultEncryptionConfiguration", "iotsitewise:DescribeExecution", "iotsitewise:DescribeGateway", "iotsitewise:DescribeGatewayCapabilityConfiguration", "iotsitewise:DescribeLoggingOptions", "iotsitewise:DescribePortal", "iotsitewise:DescribeProject", "iotsitewise:DescribeStorageConfiguration", "iotsitewise:DescribeTimeSeries", "iotsitewise:GetAssetPropertyAggregates", "iotsitewise:GetAssetPropertyValue", "iotsitewise:GetAssetPropertyValueHistory", "iotsitewise:GetInterpolatedAssetPropertyValues", "iotsitewise:ListAccessPolicies", "iotsitewise:ListActions", "iotsitewise:ListAssetModelCompositeModels", "iotsitewise:ListAssetModelProperties", "iotsitewise:ListAssetModels", "iotsitewise:ListAssetProperties", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "iotsitewise:ListBulkImportJobs", "iotsitewise:ListCompositionRelationships", "iotsitewise:ListComputationModelDataBindingUsages", "iotsitewise:ListComputationModelResolveToResources", "iotsitewise:ListComputationModels", "iotsitewise:ListDashboards", "iotsitewise:ListDatasets", "iotsitewise:ListExecutions", "iotsitewise:ListGateways", "iotsitewise:ListInterfaceRelationships", "iotsitewise:ListPortals", "iotsitewise:ListProjectAssets", "iotsitewise:ListProjects", "iotsitewise:ListTagsForResource", "iotsitewise:ListTimeSeries" ], "Resource": "*" } ] } ``` ------ ## AWS 관리형 정책: AWSServiceRoleForIoTSiteWise `AWSServiceRoleForIoTSiteWise` 역할은 다음 권한을 가진 `AWSServiceRoleForIoTSiteWise` 정책을 사용합니다. 이 정책은 다음과 같습니다. + AWS IoT SiteWise 가 SiteWise Edge 게이트웨이(에서 실행됨)를 배포할 수 있도록 허용합니다`AWS IoT Greengrass`. + 가 로깅 AWS IoT SiteWise 을 수행하도록 허용합니다. + 가 AWS IoT TwinMaker 데이터베이스에 대해 메타데이터 검색 쿼리를 실행 AWS IoT SiteWise 하도록 허용합니다. 단일 사용자 계정과 AWS IoT SiteWise 함께를 사용하는 경우 `AWSServiceRoleForIoTSiteWise` 역할은 IAM 계정에 `AWSServiceRoleForIoTSiteWise` 정책을 생성하고의 `AWSServiceRoleForIoTSiteWise` 서비스 연결 역할에 연결합니다. [AWS IoT SiteWise](using-service-linked-roles.md) ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowSiteWiseReadGreenGrass", "Effect": "Allow", "Action": [ "greengrass:GetAssociatedRole", "greengrass:GetCoreDefinition", "greengrass:GetCoreDefinitionVersion", "greengrass:GetGroup", "greengrass:GetGroupVersion" ], "Resource": "*" }, { "Sid": "AllowSiteWiseAccessLogGroup", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/iotsitewise*" }, { "Sid": "AllowSiteWiseAccessLog", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*" }, { "Sid": "AllowSiteWiseAccessSiteWiseManagedWorkspaceInTwinMaker", "Effect": "Allow", "Action": [ "iottwinmaker:GetWorkspace", "iottwinmaker:ExecuteQuery" ], "Resource": "arn:aws:iottwinmaker:*:*:workspace/*", "Condition": { "ForAnyValue:StringEquals": { "iottwinmaker:linkedServices": [ "IOTSITEWISE" ] } } } ] } ``` ------ ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowSiteWiseReadGreenGrass", "Effect": "Allow", "Action": [ "greengrass:GetAssociatedRole", "greengrass:GetCoreDefinition", "greengrass:GetCoreDefinitionVersion", "greengrass:GetGroup", "greengrass:GetGroupVersion" ], "Resource": "*" }, { "Sid": "AllowSiteWiseAccessLogGroup", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": "arn:aws-us-gov:logs:*:*:log-group:/aws/iotsitewise*" }, { "Sid": "AllowSiteWiseAccessLog", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": "arn:aws-us-gov:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*" }, { "Sid": "AllowSiteWiseAccessSiteWiseManagedWorkspaceInTwinMaker", "Effect": "Allow", "Action": [ "iottwinmaker:GetWorkspace", "iottwinmaker:ExecuteQuery" ], "Resource": "arn:aws-us-gov:iottwinmaker:*:*:workspace/*", "Condition": { "ForAnyValue:StringEquals": { "iottwinmaker:linkedServices": [ "IOTSITEWISE" ] } } } ] } ``` ------ ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowSiteWiseReadGreenGrass", "Effect": "Allow", "Action": [ "greengrass:GetAssociatedRole", "greengrass:GetCoreDefinition", "greengrass:GetCoreDefinitionVersion", "greengrass:GetGroup", "greengrass:GetGroupVersion" ], "Resource": "*" }, { "Sid": "AllowSiteWiseAccessLogGroup", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*" }, { "Sid": "AllowSiteWiseAccessLog", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*" }, { "Sid": "AllowSiteWiseAccessSiteWiseManagedWorkspaceInTwinMaker", "Effect": "Allow", "Action": [ "iottwinmaker:GetWorkspace", "iottwinmaker:ExecuteQuery" ], "Resource": "arn:aws-cn:iottwinmaker:*:*:workspace/*", "Condition": { "ForAnyValue:StringEquals": { "iottwinmaker:linkedServices": [ "IOTSITEWISE" ] } } } ] } ``` ------ ## AWS IoT SiteWise AWS 관리형 정책에 대한 업데이트 이 서비스가 변경 사항을 추적하기 시작한 AWS IoT SiteWise시점부터의 AWS 관리형 정책 업데이트에 대한 세부 정보를 볼 수 있습니다. 이 페이지의 변경 사항에 대한 자동 알림을 받으려면 AWS IoT SiteWise 문서 기록 페이지에서 RSS 피드를 구독하세요. | 변경 | 설명 | Date | | --- | --- | --- | | [AWSServiceRoleForIoTSiteWise](#security-iam-awsmanpol-AWSServiceRoleForIoTSiteWise) - 기존 정책 업데이트 | AWS IoT SiteWise 이제가 데이터베이스에 대해 메타데이터 검색 쿼리를 AWS IoT TwinMaker 실행할 수 있습니다. | 2023년 11월 6일 | | [AWSIoTSiteWiseReadOnlyAccess](#security-iam-awsmanpol-AWSIoTSiteWiseReadOnlyAccess) - 기존 정책 업데이트 | AWS IoT SiteWise 는 배치 읽기 작업을 수행할 수 `BatchGet*`있는 새 정책 접두사를 추가했습니다. | 2022년 9월 16일 | | [AWSIoTSiteWiseReadOnlyAccess](#security-iam-awsmanpol-AWSIoTSiteWiseReadOnlyAccess) – 새 정책 | AWS IoT SiteWise 는에 대한 읽기 전용 액세스 권한을 부여하는 새 정책을 추가했습니다 AWS IoT SiteWise. | 2021년 11월 24일 | | AWS IoT SiteWise 에서 변경 내용 추적 시작 | AWS IoT SiteWise 가 AWS 관리형 정책에 대한 변경 내용 추적을 시작했습니다. | 2021년 11월 24일 | # 에 대한 서비스 연결 역할 사용 AWS IoT SiteWise AWS IoT SiteWise 는 AWS Identity and Access Management (IAM)[ 서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create-service-linked-role.html) 사용합니다. 서비스 연결 역할은 직접 연결된 고유한 유형의 IAM 역할입니다 AWS IoT SiteWise. 서비스 연결 역할은에서 사전 정의 AWS IoT SiteWise 하며 서비스가 사용자를 대신하여 다른 AWS 서비스를 호출하는 데 필요한 모든 권한을 포함합니다. 서비스 연결 역할은 필요한 모든 권한을 AWS IoT SiteWise 자동으로 포함하여 구성을 간소화합니다.는 서비스 연결 역할의 권한을 AWS IoT SiteWise 정의하며, 달리 정의되지 않은 한 만 해당 역할을 수임 AWS IoT SiteWise 할 수 있습니다. 정의된 권한에는 신뢰 정책과 권한 정책이 포함됩니다. 또한 해당 권한 정책은 다른 어떤 IAM 엔터티에도 연결할 수 없습니다. 먼저 관련 리소스를 삭제한 후에만 서비스 연결 역할을 삭제할 수 있습니다. 이렇게 하면 AWS IoT SiteWise 리소스에 대한 액세스 권한을 실수로 제거할 수 없기 때문에 리소스가 보호됩니다. 서비스 연결 역할을 지원하는 다른 서비스에 대한 자세한 내용은 [AWS IAM으로 작업하는 서비스를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하고 **서비스 연결 역할** 열에서 **예**인 서비스를 찾습니다. 해당 서비스에 대한 서비스 연결 역할 설명서를 보려면 **예(Yes)** 링크를 선택합니다. **Topics** + [서비스 연결 역할 권한](service-linked-role-permissions.md) + [서비스 연결 역할 생성](create-service-linked-role.md) + [서비스 연결 역할 업데이트](edit-service-linked-role.md) + [서비스 연결 역할 삭제](delete-service-linked-role.md) + [지원되는 리전](#slr-regions) + [SiteWise Monitor의 서비스 역할 사용](monitor-service-role.md) # 에 대한 서비스 연결 역할 권한 AWS IoT SiteWise AWS IoT SiteWise 는 **AWSServiceRoleForIoTSiteWise**라는 서비스 연결 역할을 사용합니다. AWS IoT SiteWise 는이 서비스 연결 역할을 사용하여 SiteWise Edge 게이트웨이(에서 실행됨 AWS IoT Greengrass)를 배포하고 로깅을 수행합니다. `AWSServiceRoleForIoTSiteWise` 서비스 연결 역할은 다음 권한이 있는 `AWSServiceRoleForIoTSiteWise` 정책을 사용합니다. 이 정책은 다음과 같습니다. + AWS IoT SiteWise 가 SiteWise Edge 게이트웨이(에서 실행됨)를 배포할 수 있도록 허용합니다`AWS IoT Greengrass`. + 가 로깅 AWS IoT SiteWise 을 수행하도록 허용합니다. + 가 AWS IoT TwinMaker 데이터베이스에 대해 메타데이터 검색 쿼리를 실행 AWS IoT SiteWise 하도록 허용합니다. `AWSServiceRoleForIoTSiteWise`에서 허용된 작업에 대한 자세한 내용은 [AWS IoT SiteWise에 대한AWS 관리형 정책](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSServiceRoleForIoTSiteWise)을 참조하세요. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowSiteWiseReadGreenGrass", "Effect": "Allow", "Action": [ "greengrass:GetAssociatedRole", "greengrass:GetCoreDefinition", "greengrass:GetCoreDefinitionVersion", "greengrass:GetGroup", "greengrass:GetGroupVersion" ], "Resource": "*" }, { "Sid": "AllowSiteWiseAccessLogGroup", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/iotsitewise*" }, { "Sid": "AllowSiteWiseAccessLog", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*" }, { "Sid": "AllowSiteWiseAccessSiteWiseManagedWorkspaceInTwinMaker", "Effect": "Allow", "Action": [ "iottwinmaker:GetWorkspace", "iottwinmaker:ExecuteQuery" ], "Resource": "arn:aws:iottwinmaker:*:*:workspace/*", "Condition": { "ForAnyValue:StringEquals": { "iottwinmaker:linkedServices": [ "IOTSITEWISE" ] } } } ] } ``` ------ ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowSiteWiseReadGreenGrass", "Effect": "Allow", "Action": [ "greengrass:GetAssociatedRole", "greengrass:GetCoreDefinition", "greengrass:GetCoreDefinitionVersion", "greengrass:GetGroup", "greengrass:GetGroupVersion" ], "Resource": "*" }, { "Sid": "AllowSiteWiseAccessLogGroup", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": "arn:aws-us-gov:logs:*:*:log-group:/aws/iotsitewise*" }, { "Sid": "AllowSiteWiseAccessLog", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": "arn:aws-us-gov:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*" }, { "Sid": "AllowSiteWiseAccessSiteWiseManagedWorkspaceInTwinMaker", "Effect": "Allow", "Action": [ "iottwinmaker:GetWorkspace", "iottwinmaker:ExecuteQuery" ], "Resource": "arn:aws-us-gov:iottwinmaker:*:*:workspace/*", "Condition": { "ForAnyValue:StringEquals": { "iottwinmaker:linkedServices": [ "IOTSITEWISE" ] } } } ] } ``` ------ ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowSiteWiseReadGreenGrass", "Effect": "Allow", "Action": [ "greengrass:GetAssociatedRole", "greengrass:GetCoreDefinition", "greengrass:GetCoreDefinitionVersion", "greengrass:GetGroup", "greengrass:GetGroupVersion" ], "Resource": "*" }, { "Sid": "AllowSiteWiseAccessLogGroup", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*" }, { "Sid": "AllowSiteWiseAccessLog", "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": "arn:aws-cn:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*" }, { "Sid": "AllowSiteWiseAccessSiteWiseManagedWorkspaceInTwinMaker", "Effect": "Allow", "Action": [ "iottwinmaker:GetWorkspace", "iottwinmaker:ExecuteQuery" ], "Resource": "arn:aws-cn:iottwinmaker:*:*:workspace/*", "Condition": { "ForAnyValue:StringEquals": { "iottwinmaker:linkedServices": [ "IOTSITEWISE" ] } } } ] } ``` ------ 로그를 사용하여 SiteWise Edge 게이트웨이를 모니터링하고 문제를 해결할 수 있습니다. 자세한 내용은 [SiteWise Edge 게이트웨이 로그 모니터링](monitor-gateway-logs.md) 단원을 참조하십시오. IAM 엔티티(예: 사용자, 그룹 또는 역할)가 서비스 연결 역할을 생성, 편집 또는 삭제할 수 있도록 하려면 먼저 권한을 구성합니다. 자세한 내용은 *IAM 사용 설명서*의 [서비스 연결 역할 권한](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create-service-linked-role.html#service-linked-role-permissions)을 참조하세요. # 에 대한 서비스 연결 역할 생성 AWS IoT SiteWise AWS IoT SiteWise 에서는 특정 작업을 수행하고 사용자를 대신하여 리소스에 액세스하려면 서비스 연결 역할이 필요합니다. 서비스 연결 역할은 직접 연결된 고유한 유형의 AWS Identity and Access Management(IAM) 역할입니다 AWS IoT SiteWise. 이 역할을 생성하면 데이터 스토리지 또는 디바이스 통신용 Amazon S3와 같이 작업에 필요한 다른 AWS 서비스 및 리소스에 액세스하는 AWS IoT 데 AWS IoT SiteWise 필요한 권한을 부여합니다. 서비스 연결 역할은 수동으로 생성할 필요가 없습니다. AWS IoT SiteWise 콘솔에서 다음 작업을 수행하면가 서비스 연결 역할을 AWS IoT SiteWise 생성합니다. + Greengrass V1 게이트웨이를 생성합니다. + 로깅 옵션을 구성합니다. + 쿼리 실행 배너에서 옵트인 버튼을 선택합니다. 이 서비스 연결 역할을 삭제했다가 다시 생성해야 하는 경우 동일한 프로세스를 사용하여 계정에서 역할을 다시 생성할 수 있습니다. AWS IoT SiteWise 콘솔에서 작업을 수행하면가 서비스 연결 역할을 다시 AWS IoT SiteWise 생성합니다. 또한 IAM 콘솔 또는 API를 사용하여 AWS IoT SiteWise를 위한 서비스 연결 역할을 만들 수도 있습니다. + IAM 콘솔에서 이 작업을 수행하려면 **AWSServiceRoleForIoTSiteWise** 정책 및 `iotsitewise.amazonaws.com`와의 신뢰 관계를 사용하여 역할을 생성하세요. + AWS CLI 또는 IAM API를 사용하여 이렇게 하려면 `arn:aws:iam::aws:policy/aws-service-role/AWSServiceRoleForIoTSiteWise` 정책 및 와의 신뢰 관계를 사용하여 역할을 생성합니다`iotsitewise.amazonaws.com`. 자세한 내용은 IAM 사용 설명서**의 [서비스 연결 역할 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create-service-linked-role.html#create-service-linked-role)을 참조하세요. 이 서비스 연결 역할을 삭제하면 동일한 프로세스를 사용하여 역할을 다시 생성할 수 있습니다. # 에 대한 서비스 연결 역할 업데이트 AWS IoT SiteWise AWS IoT SiteWise 에서는 AWSServiceRoleForIoTSiteWise 서비스 연결 역할을 편집할 수 없습니다. 서비스 연결 역할을 생성한 후에는 다양한 엔터티가 역할을 참조할 수 있기 때문에 역할 이름을 변경할 수 없습니다. 하지만 IAM을 사용하여 역할의 설명을 편집할 수 있습니다. 자세한 내용은 IAM 사용 설명서**의 [서비스 연결 역할 업데이트](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-service-linked-role.html)를 참조하세요. # 에 대한 서비스 연결 역할 삭제 AWS IoT SiteWise 서비스 연결 역할이 필요한 기능 또는 서비스를 더 이상 사용하지 않는 경우 연결된 역할을 삭제하는 것이 좋습니다. 이는 모니터링되거나 유지 관리되지 않는 비활성 엔터티가 발생하지 않도록 하기 위한 것입니다. 단, 서비스 연결 역할에 대한 리소스를 먼저 정리해야 수동으로 삭제할 수 있습니다. **참고** 리소스를 삭제하려고 할 때 AWS IoT SiteWise 서비스가 역할을 사용하는 경우 삭제에 실패할 수 있습니다. 그 경우 몇 분 동안 기다렸다가 다시 시도하세요. **AWSServiceRoleForIoTSiteWise에서 사용하는 AWS IoT SiteWise 리소스를 삭제하려면** 1. 에 대한 로깅을 비활성화합니다 AWS IoT SiteWise. 자세한 내용은 [로깅 수준 변경](monitor-cloudwatch-logs.md#change-logging-level) 섹션을 참조하세요. 1. 활성 SiteWise Edge 게이트웨이를 삭제합니다. **IAM을 사용하여 수동으로 서비스 연결 역할을 삭제하려면 다음을 수행하세요.** IAM 콘솔 AWS CLI, 또는 AWS API를 사용하여 AWSServiceRoleForIoTSiteWise 서비스 연결 역할을 삭제합니다. 자세한 내용은 IAM 사용 설명서**의 [역할 또는 인스턴스 프로파일 삭제](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create-service-linked-role.html#delete-service-linked-role)를 참조하세요. ## AWS IoT SiteWise 서비스 연결 역할에 지원되는 리전 AWS IoT SiteWise 는 서비스를 사용할 수 있는 모든 리전에서 서비스 연결 역할 사용을 지원합니다. 자세한 내용은 [AWS IoT SiteWise 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)을 참조하세요. # 에 대한 서비스 역할 사용 AWS IoT SiteWise Monitor 서비스 역할은 서비스가 사용자를 대신하여 작업을 수행하는 것으로 가정하는 [IAM 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)입니다. IAM 관리자는 IAM 내에서 서비스 역할을 생성, 수정 및 삭제할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [AWS 서비스 AWS에 권한을 위임할 역할 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)을 참조하세요. 페더레이션 SiteWise Monitor 포털 사용자가 AWS IoT SiteWise 및 AWS IAM Identity Center 리소스에 액세스할 수 있도록 하려면 생성한 각 포털에 서비스 역할을 연결해야 합니다. 이 서비스 역할은 SiteWise Monitor를 신뢰할 수 있는 엔터티로 지정하고 [AWSIoTSiteWiseMonitorPortalAccess](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AWSIoTSiteWiseMonitorPortalAccess) 관리형 정책을 포함하거나 [동등한 권한](#monitor-service-role-permissions)을 정의해야 합니다. 이 정책은에서 유지 AWS 관리하며 SiteWise Monitor가 및 IAM Identity Center 리소스에 액세스하는 AWS IoT SiteWise 데 사용하는 권한 세트를 정의합니다. SiteWise Monitor 포털을 생성할 때 해당 포털의 사용자가 사용자의 AWS IoT SiteWise 및 IAM Identity Center 리소스에 액세스할 수 있도록 허용하는 역할을 선택해야 합니다. AWS IoT SiteWise 콘솔에서 역할을 생성하고 구성할 수 있습니다. 나중에 IAM에서 역할을 편집할 수 있습니다. 이 역할에서 필요한 권한을 제거하거나 역할을 삭제하면 포털 사용자가 SiteWise Monitor 포털을 사용하는 데 문제가 발생합니다. **참고** 2020년 4월 29일 이전에 생성된 포털에는 서비스 역할이 필요 없었습니다. 이 날짜 이전에 포털을 만든 경우, 계속 사용하려면 서비스 역할을 연결해야 합니다. 이렇게 하려면 [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)의 **포털** 페이지로 이동한 다음 **IAM 역할을 사용하도록 모든 포털 마이그레이션**을 선택합니다. 다음 섹션에서는 AWS Management Console 또는 AWS Command Line Interface에서 SiteWise Monitor 서비스 역할을 생성 및 관리하는 방법에 대해 설명합니다. **Contents** + [ ## SiteWise Monitor에 대한 서비스 역할 권한(클래식) ](#monitor-service-role-permissions) + [ ## SiteWise Monitor(AI 인식)에 대한 서비스 역할 권한 ](#monitor-ai-service-role-permissions) + [ ## SiteWise Monitor 서비스 역할 관리(콘솔) ](#manage-portal-role-console) + [ ### 포털의 서비스 역할 찾기(콘솔) ](#find-portal-role-console) + [ ### SiteWise Monitor 서비스 역할 생성(AWS IoT SiteWise 콘솔) ](#create-portal-role-sitewise-console) + [ ### SiteWise Monitor 서비스 역할 생성(IAM 콘솔) ](#create-portal-role-iam-console) + [ ### 포털의 서비스 역할 변경(콘솔) ](#change-portal-role-console) + [ ## SiteWise Monitor 서비스 역할 관리(CLI) ](#manage-portal-role-cli) + [ ### 포털의 서비스 역할 찾기(CLI) ](#find-portal-role-cli) + [ ### SiteWise Monitor 서비스 역할 생성(CLI) ](#create-portal-role-cli) + [ ## SiteWiseMonitor에서 AWSIotSiteWiseMonitorServiceRole로 업데이트 ](#monitor-role-permission-updates) ## SiteWise Monitor에 대한 서비스 역할 권한(클래식) 포털을 생성할 때 이름이 **AWSIoTSiteWiseMonitorServiceRole**로 시작하는 역할을 생성할 수 AWS IoT SiteWise 있습니다. 페더레이션 SiteWise Monitor 사용자는 이 역할을 사용하여 포털 구성, 자산, 자산 데이터, IAM Identity Center 구성에 액세스할 수 있습니다. 이 역할은 역할을 맡기 위해 다음 서비스를 신뢰합니다. + `monitor.iotsitewise.amazonaws.com` 역할은 **AWSIoTSiteWiseMonitorServicePortalPolicy**로 시작하는 다음 권한 정책을 사용하여 SiteWise Monitor 사용자가 계정의 리소스에 대한 작업을 완료할 수 있도록 허용합니다. [AWSIoTSiteWiseMonitorPortalAccess](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AWSIoTSiteWiseMonitorPortalAccess) 관리형 정책은 이와 동등한 권한을 정의해야 합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal", "iotsitewise:CreateProject", "iotsitewise:DescribeProject", "iotsitewise:UpdateProject", "iotsitewise:DeleteProject", "iotsitewise:ListProjects", "iotsitewise:BatchAssociateProjectAssets", "iotsitewise:BatchDisassociateProjectAssets", "iotsitewise:ListProjectAssets", "iotsitewise:CreateDashboard", "iotsitewise:DescribeDashboard", "iotsitewise:UpdateDashboard", "iotsitewise:DeleteDashboard", "iotsitewise:ListDashboards", "iotsitewise:CreateAccessPolicy", "iotsitewise:DescribeAccessPolicy", "iotsitewise:UpdateAccessPolicy", "iotsitewise:DeleteAccessPolicy", "iotsitewise:ListAccessPolicies", "iotsitewise:DescribeAsset", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:GetAssetPropertyValueHistory", "iotsitewise:GetAssetPropertyAggregates", "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:DescribeAssetModel", "iotsitewise:ListAssetModels", "iotsitewise:UpdateAssetModel", "iotsitewise:UpdateAssetModelPropertyRouting", "sso-directory:DescribeUsers", "sso-directory:DescribeUser", "iotevents:DescribeAlarmModel", "iotevents:ListTagsForResource" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "iotevents:BatchAcknowledgeAlarm", "iotevents:BatchSnoozeAlarm", "iotevents:BatchEnableAlarm", "iotevents:BatchDisableAlarm" ], "Resource": "*", "Condition": { "Null": { "iotevents:keyValue": "false" } } }, { "Effect": "Allow", "Action": [ "iotevents:CreateAlarmModel", "iotevents:TagResource" ], "Resource": "*", "Condition": { "Null": { "aws:RequestTag/iotsitewisemonitor": "false" } } }, { "Effect": "Allow", "Action": [ "iotevents:UpdateAlarmModel", "iotevents:DeleteAlarmModel" ], "Resource": "*", "Condition": { "Null": { "aws:ResourceTag/iotsitewisemonitor": "false" } } }, { "Effect": "Allow", "Action": [ "iam:PassRole" ], "Resource": "*", "Condition": { "StringEquals": { "iam:PassedToService": [ "iotevents.amazonaws.com" ] } } } ] } ``` ------ ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:CreateProject", "iotsitewise:DescribeProject", "iotsitewise:UpdateProject", "iotsitewise:DeleteProject", "iotsitewise:ListProjects", "iotsitewise:BatchAssociateProjectAssets", "iotsitewise:BatchDisassociateProjectAssets", "iotsitewise:ListProjectAssets", "iotsitewise:CreateDashboard", "iotsitewise:DescribeDashboard", "iotsitewise:UpdateDashboard", "iotsitewise:DeleteDashboard", "iotsitewise:ListDashboards", "iotsitewise:CreateAccessPolicy", "iotsitewise:DescribeAccessPolicy", "iotsitewise:UpdateAccessPolicy", "iotsitewise:DeleteAccessPolicy", "iotsitewise:ListAccessPolicies", "iotsitewise:DescribeAsset", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:GetAssetPropertyValueHistory", "iotsitewise:GetAssetPropertyAggregates" ], "Resource": "*" } ] } ``` ------ 경보에 필요한 사용 권한에 대한 자세한 내용은 [에서 이벤트 경보에 대한 권한 설정 AWS IoT SiteWise](alarms-iam-permissions.md)을 참조하세요. 포털 사용자가 로그인하면 SiteWise Monitor에서는 서비스 역할과 해당 사용자의 액세스 정책의 공통점을 기반으로 [세션 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session)을 생성합니다. 액세스 정책은 포털 및 프로젝트에 대한 ID의 액세스 수준을 정의합니다. 포털 권한 및 액세스 정책에 대한 자세한 내용은 [SiteWise Monitor 포털 관리](administer-portals.md) 및 [CreateAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAccessPolicy.html)를 참조하세요. ## SiteWise Monitor(AI 인식)에 대한 서비스 역할 권한 포털을 생성할 때 이름이 **IoTSiteWisePortalRole**로 시작하는 역할을 생성할 수 AWS IoT SiteWise 있습니다. 페더레이션 SiteWise Monitor 사용자는 이 역할을 사용하여 포털 구성, 자산, 자산 데이터, IAM Identity Center 구성에 액세스할 수 있습니다. **주의** SiteWise Monitor(AI 인식)에서는 **프로젝트 소유자** 및 **프로젝트 뷰어** 역할이 지원되지 않습니다. 이 역할은 역할을 맡기 위해 다음 서비스를 신뢰합니다. + `monitor.iotsitewise.amazonaws.com` 역할은 **IoTSiteWiseAIPortalAccessPolicy**로 시작하는 다음 권한 정책을 사용하여 SiteWise Monitor 사용자가 계정의 리소스에 대한 작업을 완료할 수 있도록 허용합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:CreateProject", "iotsitewise:DescribePortal", "iotsitewise:ListProjects", "iotsitewise:DescribeProject", "iotsitewise:UpdateProject", "iotsitewise:DeleteProject", "iotsitewise:CreateDashboard", "iotsitewise:DescribeDashboard", "iotsitewise:UpdateDashboard", "iotsitewise:DeleteDashboard", "iotsitewise:ListDashboards", "iotsitewise:ListAssets", "iotsitewise:DescribeAsset", "iotsitewise:ListAssociatedAssets", "iotsitewise:ListAssetProperties", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:GetAssetPropertyValueHistory", "iotsitewise:GetAssetPropertyAggregates", "iotsitewise:GetInterpolatedAssetPropertyValues", "iotsitewise:BatchGetAssetPropertyAggregates", "iotsitewise:BatchGetAssetPropertyValue", "iotsitewise:BatchGetAssetPropertyValueHistory", "iotsitewise:ListAssetRelationships", "iotsitewise:DescribeAssetModel", "iotsitewise:ListAssetModels", "iotsitewise:DescribeAssetCompositeModel", "iotsitewise:DescribeAssetModelCompositeModel", "iotsitewise:ListAssetModelProperties", "iotsitewise:ExecuteQuery", "iotsitewise:ListTimeSeries", "iotsitewise:DescribeTimeSeries", "iotsitewise:InvokeAssistant", "iotsitewise:DescribeDataset", "iotsitewise:ListDatasets", "iotevents:DescribeAlarmModel", "iotevents:ListTagsForResource", "iottwinmaker:ListWorkspaces", "iottwinmaker:ExecuteQuery", "iottwinmaker:GetWorkspace", "identitystore:DescribeUser" ], "Resource": "*" } ] } ``` ------ 포털 사용자가 로그인하면 SiteWise Monitor에서는 서비스 역할과 해당 사용자의 액세스 정책의 공통점을 기반으로 [세션 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session)을 생성합니다. ## SiteWise Monitor 서비스 역할 관리(콘솔) 를 사용하면 포털에 대한 SiteWise Monitor 서비스 역할을 AWS IoT SiteWise Console 쉽게 관리할 수 있습니다. 포털을 생성하면 콘솔은 연결에 적합한 기존 역할을 확인합니다. 사용 가능한 역할이 없으면 콘솔이 사용자를 대신하여 서비스 역할을 생성 및 구성할 수 있습니다. 자세한 내용은 [SiteWise Monitor에서 포털 생성](monitor-create-portal.md) 단원을 참조하십시오. **Topics** + [ ### 포털의 서비스 역할 찾기(콘솔) ](#find-portal-role-console) + [ ### SiteWise Monitor 서비스 역할 생성(AWS IoT SiteWise 콘솔) ](#create-portal-role-sitewise-console) + [ ### SiteWise Monitor 서비스 역할 생성(IAM 콘솔) ](#create-portal-role-iam-console) + [ ### 포털의 서비스 역할 변경(콘솔) ](#change-portal-role-console) ### 포털의 서비스 역할 찾기(콘솔) 다음 단계에 따라 SiteWise Monitor 포털에 연결된 서비스 역할을 찾을 수 있습니다. **포털의 서비스 역할을 찾으려면** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 왼쪽 탐색 창에서 **포털**을 선택합니다. 1. 서비스 역할을 찾으려는 포털을 선택합니다. 포털에 연결된 역할이 **권한**, **서비스 역할** 아래에 나타납니다. ### SiteWise Monitor 서비스 역할 생성(AWS IoT SiteWise 콘솔) SiteWise Monitor 포털을 만들 때 포털에 대한 새 서비스 역할을 만들 수 있습니다. 자세한 내용은 [SiteWise Monitor에서 포털 생성](monitor-create-portal.md) 단원을 참조하십시오. AWS IoT SiteWise 콘솔에서 기존 포털에 대한 서비스 역할을 생성할 수도 있습니다. 이는 포털의 기존 서비스 역할을 대체합니다. **기존 포털에 대한 서비스 역할을 만들려면** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 창에서 **포털**을 선택합니다. 1. 새 서비스 역할을 만들려는 포털을 선택합니다. 1. **포털 세부 정보**에서 **편집**을 선택합니다. 1. **권한** 아래에서 **새 서비스 역할 생성 및 사용**을 선택합니다. 1. 새 역할의 이름을 입력합니다. 1. **저장**을 선택합니다. ### SiteWise Monitor 서비스 역할 생성(IAM 콘솔) IAM 콘솔의 서비스 역할 템플릿에서 서비스 역할을 생성할 수 있습니다. 이 역할 템플릿에는 [AWSIoTSiteWiseMonitorPortalAccess](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AWSIoTSiteWiseMonitorPortalAccess) 관리형 정책이 포함되어 있으며 SiteWise Monitor를 신뢰할 수 있는 엔티티로 지정합니다. **포털 서비스 역할 템플릿에서 서비스 역할을 만들려면** 1. [IAM 콘솔](https://console.aws.amazon.com/iam/)로 이동합니다. 1. 탐색 창에서 **Roles**를 선택합니다. 1. **역할 생성(Create role)**을 선택합니다. 1. **사용 사례 선택**에서 **IoT SiteWise**를 선택합니다. 1. **사용 사례 선택**에서 **IoT SiteWise Monitor - Portal**를 선택합니다. 1. **다음: 권한**을 선택합니다. 1. **다음: 태그**를 선택합니다. 1. **다음: 검토**를 선택합니다. 1. **역할 이름**에 새 서비스 역할의 이름을 입력합니다. 1. **역할 생성**을 선택합니다. ### 포털의 서비스 역할 변경(콘솔) 다음 절차에 따라 포털에 대해 다른 SiteWise Monitor 서비스 역할을 선택할 수 있습니다. **포털의 서비스 역할을 변경하려면 다음을 수행하세요.** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 창에서 **포털**을 선택합니다. 1. 서비스 역할을 변경할 포털을 선택합니다. 1. **포털 세부 정보**에서 **편집**을 선택합니다. 1. **권한**에서 **기존 역할 사용**을 선택합니다. 1. 이 포털에 연결할 기존 역할을 선택합니다. 1. **저장**을 선택합니다. ## SiteWise Monitor 서비스 역할 관리(CLI) 다음 포털 서비스 역할 관리 작업에 AWS CLI 를 사용할 수 있습니다. **Topics** + [ ### 포털의 서비스 역할 찾기(CLI) ](#find-portal-role-cli) + [ ### SiteWise Monitor 서비스 역할 생성(CLI) ](#create-portal-role-cli) ### 포털의 서비스 역할 찾기(CLI) SiteWise Monitor 포털에 연결된 서비스 역할을 찾으려면 다음 명령을 실행하여 현재 리전의 모든 포털을 나열합니다. ``` aws iotsitewise list-portals ``` 이 작업은 포털 요약 정보가 포함된 응답을 다음 형식으로 반환합니다. ``` { "portalSummaries": [ { "id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "name": "WindFarmPortal", "description": "A portal that contains wind farm projects for Example Corp.", "roleArn": "arn:aws:iam::123456789012:role/service-role/role-name", "startUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws", "creationDate": "2020-02-04T23:01:52.90248068Z", "lastUpdateDate": "2020-02-04T23:01:52.90248078Z" } ] } ``` 포털의 ID를 알고 있는 경우, [DescribePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribePortal.html) 작업을 사용하여 포털의 역할을 찾을 수도 있습니다. ### SiteWise Monitor 서비스 역할 생성(CLI) 다음 단계에 따라 새 SiteWise Monitor 서비스 역할을 만들 수 있습니다. **SiteWise Monitor 서비스 역할을 만들려면** 1. 이 역할을 수임하도록 허용하는 SiteWise Monitor 신뢰 정책으로 역할을 생성합니다. 이 예제에서는 JSON 문자열에 저장된 신뢰 정책으로 **MySiteWiseMonitorPortalRole**이라는 역할을 만듭니다. ------ #### [ Linux, macOS, or Unix ] ``` aws iam create-role --role-name MySiteWiseMonitorPortalRole --assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "monitor.iotsitewise.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }' ``` ------ #### [ Windows command prompt ] ``` aws iam create-role --role-name MySiteWiseMonitorPortalRole --assume-role-policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"monitor.iotsitewise.amazonaws.com\"},\"Action\":\"sts:AssumeRole\"}]}" ``` ------ 1. 출력의 역할 메타데이터에서 역할 ARN을 복사합니다. 포털을 생성할 때 이 ARN을 사용하여 역할을 포털에 연결합니다. 포털 생성에 대한 자세한 내용은 *AWS IoT SiteWise API 참조*의 [CreatePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreatePortal.html)을 참조하세요. 1. 1. SiteWise Monitor(Classic)의 경우 - `AWSIoTSiteWiseMonitorPortalAccess` 정책을 역할에 연결하거나 동등한 권한을 정의하는 정책을 연결합니다. ``` aws iam attach-role-policy --role-name MySiteWiseMonitorPortalRole --policy-arn arn:aws:iam::aws:policy/service-role/AWSIoTSiteWiseMonitorPortalAccess ``` 1. SiteWise Monitor(AI 인식)의 경우 - `IoTSiteWiseAIPortalAccessPolicy` 정책을 역할에 연결하거나 동등한 권한을 정의하는 정책을 연결합니다. 예를 들어 포털 액세스 권한이 있는 정책을 생성합니다. 다음 예제에서는 라는 정책을 생성합니다`MySiteWiseMonitorPortalAccess`. ``` aws iam create-policy \ --policy-name MySiteWiseMonitorPortalAccess \ --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:CreateProject", "iotsitewise:DescribePortal", "iotsitewise:ListProjects", "iotsitewise:DescribeProject", "iotsitewise:UpdateProject", "iotsitewise:DeleteProject", "iotsitewise:CreateDashboard", "iotsitewise:DescribeDashboard", "iotsitewise:UpdateDashboard", "iotsitewise:DeleteDashboard", "iotsitewise:ListDashboards", "iotsitewise:ListAssets", "iotsitewise:DescribeAsset", "iotsitewise:ListAssociatedAssets", "iotsitewise:ListAssetProperties", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:GetAssetPropertyValueHistory", "iotsitewise:GetAssetPropertyAggregates", "iotsitewise:GetInterpolatedAssetPropertyValues", "iotsitewise:BatchGetAssetPropertyAggregates", "iotsitewise:BatchGetAssetPropertyValue", "iotsitewise:BatchGetAssetPropertyValueHistory", "iotsitewise:ListAssetRelationships", "iotsitewise:DescribeAssetModel", "iotsitewise:ListAssetModels", "iotsitewise:DescribeAssetCompositeModel", "iotsitewise:DescribeAssetModelCompositeModel", "iotsitewise:ListAssetModelProperties", "iotsitewise:ExecuteQuery", "iotsitewise:ListTimeSeries", "iotsitewise:DescribeTimeSeries", "iotsitewise:InvokeAssistant", "iotsitewise:DescribeDataset", "iotsitewise:ListDatasets", "iotevents:DescribeAlarmModel", "iotevents:ListTagsForResource", "iottwinmaker:ListWorkspaces", "iottwinmaker:ExecuteQuery", "iottwinmaker:GetWorkspace", "identitystore:DescribeUser" ], "Resource": "*" } ] }' ``` **서비스 역할을 기존 포털에 연결하려면 다음을 수행하세요.** 1. 포털의 기존 세부 정보를 검색하려면 다음 명령을 실행합니다. *portal-id*를 해당 포털의 ID로 바꿉니다. ``` aws iotsitewise describe-portal --portal-id portal-id ``` 이 작업은 포털의 세부 정보가 포함된 응답을 다음 형식으로 반환합니다. ``` { "portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "portalArn": "arn:aws:iotsitewise:region:account-id:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "portalName": "WindFarmPortal", "portalDescription": "A portal that contains wind farm projects for Example Corp.", "portalClientId": "E-1a2b3c4d5e6f_sn6tbqHVzLWVEXAMPLE", "portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws", "portalContactEmail": "support@example.com", "portalStatus": { "state": "ACTIVE" }, "portalCreationDate": "2020-04-29T23:01:52.90248068Z", "portalLastUpdateDate": "2020-04-29T00:28:26.103548287Z", "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTSiteWiseMonitorServiceRole_1aEXAMPLE" } ``` 1. 서비스 역할을 포털에 연결하려면 다음 명령을 실행합니다. *role-arn*을 서비스 역할 ARN으로 바꾸고 나머지 파라미터를 해당 포털의 기존 값으로 바꿉니다. ``` aws iotsitewise update-portal \ --portal-id portal-id \ --role-arn role-arn \ --portal-name portal-name \ --portal-description portal-description \ --portal-contact-email portal-contact-email ``` ## SiteWiseMonitor에서 AWSIotSiteWiseMonitorServiceRole로 업데이트 이 서비스가 변경 사항을 추적하기 시작한 시점부터 SiteWise Monitor용 **AWSIoTSiteWiseMonitorServiceRole** 업데이트에 대한 세부 정보를 볼 수 있습니다. 이 페이지의 변경 사항에 대한 자동 알림을 받으려면 AWS IoT SiteWise 문서 기록 페이지에서 RSS 피드를 구독하세요. | 변경 | 설명 | Date | | --- | --- | --- | | [AWSIoTSiteWiseMonitorPortalAccess](#monitor-service-role-permissions) – 업데이트된 정책 | AWS IoT SiteWise 는 경보 기능에 대한 [AWSIoTSiteWiseMonitorPortalAccess](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AWSIoTSiteWiseMonitorPortalAccess) 관리형 정책을 업데이트했습니다. | 2021년 5월 27일 | | AWS IoT SiteWise 에서 변경 내용 추적 시작 | AWS IoT SiteWise 가 서비스 역할에 대한 변경 사항 추적을 시작했습니다. | 2020년 12월 15일 | # 에서 이벤트 경보에 대한 권한 설정 AWS IoT SiteWise AWS IoT Events 경보 모델을 사용하여 AWS IoT SiteWise 자산 속성을 모니터링하는 경우 다음 IAM 권한이 있어야 합니다. + 가 데이터를 전송할 수 있도록 허용하는 AWS IoT Events 서비스 역할 AWS IoT Events 입니다 AWS IoT SiteWise. 자세한 내용은 *AWS IoT Events 개발자 안내서*에서 [AWS IoT Events의 자격 증명 및 액세스 관리](https://docs.aws.amazon.com/iotevents/latest/developerguide/security-iam.html)를 참조하세요. + `iotsitewise:DescribeAssetModel` 및 AWS IoT SiteWise 작업 권한이 있어야 합니다`iotsitewise:UpdateAssetModelPropertyRouting`. 이러한 권한을 통해 AWS IoT SiteWise 는 자산 속성 값을 AWS IoT Events 경보 모델로 전송할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [리소스 기반 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_resource-based)을 참조하세요. ## 필요한 작업 권한 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. AWS IoT Events 경보 모델을 정의하기 전에가 경보 모델에 자산 속성 값을 AWS IoT SiteWise 전송하도록 허용하는 다음 권한을 부여해야 합니다. + `iotsitewise:DescribeAssetModel`, `iotsitewise:ListAssetModels`- 자산 속성이 존재하는지 AWS IoT Events 확인할 수 있습니다. + `iotsitewise:UpdateAssetModelPropertyRouting` -가 AWS IoT SiteWise 에 데이터를 전송할 수 있는 구독 AWS IoT SiteWise 을 자동으로 생성할 수 있습니다 AWS IoT Events. AWS IoT SiteWise 지원되는 작업에 대한 자세한 내용은 *서비스 승인* 참조의에서 [정의한 작업을 AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions) 참조하세요. **Example 권한 정책 예 1** 다음 정책은 AWS IoT SiteWise 가 모든 AWS IoT Events 경보 모델에 자산 속성 값을 전송하도록 허용합니다. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotevents:CreateAlarmModel", "iotevents:UpdateAlarmModel" ], "Resource": "arn:aws:iotevents:us-east-1:123456789012:alarmModel/*" }, { "Effect": "Allow", "Action": [ "iotsitewise:DescribeAssetModel", "iotsitewise:ListAssetModels", "iotsitewise:UpdateAssetModelPropertyRouting" ], "Resource": "arn:aws:iotsitewise:us-east-1:123456789012:asset-model/*" } ] } ``` **Example 권한 정책 예 2** 다음 정책은 AWS IoT SiteWise 가 지정된 자산 속성의 값을 지정된 AWS IoT Events 경보 모델로 전송하도록 허용합니다. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotevents:CreateAlarmModel", "iotevents:UpdateAlarmModel" ], "Resource": "arn:aws:iotevents:us-east-1:123456789012:alarmModel/*" }, { "Effect": "Allow", "Action": [ "iotsitewise:DescribeAssetModel", "iotsitewise:ListAssetModels" ], "Resource": "arn:aws:iotsitewise:us-east-1:123456789012:asset-model/*" }, { "Effect": "Allow", "Action": [ "iotsitewise:UpdateAssetModelPropertyRouting" ], "Resource": [ "arn:aws:iotsitewise:us-east-1:123456789012:asset-model/12345678-90ab-cdef-1234-567890abcdef" ], "Condition": { "StringLike": { "iotsitewise:propertyId": "abcdef12-3456-7890-abcd-ef1234567890", "aws:ResourceTag/AlarmModel": "arn:aws:iotevents:us-east-1:123456789012:alarmModel/MyAlarmModel" } } } ] } ``` ## (선택 사항) ListInputRoutings 권한 자산 모델을 업데이트하거나 삭제할 때는의 AWS IoT Events 경보 모델이이 자산 모델과 연결된 자산 속성을 모니터링하는지 확인할 AWS IoT SiteWise 수 있습니다. 이렇게 하면 AWS IoT Events 경보가 현재 사용 중인 자산 속성을 삭제할 수 없습니다. 에서이 기능을 활성화하려면 `iotevents:ListInputRoutings` 권한이 AWS IoT SiteWise있어야 합니다. 이 권한을 통해 AWS IoT SiteWise 는에서 지원하는 [ListInputRoutings](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListInputRoutings.html) API 작업을 호출할 수 있습니다 AWS IoT Events. **참고** `ListInputRoutings` 권한을 추가하는 것이 좋습니다. **Example 권한 정책 예** 다음 정책은 자산 모델을 업데이트 및 삭제하고에서 `ListInputRoutings` API를 사용할 수 있도록 허용합니다 AWS IoT SiteWise. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:UpdateAssetModel", "iotsitewise:DeleteAssetModel", "iotevents:ListInputRoutings" ], "Resource": "arn:aws:iotsitewise:us-east-1:123456789012:asset-model/*" } ] } ``` ------ ## SiteWise Monitor에 필요한 권한 SiteWise Monitor 포털에서 경보 기능을 사용하려면 [SiteWise Monitor 서비스 역할](monitor-service-role.md)을 다음 정책으로 업데이트해야 합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal", "iotsitewise:CreateProject", "iotsitewise:DescribeProject", "iotsitewise:UpdateProject", "iotsitewise:DeleteProject", "iotsitewise:ListProjects", "iotsitewise:BatchAssociateProjectAssets", "iotsitewise:BatchDisassociateProjectAssets", "iotsitewise:ListProjectAssets", "iotsitewise:CreateDashboard", "iotsitewise:DescribeDashboard", "iotsitewise:UpdateDashboard", "iotsitewise:DeleteDashboard", "iotsitewise:ListDashboards", "iotsitewise:CreateAccessPolicy", "iotsitewise:DescribeAccessPolicy", "iotsitewise:UpdateAccessPolicy", "iotsitewise:DeleteAccessPolicy", "iotsitewise:ListAccessPolicies", "iotsitewise:DescribeAsset", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:GetAssetPropertyValueHistory", "iotsitewise:GetAssetPropertyAggregates", "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:DescribeAssetModel", "iotsitewise:ListAssetModels", "iotsitewise:UpdateAssetModel", "iotsitewise:UpdateAssetModelPropertyRouting", "sso-directory:DescribeUsers", "sso-directory:DescribeUser", "iotevents:DescribeAlarmModel", "iotevents:ListTagsForResource" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "iotevents:BatchAcknowledgeAlarm", "iotevents:BatchSnoozeAlarm", "iotevents:BatchEnableAlarm", "iotevents:BatchDisableAlarm" ], "Resource": "*", "Condition": { "Null": { "iotevents:keyValue": "false" } } }, { "Effect": "Allow", "Action": [ "iotevents:CreateAlarmModel", "iotevents:TagResource" ], "Resource": "*", "Condition": { "Null": { "aws:RequestTag/iotsitewisemonitor": "false" } } }, { "Effect": "Allow", "Action": [ "iotevents:UpdateAlarmModel", "iotevents:DeleteAlarmModel" ], "Resource": "*", "Condition": { "Null": { "aws:ResourceTag/iotsitewisemonitor": "false" } } }, { "Effect": "Allow", "Action": [ "iam:PassRole" ], "Resource": "*", "Condition": { "StringEquals": { "iam:PassedToService": [ "iotevents.amazonaws.com" ] } } } ] } ``` ------ # 의 교차 서비스 혼동된 대리자 방지 AWS IoT SiteWise 혼동된 대리자 문제는 작업을 수행할 권한이 없는 엔터티가 권한이 더 많은 엔터티에게 작업을 수행하도록 강요할 수 있는 보안 문제입니다. 에서 AWS교차 서비스 가장은 혼동된 대리자 문제를 초래할 수 있습니다. 교차 서비스 가장은 한 서비스(*직접적으로 호출하는 서비스*)가 다른 서비스(*직접적으로 호출되는 서비스*)를 직접적으로 호출할 때 발생할 수 있습니다. 호출하는 서비스는 다른 고객의 리소스에 대해 액세스 권한이 없는 방식으로 작동하게 권한을 사용하도록 조작될 수 있습니다. 이를 방지하기 위해 AWS 에서는 계정의 리소스에 대한 액세스 권한이 부여된 서비스 위탁자를 사용하여 모든 서비스에 대한 데이터를 보호하는 데 도움이 되는 도구를 제공합니다. 리소스 정책에서 [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) 및 [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) 전역 조건 컨텍스트 키를 사용하여 리소스에 다른 서비스를 AWS IoT SiteWise 제공하는 권한을 제한하는 것이 좋습니다. 만약 `aws:SourceArn` 값에 Amazon S3 버킷 Amazon 리소스 이름(ARN)과 같은 계정 ID가 포함되어 있지 않은 경우 권한을 제한하려면 두 전역 조건 컨텍스트 키를 모두 사용해야 합니다. 두 전역 조건 컨텍스트 키와 계정을 포함한 `aws:SourceArn` 값을 모두 사용하는 경우, `aws:SourceAccount` 값 및 `aws:SourceArn` 값의 계정은 동일한 정책 명령문에서 사용할 경우 반드시 동일한 계정 ID를 사용해야 합니다. + 하나의 리소스만 교차 서비스 액세스와 연결되도록 허용하려는 경우 `aws:SourceArn`을 사용하세요. + 해당 계정의 모든 리소스가 교차 서비스 사용과 연결되도록 허용하려는 경우 `aws:SourceAccount`를 사용하세요. 의 값은 `sts:AssumeRole` 요청과 연결된 AWS IoT SiteWise 고객 리소스여야 `aws:SourceArn` 합니다. 혼동된 대리인 문제로부터 보호하는 가장 효과적인 방법은 리소스의 전체 ARN이 포함된 `aws:SourceArn`글로벌 조건 컨텍스트 키를 사용하는 것입니다. 리소스의 전체 ARN을 모를 경우 또는 여러 리소스를 지정하는 경우, ARN의 알 수 없는 부분에 대해 와일드카드(`*`)를 포함한 `aws:SourceArn` 글로벌 조건 컨텍스트 키를 사용합니다. 예를 들어 `arn:aws:servicename:*:123456789012:*`입니다. **Example – 혼동된 대리자 방지** 다음 예제에서는의 `aws:SourceArn` 및 `aws:SourceAccount` 전역 조건 컨텍스트 키를 사용하여 혼동된 대리자 문제를 AWS IoT SiteWise 방지하는 방법을 보여줍니다. **** ``` { "Version":"2012-10-17", "Statement": { "Sid": "ConfusedDeputyPreventionExamplePolicy", "Effect": "Allow", "Principal": { "Service": "iotsitewise.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:iotsitewise:*:123456789012:*" }, "StringEquals": { "aws:SourceAccount": "123456789012" } } } } ``` # AWS IoT SiteWise 자격 증명 및 액세스 문제 해결 다음 정보를 사용하여 AWS IoT SiteWise 및 AWS Identity and Access Management (IAM)로 작업할 때 발생할 수 있는 일반적인 문제를 진단하고 수정할 수 있습니다. **Topics** + [ ## 에서 작업을 수행할 권한이 없음 AWS IoT SiteWise ](#security_iam_troubleshoot-no-permissions) + [ ## `iam:PassRole` 작업을 수행할 권한이 없음 ](#security_iam_troubleshoot-passrole) + [ ## 내 AWS 계정 외부의 사람이 내 AWS IoT SiteWise 리소스에 액세스하도록 허용하고 싶습니다. ](#security_iam_troubleshoot-cross-account-access) ## 에서 작업을 수행할 권한이 없음 AWS IoT SiteWise 에서 작업을 수행할 권한이 없다는 AWS Management Console 메시지가 표시되면 관리자에게 문의하여 지원을 받아야 합니다. 관리자는 사용자 이름과 비밀번호를 제공한 사람입니다. 다음 예제 오류는 `mateojackson` IAM 사용자가 콘솔을 사용하여 자산의 세부 정보를 보려고 하지만 `iotsitewise:DescribeAsset` 권한이 없는 경우에 발생합니다. ``` User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: iotsitewise:DescribeAsset on resource: a1b2c3d4-5678-90ab-cdef-22222EXAMPLE ``` 이 경우 Mateo는 `iotsitewise:DescribeAsset` 작업을 사용하여 `a1b2c3d4-5678-90ab-cdef-22222EXAMPLE` ID가 있는 자산 리소스에 액세스할 수 있도록 정책을 업데이트할 것을 관리자에게 요청합니다. ## `iam:PassRole` 작업을 수행할 권한이 없음 `iam:PassRole` 작업을 수행할 수 있는 권한이 없다는 오류가 수신되면 AWS IoT SiteWise에 역할을 전달할 수 있도록 정책을 업데이트해야 합니다. 일부 AWS 서비스 에서는 새 서비스 역할 또는 서비스 연결 역할을 생성하는 대신 기존 역할을 해당 서비스에 전달할 수 있습니다. 이렇게 하려면 역할을 서비스에 전달할 권한이 있어야 합니다. 다음 예 오류는 `marymajor`라는 IAM 사용자가 콘솔을 사용하여 AWS IoT SiteWise에서 작업을 수행하려고 하는 경우에 발생합니다. 하지만 작업을 수행하려면 서비스 역할이 부여한 권한이 서비스에 있어야 합니다. Mary는 서비스에 역할을 전달할 권한이 없습니다. ``` User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole ``` 이 경우, Mary가 `iam:PassRole`작업을 수행할 수 있도록 Mary의 정책을 업데이트해야 합니다. 도움이 필요한 경우 AWS 관리자에게 문의하세요. 관리자는 로그인 자격 증명을 제공한 사람입니다. ## 내 AWS 계정 외부의 사람이 내 AWS IoT SiteWise 리소스에 액세스하도록 허용하고 싶습니다. 다른 계정의 사용자 또는 조직 외부의 사람이 리소스에 액세스할 때 사용할 수 있는 역할을 생성할 수 있습니다. 역할을 수임할 신뢰할 수 있는 사람을 지정할 수 있습니다. 리소스 기반 정책 또는 액세스 제어 목록(ACL)을 지원하는 서비스의 경우, 이러한 정책을 사용하여 다른 사람에게 리소스에 대한 액세스 권한을 부여할 수 있습니다. 자세한 내용은 다음을 참조하세요. + 에서 이러한 기능을 AWS IoT SiteWise 지원하는지 여부를 알아보려면 섹션을 참조하세요[AWS IoT SiteWise 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md). + 소유 AWS 계정 한의 리소스에 대한 액세스 권한을 제공하는 방법을 알아보려면 [IAM 사용 설명서의 소유한 다른의 IAM 사용자에게 액세스 권한 제공을 참조 AWS 계정 하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html). ** + 타사에 리소스에 대한 액세스 권한을 제공하는 방법을 알아보려면 *IAM 사용 설명서*의 [타사가 AWS 계정 소유한에 대한 액세스 권한 제공을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html) AWS 계정참조하세요. + ID 페더레이션을 통해 액세스 권한을 제공하는 방법을 알아보려면 *IAM 사용 설명서*의 [외부에서 인증된 사용자에게 액세스 권한 제공(ID 페더레이션)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)을 참조하세요. + 크로스 계정 액세스에 대한 역할과 리소스 기반 정책 사용의 차이점을 알아보려면 *IAM 사용 설명서*의 [IAM의 크로스 계정 리소스 액세스](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)를 참조하세요.