지원 종료 공지: 2026년 10월 7일에는에 대한 지원을 중단할 AWS 예정입니다 AWS IoT Greengrass Version 1. 2026년 10월 7일 이후에는 더 이상 AWS IoT Greengrass V1 리소스에 액세스할 수 없습니다. 자세한 내용은 [에서 마이그레이션 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)을 참조하세요. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 에 대한 자격 증명 및 액세스 관리 AWS IoT Greengrass AWS Identity and Access Management (IAM)는 관리자가 AWS 리소스에 대한 액세스를 안전하게 제어하는 데 도움이 AWS 서비스 되는 입니다. IAM 관리자는 누가 AWS IoT Greengrass 리소스를 사용할 수 있는 *인증*(로그인) 및 *권한*(권한 있음)을 받을 수 있는지 제어합니다. IAM은 추가 비용 없이 사용할 수 AWS 서비스 있는 입니다. **참고** 이 주제에서는 IAM 개념과 기능에 대해 설명합니다. 에서 지원하는 IAM 기능에 대한 자세한 내용은 섹션을 AWS IoT Greengrass참조하세요[AWS IoT Greengrass 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md). ## 대상 AWS Identity and Access Management (IAM)를 사용하는 방법은 역할에 따라 다릅니다. + **서비스 사용자** - 기능에 액세스할 수 없는 경우 관리자에게 권한 요청(참조[에 대한 자격 증명 및 액세스 문제 해결 AWS IoT Greengrass](security_iam_troubleshoot.md)) + **서비스 관리자** - 사용자 액세스 결정 및 권한 요청 제출([AWS IoT Greengrass 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md) 참조) + **IAM 관리자** - 액세스를 관리하기 위한 정책 작성([에 대한 자격 증명 기반 정책 예제 AWS IoT Greengrass](security_iam_id-based-policy-examples.md) 참조) ## ID를 통한 인증 인증은 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 생성하고 자격 증명 또는 리소스에 연결하여 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 IoT Greengrass 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md) + [에 대한 자격 증명 기반 정책 예제 AWS IoT Greengrass](security_iam_id-based-policy-examples.md) + [에 대한 자격 증명 및 액세스 문제 해결 AWS IoT Greengrass](security_iam_troubleshoot.md) # AWS IoT Greengrass 에서 IAM을 사용하는 방법 IAM을 사용하여 액세스를 관리하기 전에 사용할 수 있는 IAM 기능을 이해해야 AWS IoT Greengrass합니다 AWS IoT Greengrass. | IAM 특성 | Greengrass에서 지원합니까? | | --- | --- | | [리소스 수준 권한이 있는 자격 증명 기반 정책](#security_iam_service-with-iam-id-based-policies) | 예 | | [리소스 기반 정책](#security_iam_service-with-iam-resource-based-policies) | 아니요 | | [액세스 제어 목록(ACL)](#security_iam_service-with-iam-acls) | 아니요 | | [태그 기반 승인](#security_iam_service-with-iam-tags) | 아니요 | | [임시 보안 인증](#security_iam_service-with-iam-roles-tempcreds) | 예 | | [서비스 연결 역할](#security_iam_service-with-iam-roles-service-linked) | 아니요 | | [서비스 역할](#security_iam_service-with-iam-roles-service-linked) | 예 | 다른 AWS 서비스에서 IAM을 사용하는 방법을 전체적으로 알아보려면 *IAM 사용 설명서*의 [AWS IAM으로 작업하는 서비스를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하세요. ## 에 대한 자격 증명 기반 정책 AWS IoT Greengrass IAM 자격 증명 기반 정책을 사용하면 허용되거나 거부된 작업 및 리소스와 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다.는 특정 작업, 리소스 및 조건 키를 AWS IoT Greengrass 지원합니다. 정책에서 사용하는 모든 요소에 대해 알아보려면 *IAM 사용 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요. ### 작업 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요. 에 대한 정책 작업은 작업 앞에 `greengrass:` 접두사를 AWS IoT Greengrass 사용합니다. 예를 들어 다른 사용자가 `ListGroups` API 작업을 사용하여 그룹을 나열하도록 허용하려면 해당 정책에 `greengrass:ListGroups` 작업을 AWS 계정포함합니다. 정책 명령문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. AWS IoT Greengrass 는 이 서비스로 수행할 수 있는 작업을 설명하는 고유한 작업 집합을 정의합니다. 명령문 하나에 여러 작업을 지정하려면 다음과 같이 괄호 안에 나열한 후(`[` `]`) 각 작업을 쉼표로 구분합니다. ``` "Action": [ "greengrass:action1", "greengrass:action2", "greengrass:action3" ] ``` 와일드카드(`*`)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, `List`라는 단어로 시작하는 모든 작업을 지정하려면 다음 작업을 포함합니다. ``` "Action": "greengrass:List*" ``` **참고** 와일드카드를 사용하여 서비스에 대해 사용 가능한 모든 작업을 지정하는 것은 권장하지 않습니다. 가장 좋은 방법은 정책에 최소한의 권한을 부여하고 권한을 좁히는 것입니다. 자세한 내용은 [가능한 최소 권한 부여](security-best-practices.md#least-privilege) 단원을 참조하십시오. AWS IoT Greengrass 작업의 전체 목록은 *IAM 사용 설명서*의 [에서 정의한 작업을 AWS IoT Greengrass](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsiotgreengrass.html#awsiotgreengrass-actions-as-permissions) 참조하세요. ### 리소스 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. `Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\$1)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다. ``` "Resource": "*" ``` 다음 표에는 정책 설명의 `Resource` 요소에 사용할 수 있는 AWS IoT Greengrass 리소스 ARNs이 나와 있습니다. AWS IoT Greengrass 작업에 지원되는 리소스 수준 권한의 매핑은 *IAM 사용 설명서*의 [에서 정의한 작업을 AWS IoT Greengrass](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsiotgreengrass.html#awsiotgreengrass-actions-as-permissions) 참조하세요. | Resource | ARN | | --- | --- | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listgroups-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroups-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/groups/\$1\$1GroupId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/groups/\$1\$1GroupId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupcertificateauthorities-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupcertificateauthorities-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/groups/\$1\$1GroupId\$1/certificateauthorities/\$1\$1CertificateAuthorityId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listdeployments-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listdeployments-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/groups/\$1\$1GroupId\$1/deployments/\$1\$1DeploymentId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listbulkdeployments-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listbulkdeployments-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/bulk/deployments/\$1\$1BulkDeploymentId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listconnectordefinitions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listconnectordefinitions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/connectors/\$1\$1ConnectorDefinitionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listconnectordefinitionversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listconnectordefinitionversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/connectors/\$1\$1ConnectorDefinitionId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listcoredefinitions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listcoredefinitions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/cores/\$1\$1CoreDefinitionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listcoredefinitionversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listcoredefinitionversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/cores/\$1\$1CoreDefinitionId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listdevicedefinitions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listdevicedefinitions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/devices/\$1\$1DeviceDefinitionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listdevicedefinitionversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listdevicedefinitionversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/devices/\$1\$1DeviceDefinitionId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listfunctiondefinitions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listfunctiondefinitions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/functions/\$1\$1FunctionDefinitionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listfunctiondefinitionversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listfunctiondefinitionversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/functions/\$1\$1FunctionDefinitionId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listloggerdefinitions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listloggerdefinitions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/loggers/\$1\$1LoggerDefinitionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listloggerdefinitionversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listloggerdefinitionversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/loggers/\$1\$1LoggerDefinitionId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listresourcedefinitions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listresourcedefinitions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/resources/\$1\$1ResourceDefinitionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listresourcedefinitionversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listresourcedefinitionversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/resources/\$1\$1ResourceDefinitionId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listsubscriptiondefinitions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listsubscriptiondefinitions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/subscriptions/\$1\$1SubscriptionDefinitionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/listsubscriptiondefinitionversions-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listsubscriptiondefinitionversions-get.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/definition/subscriptions/\$1\$1SubscriptionDefinitionId\$1/versions/\$1\$1VersionId\$1 | | [https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-connectivityinfo.html](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-connectivityinfo.html) | arn:\$1\$1Partition\$1:greengrass:\$1\$1Region\$1:\$1\$1Account\$1:/greengrass/things/\$1\$1ThingName\$1/connectivityInfo | 다음 예제 `Resource` 요소는의 미국 서부(오레곤) 리전에 있는 그룹의 ARN을 지정합니다 AWS 계정 `123456789012`. ``` "Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ``` 또는 특정의 AWS 계정 에 속하는 모든 그룹을 지정하려면 그룹 ID 대신 와일드카드를 AWS 리전사용합니다. ``` "Resource": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/*" ``` 일부 AWS IoT Greengrass 작업(예: 일부 목록 작업)은 특정 리소스에서 수행할 수 없습니다. 이러한 경우 와일드카드만 사용해야 합니다. ``` "Resource": "*" ``` 한 명령에 여러 리소스 ARN을 지정하려면 다음과 같이 괄호 사이에 나열하고(`[` `]`) 쉼표로 구분합니다. ``` "Resource": [ "resource-arn1", "resource-arn2", "resource-arn3" ] ``` ARN 형식에 대한 자세한 내용은의 [Amazon 리소스 이름(ARNs) 및 AWS 서비스 네임스페이스](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)를 참조하세요*Amazon Web Services 일반 참조*. ### 조건 키 관리자는 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) 참조하세요. AWS IoT Greengrass 는 다음과 같은 전역 조건 키를 지원합니다. | Key(키) | 설명 | | --- | --- | | aws:CurrentTime | 현재 날짜 및 시간에 대한 날짜/시간 조건을 확인하여 액세스를 필터링합니다. | | aws:EpochTime | Epoch 또는 UNIX 시간의 현재 날짜 및 시간에 대한 날짜/시간 조건을 확인하여 액세스를 필터링합니다. | | aws:MultiFactorAuthAge | Multi-Factor Authentication(MFA)을 사용하여 발행된 요청에서 MFA가 유효성을 검사한 보안 자격 증명이 경과한 시간(단위: 초)을 확인하여 액세스를 필터링합니다. | | aws:MultiFactorAuthPresent | Multi-Factor Authentication(MFA)을 사용하여 현재 요청을 수행한 임시 보안 자격 증명의 유효성을 검사했는지 여부를 확인하여 액세스를 필터링합니다. | | aws:RequestTag/\$1\$1TagKey\$1 | 각 필수 태그에 허용되는 값의 집합에 따라 생성 요청을 필터링합니다. | | aws:ResourceTag/\$1\$1TagKey\$1 | 리소스와 연결된 태그 값을 기준으로 작업을 필터링합니다. | | aws:SecureTransport | SSL을 사용하여 요청을 보냈는지 여부를 확인하여 액세스를 필터링합니다. | | aws:TagKeys | 요청에 필수 태그가 있는지 여부를 기준으로 생성 요청을 필터링합니다. | | aws:UserAgent | 요청자의 클라이언트 애플리케이션을 기준으로 액세스를 필터링합니다. | 자세한 내용은 *IAM 사용 설명서*의 [AWS 글로벌 조건 컨텍스트 키](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)를 참조하세요. ### 예제 자격 AWS IoT Greengrass 증명 기반 정책의 예를 보려면 섹션을 참조하세요[에 대한 자격 증명 기반 정책 예제 AWS IoT Greengrass](security_iam_id-based-policy-examples.md). ## 에 대한 리소스 기반 정책 AWS IoT Greengrass AWS IoT Greengrass 는 [리소스 기반 정책을](security-iam.md#security_iam_access-manage-resource-based-policies) 지원하지 않습니다. ## 액세스 제어 목록(ACL) AWS IoT Greengrass 는 [ACLs](security-iam.md#security_iam_access-manage-acl) 지원하지 않습니다. ## AWS IoT Greengrass 태그 기반 권한 부여 AWS IoT Greengrass 는 태그 기반 권한 부여를 지원하지 않습니다. ## 에 대한 IAM 역할 AWS IoT Greengrass [IAM 역할은](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 특정 권한이 AWS 계정 있는 내의 엔터티입니다. ### 에서 임시 자격 증명 사용 AWS IoT Greengrass 임시 보안 인증 정보는 페더레이션을 통해 로그인하거나, 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 작업을 호출하여 임시 보안 자격 증명을 얻습니다. Greengrass 코어에서는 [그룹 역할](group-role.md)에 대한 임시 보안 인증 정보를 사용자 정의 Lambda 함수 및 커넥터에 사용할 수 있습니다. Lambda 함수가 AWS SDK를 사용하는 경우 AWS SDK가 이를 대신 수행하므로 자격 증명을 얻기 위해 로직을 추가할 필요가 없습니다. ### 서비스 연결 역할 AWS IoT Greengrass 는 [서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) 지원하지 않습니다. ### 서비스 역할 이 기능을 사용하면 서비스가 사용자를 대신하여 [서비스 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)을 수임할 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 IAM 계정에 나타나고, 해당 계정이 소유합니다. 즉, IAM 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다. AWS IoT Greengrass 는 서비스 역할을 사용하여 사용자를 대신하여 일부 AWS 리소스에 액세스합니다. 자세한 내용은 [Greengrass 서비스 역할](service-role.md) 단원을 참조하십시오. ### AWS IoT Greengrass 콘솔에서 IAM 역할 선택 AWS IoT Greengrass 콘솔에서 계정의 IAM 역할 목록에서 Greengrass 서비스 역할 또는 Greengrass 그룹 역할을 선택해야 할 수 있습니다. + Greengrass 서비스 역할을 사용하면가 사용자를 대신하여 다른 서비스의 AWS 리소스에 AWS IoT Greengrass 액세스할 수 있습니다. 일반적으로 콘솔이 서비스 역할을 만들고 구성할 수 있으므로 사용자는 서비스 역할을 선택할 필요가 없습니다. 자세한 내용은 [Greengrass 서비스 역할](service-role.md) 단원을 참조하십시오. + Greengrass 그룹 역할은 그룹의 Greengrass Lambda 함수 및 커넥터가 AWS 리소스에 액세스하도록 허용하는 데 사용됩니다. 또한 스트림을 AWS 서비스로 내보내고 CloudWatch 로그를 쓸 수 있는 AWS IoT Greengrass 권한을 부여할 수 있습니다. 자세한 내용은 [Greengrass 그룹 역할](group-role.md) 단원을 참조하십시오. # Greengrass 서비스 역할 Greengrass 서비스 역할은가 사용자를 대신하여 서비스의 리소스에 액세스할 AWS IoT Greengrass 수 있도록 권한을 부여하는 AWS Identity and Access Management (IAM) AWS 서비스 역할입니다. 이렇게 하면 AWS IoT Greengrass 가 AWS Lambda 함수 검색 및 AWS IoT 섀도우 관리와 같은 필수 작업을 수행할 수 있습니다. 가 리소스 AWS IoT Greengrass 에 액세스하도록 허용하려면 Greengrass 서비스 역할을 AWS 계정 와 연결하고를 신뢰할 수 있는 엔터 AWS IoT Greengrass 티로 지정해야 합니다. 역할에는 [ AWSGreengrassResourceAccessRolePolicy](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy) 관리형 정책 또는 사용하는 AWS IoT Greengrass 기능에 대해 동등한 권한을 정의하는 사용자 지정 정책이 포함되어야 합니다. 이 정책은에서 AWS 유지 관리하며가 AWS 리소스에 액세스하는 데 AWS IoT Greengrass 사용하는 권한 세트를 정의합니다. 에서 동일한 Greengrass 서비스 역할을 재사용할 수 있지만 AWS 리전사용하는 모든 AWS 리전 의 계정과 연결해야 합니다 AWS IoT Greengrass. 현재 AWS 계정 및 리전에 서비스 역할이 없는 경우 그룹 배포가 실패합니다. 다음 섹션에서는 AWS Management Console 또는에서 Greengrass 서비스 역할을 생성하고 관리하는 방법을 설명합니다 AWS CLI. + [서비스 역할 관리(콘솔)](#manage-service-role-console) + [서비스 역할 관리(CLI)](#manage-service-role-cli) **참고** 서비스 수준 액세스를 승인하는 서비스 역할 외에도 *그룹에 그룹 역할을* 할당할 수 있습니다 AWS IoT Greengrass . 그룹 역할은 그룹의 Greengrass Lambda 함수 및 커넥터가 AWS 서비스에 액세스하는 방법을 제어하는 별도의 IAM 역할입니다. ## Greengrass 서비스 역할 관리(콘솔) AWS IoT 콘솔을 사용하면 Greengrass 서비스 역할을 쉽게 관리할 수 있습니다. 예를 들어 Greengrass 그룹을 생성하거나 배포할 때 콘솔 AWS 계정 은 콘솔에서 현재 선택된의 Greengrass 서비스 역할에 AWS 리전 이 연결되어 있는지 확인합니다. 연결이 되어 있지 않으면 콘솔이 사용자를 대신하여 서비스 역할을 생성 및 구성할 수 있습니다. 자세한 내용은 [Greengrass 서비스 역할 생성(콘솔)](#create-service-role-console) 단원을 참조하십시오. 콘솔을 사용하여 다음 역할 관리 작업을 수행할 수 있습니다 AWS IoT . + [Greengrass 서비스 역할 검색](#get-service-role-console) + [Greengrass 서비스 역할 생성](#create-service-role-console) + [Greengrass 서비스 역할 변경](#update-service-role-console) + [Greengrass 서비스 역할 분리](#remove-service-role-console) **참고** 콘솔에 로그인한 사용자는 해당 서비스 역할을 보고, 생성하고, 변경할 수 있는 권한을 가져야 합니다.   ### Greengrass 서비스 역할 검색(콘솔) 다음 단계에 따라 현재에서 사용 AWS IoT Greengrass 중인 서비스 역할을 찾습니다 AWS 리전. 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)의 탐색 창에서 **설정**을 선택합니다. 1. **Greengrass service role(Greengrass 서비스 역할)** 섹션으로 스크롤하여 서비스 역할과 그 정책을 확인합니다. 서비스 역할이 표시되지 않으면 콘솔에게 사용자를 대신해 역할을 생성 또는 구성하도록 할 수 있습니다. 자세한 내용은 [Greengrass 서비스 역할 생성](#create-service-role-console) 단원을 참조하십시오.   ### Greengrass 서비스 역할 생성(콘솔) 콘솔이 사용자를 대신하여 기본 Greengrass 서비스 역할을 생성 및 구성할 수 있습니다. 이 역할에는 다음 속성이 있습니다. | 속성 | 값 | | --- | --- | | 이름 | Greengrass\$1ServiceRole | | 신뢰할 수 있는 엔터티. | AWS service: greengrass | | 정책 | [AWSGreengrassResourceAccessRolePolicy](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy) | **참고** [Greengrass 장치 설정](quick-start.md)에서 서비스 역할을 생성하는 경우 역할 이름은 `GreengrassServiceRole_random-string`입니다. AWS IoT 콘솔에서 Greengrass 그룹을 생성하거나 배포할 때 콘솔은 콘솔에서 현재 선택된 AWS 계정 AWS 리전 에서 Greengrass 서비스 역할이와 연결되어 있는지 확인합니다. 그렇지 않은 경우 콘솔에서가 사용자를 대신하여 AWS 서비스를 읽고 쓸 수 AWS IoT Greengrass 있도록 허용하라는 메시지가 표시됩니다. 권한을 부여하는 경우, 콘솔은 `Greengrass_ServiceRole` 이라는 이름의 역할이 AWS 계정계정에 존재하는지 여부를 확인합니다. + 역할이 있는 경우 콘솔은 현재의 AWS 계정 에 서비스 역할을 연결합니다 AWS 리전. + 역할이 없는 경우 콘솔은 기본 Greengrass 서비스 역할을 생성하여 현재의 AWS 계정 에 연결합니다 AWS 리전. **참고** 사용자 지정 역할 정책을 사용하여 서비스를 생성하려는 경우에는 IAM 콘솔을 사용하여 역할을 생성하거나 수정하세요. 자세한 내용은 *IAM 사용 설명서*의 [AWS 서비스에 권한을 위임할 역할 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) 또는 [역할 수정을 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html). 역할이 사용하는 기능 및 리소스에 대한 `AWSGreengrassResourceAccessRolePolicy` 관리형 정책과 동일한 권한을 부여하는지 확인합니다. 혼동된 대리자 보안 문제를 방지하려면 신뢰 정책에 `aws:SourceArn` 및 `aws:SourceAccount` 글로벌 조건 컨텍스트 키도 포함하는 것이 좋습니다.** 조건 컨텍스트 키는 지정된 계정 및 Greengrass 작업 영역에서 들어오는 요청만 허용하도록 액세스를 제한합니다. 혼동된 대리자 문제에 대한 자세한 내용은, [교차 서비스 혼동된 대리인 방지](cross-service-confused-deputy-prevention.md)를 참조하세요. 서비스 역할을 생성하는 경우 AWS IoT 콘솔로 돌아가 해당 역할을 그룹에 연결합니다. 그룹 **설정** 페이지의 **Greengrass 서비스 역할**에서 이 작업을 수행할 수 있습니다.   ### Greengrass 서비스 역할 변경(콘솔) 다음 절차에 따라 콘솔 AWS 계정 에서 AWS 리전 현재 선택한의에 연결할 다른 Greengrass 서비스 역할을 선택합니다. 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)의 탐색 창에서 **설정**을 선택합니다. 1. **Greengrass 서비스 역할**에서 **역할 선택**을 선택합니다. **Greengrass 서비스 역할 업데이트** 대화 상자가 열리고에서 신뢰할 수 있는 엔터 AWS IoT Greengrass 티로 AWS 계정 정의하는 IAM 역할이 표시됩니다. 1. 연결할 Greengrass 서비스 역할을 선택합니다. 1. **역할 연결**을 선택합니다. **참고** 콘솔이 사용자를 대신해 기본 Greengrass 서비스 역할을 생성하도록 허용하려면 목록에서 역할을 선택하는 대신 **Create role for me(사용자를 대신해 역할 생성)**를 선택합니다. 사용자의 AWS 계정에 이름이 `Greengrass_ServiceRole`인 역할이 있는 경우 **나를 위한 역할 생성** 링크가 표시되지 않습니다.   ### Greengrass 서비스 역할 분리(콘솔) 다음 절차에 따라 콘솔 AWS 계정 에서 AWS 리전 현재 선택한의에서 Greengrass 서비스 역할을 분리합니다. 이렇게 하면 AWS IoT Greengrass 가 현재의 AWS 서비스에 액세스할 수 있는 권한이 취소됩니다 AWS 리전. **중요** 서비스 역할을 분리하면 진행 중인 작업에 방해가 될 수 있습니다. 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)의 탐색 창에서 **설정**을 선택합니다. 1. **Greengrass 서비스 역할**에서 **분리**를 선택합니다. 1. 확인 대화 상자에서 **분리(Detach)**를 선택합니다. **참고** 역할이 더 이상 필요하지 않으면 IAM 콘솔에서 이를 삭제할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*에서 [역할 또는 인스턴스 프로파일 삭제](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html)를 참조하세요. 다른 역할은가 리소스에 액세스 AWS IoT Greengrass 하도록 허용할 수 있습니다. AWS IoT Greengrass 이(가) 사용자를 대신하여 권한을 위임할 수 있는 모든 역할을 찾으려면 IAM 콘솔의 **역할** 페이지의 **신뢰할 수 있는 엔터티** 열에서 **AWS 서비스: greengrass**가 포함된 역할을 찾아보십시오. ## Greengrass 서비스 역할 관리(CLI) 다음 절차에서는 AWS 계정 ID를 사용하도록 AWS CLI 가 설치 및 구성되어 있다고 가정합니다. 자세한 내용은 *AWS Command Line Interface 사용 설명서*[의 AWS 명령줄 인터페이스 설치](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) 및 [구성을 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 참조하세요. 다음 역할 관리 작업에 AWS CLI 를 사용할 수 있습니다. + [Greengrass 서비스 역할 가져오기](#get-service-role) + [Greengrass 서비스 역할 생성](#create-service-role) + [Greengrass 서비스 역할 제거](#remove-service-role)   ### Greengrass 서비스 역할 가져오기(CLI) 다음 절차에 따라 Greengrass 서비스 역할이 AWS 계정 의와 연결되어 있는지 확인합니다 AWS 리전. + 서비스 역할을 가져옵니다. *region*을 로 바꿉니다 AWS 리전 (예: `us-west-2`). ``` aws Greengrass get-service-role-for-account --region region ``` Greengrass 서비스 역할이 계정과 이미 연결되어 있는 경우 다음 역할 메타데이터가 반환됩니다. ``` { "AssociatedAt": "timestamp", "RoleArn": "arn:aws:iam::account-id:role/path/role-name" } ``` 역할 메타데이터가 반환되지 않는 경우 서비스 역할을 생성하고(없는 경우) 해당 역할을 AWS 리전의 계정과 연결해야 합니다.   ### Greengrass 서비스 역할 생성(CLI) 다음 단계에 따라 역할을 생성하고 AWS 계정과 연결합니다. **IAM을 사용하여 서비스 역할을 생성하려면** 1. 가 역할을 수 AWS IoT Greengrass 임하도록 허용하는 신뢰 정책을 사용하여 역할을 생성합니다. 이 예제에서는 `Greengrass_ServiceRole`라는 역할을 생성하지만, 다른 이름을 사용할 수 있습니다. *혼동된 대리자* 보안 문제를 방지하려면 신뢰 정책에 `aws:SourceArn` 및 `aws:SourceAccount` 글로벌 조건 컨텍스트 키도 포함하는 것이 좋습니다. 조건 컨텍스트 키는 지정된 계정 및 Greengrass 작업 영역에서 들어오는 요청만 허용하도록 액세스를 제한합니다. 혼동된 대리자 문제에 대한 자세한 내용은, [교차 서비스 혼동된 대리인 방지](cross-service-confused-deputy-prevention.md)를 참조하세요. ------ #### [ Linux, macOS, or Unix ] ``` aws iam create-role --role-name Greengrass_ServiceRole --assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "greengrass.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "ArnLike": { "aws:SourceArn": "arn:aws:greengrass:region:account-id:*" } } } ] }' ``` ------ #### [ Windows command prompt ] ``` aws iam create-role --role-name Greengrass_ServiceRole --assume-role-policy-document "{\"Version\":\"2012-10-17\", \"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"greengrass.amazonaws.com\"},\"Action\":\"sts:AssumeRole\",\"Condition\":{\"ArnLike\":{\"aws:SourceArn\":\"arn:aws:greengrass:region:account-id:*\"},\"StringEquals\":{\"aws:SourceAccount\":\"account-id\"}}}]}" ``` ------ 1. 출력의 역할 메타데이터에서 역할 ARN을 복사합니다. ARN을 사용하여 역할을 계정과 연결합니다. 1. `AWSGreengrassResourceAccessRolePolicy` 정책을 역할에 연결합니다. ``` aws iam attach-role-policy --role-name Greengrass_ServiceRole --policy-arn arn:aws:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy ``` **서비스 역할을와 연결하려면 AWS 계정** + 역할을 계정과 연결합니다. *role-arn*을 서비스 역할 ARN으로 바꾸고 *region*을 로 바꿉니다 AWS 리전 (예: `us-west-2`). ``` aws greengrass associate-service-role-to-account --role-arn role-arn --region region ``` 성공하면 다음 응답이 반환됩니다. ``` { "AssociatedAt": "timestamp" } ```   ### Greengrass 서비스 역할 제거(CLI) 다음 단계를 사용하여 AWS 계정에서 Greengrass 서비스 역할의 연결을 해제합니다. + 계정에서 서비스 역할의 연결을 해제합니다. *region*을 로 바꿉니다 AWS 리전 (예: `us-west-2`). ``` aws greengrass disassociate-service-role-from-account --region region ``` 성공하면 다음 응답이 반환됩니다. ``` { "DisassociatedAt": "timestamp" } ``` **참고** 서비스 역할을 사용하지 않는 경우 삭제해야 합니다 AWS 리전. 먼저 [https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role-policy.html)를 사용하여 역할에서 `AWSGreengrassResourceAccessRolePolicy` 관리형 정책을 연결 해제하고, [https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role.html](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role.html)을 사용하여 역할을 삭제합니다. 자세한 내용은 *IAM 사용 설명서*에서 [역할 또는 인스턴스 프로파일 삭제](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html)를 참조하세요. ## 다음 사항도 참조하세요. + *IAM 사용 설명서*의 [AWS 서비스에 권한을 위임하는 역할 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) + [IAM 사용자 설명서](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html)에서 *역할 수정* + 자세한 내용은 *IAM 사용 설명서*에서 [역할 또는 인스턴스 프로필 삭제](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html)를 참조하세요. + AWS IoT Greengrass 명령 *AWS CLI 참조의 명령* + [associate-service-role-to-account](https://docs.aws.amazon.com/cli/latest/reference/greengrass/associate-service-role-to-account.html) + [disassociate-service-role-from-account](https://docs.aws.amazon.com/cli/latest/reference/greengrass/disassociate-service-role-from-account.html) + [get-service-role-for-account](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-service-role-for-account.html) + *AWS CLI 명령 참조*에서 IAM 명령 + [attach-role-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html) + [create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html) + [delete-role](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role.html) + [delete-role-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role-policy.html) # Greengrass 그룹 역할 Greengrass 그룹 역할은 Greengrass 코어에서 실행되는 코드가 AWS 리소스에 액세스하도록 권한을 부여하는 역할입니다. 역할을 생성하고 AWS Identity and Access Management (IAM)에서 권한을 관리하고 역할을 Greengrass 그룹에 연결합니다. Greengrass 그룹에는 하나의 그룹 역할이 있습니다. 권한을 추가하거나 변경하려면 다른 역할을 연결하거나 역할에 연결된 IAM 정책을 변경하면 됩니다. 역할은를 신뢰할 수 있는 엔 AWS IoT Greengrass 터티로 정의해야 합니다. 비즈니스 사례에 따라 그룹 역할에 다음을 정의하는 IAM 정책이 포함될 수 있습니다. + 사용자 정의 [Lambda 함수](lambda-functions.md)가 AWS 서비스에 액세스할 수 있는 권한. + [커넥터](connectors.md)가 AWS 서비스에 액세스할 수 있는 권한. + [스트림 관리자가](stream-manager.md) 스트림을 AWS IoT 분석 및 Kinesis Data Streams로 내보낼 수 있는 권한. + [CloudWatch 로깅](greengrass-logs-overview.md)에 대한 권한 다음 섹션에서는 AWS Management Console 또는에서 Greengrass 그룹 역할을 연결하거나 분리하는 방법을 설명합니다 AWS CLI. + [그룹 역할 관리(콘솔)](#manage-group-role-console) + [그룹 역할 관리(CLI)](#manage-group-role-cli) **참고** Greengrass 코어에서 액세스를 승인하는 그룹 역할 외에도가 사용자를 대신하여 AWS 리소스에 AWS IoT Greengrass 액세스할 수 있도록 허용하는 [Greengrass 서비스 역할을](service-role.md) 할당할 수 있습니다. ## Greengrass 그룹 역할 관리(콘솔) 콘솔을 사용하여 다음 역할 관리 작업을 수행할 수 있습니다 AWS IoT . + [Greengrass 그룹 역할 찾기](#get-group-role-console) + [Greengrass 그룹 역할 추가 또는 변경](#add-or-change-group-role-console) + [Greengrass 그룹 역할 제거](#remove-group-role-console) **참고** 콘솔에 로그인한 사용자는 해당 역할을 관리할 수 있는 권한을 가져야 합니다.   ### Greengrass 그룹 역할 찾기(콘솔) Greengrass 그룹에 연결된 역할을 찾으려면 다음 단계를 수행하십시오. 1. AWS IoT 콘솔 탐색 창의 **관리**에서 **Greengrass 디바이스**를 확장한 다음 **그룹(V1)을** 선택합니다. 1. 대상 그룹을 선택합니다. 1. 그룹 구성 페이지에서 **설정 보기**를 선택합니다. 역할이 그룹에 연결된 경우 **그룹 역할** 아래에 나타납니다.   ### Greengrass 그룹 역할 추가 또는 변경(콘솔) 다음 단계에 따라에서 Greengrass 그룹에 AWS 계정 추가할 IAM 역할을 선택합니다. 그룹 역할에는 다음과 같은 요구사항이 있습니다. + AWS IoT Greengrass 는 신뢰할 수 있는 엔터티로 정의됩니다. + 역할에 연결된 권한 정책은 그룹의 Lambda 함수 및 커넥터와 Greengrass 시스템 구성 요소에 필요한 AWS 리소스에 권한을 부여해야 합니다. **참고** 혼동된 대리자 보안 문제를 방지하려면 신뢰 정책에 `aws:SourceArn` 및 `aws:SourceAccount` 글로벌 조건 컨텍스트 키도 포함하는 것이 좋습니다.** 조건 컨텍스트 키는 지정된 계정 및 Greengrass 작업 영역에서 들어오는 요청만 허용하도록 액세스를 제한합니다. 혼동된 대리자 문제에 대한 자세한 내용은, [교차 서비스 혼동된 대리인 방지](cross-service-confused-deputy-prevention.md)를 참조하세요. IAM 콘솔을 사용하여 역할과 권한을 만들고 구성합니다. Amazon DynamoDB 테이블에 대한 액세스를 허용하는 예제 역할을 만드는 단계는 [그룹 역할 구성](config-iam-roles.md)을 참조하십시오. 일반적인 단계는 *IAM 사용 설명서*의 [AWS 서비스에 대한 역할 생성(콘솔)을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html#roles-creatingrole-service-console) 참조하세요.   역할을 구성한 후 AWS IoT 콘솔을 사용하여 그룹에 역할을 추가합니다. **참고** 이 절차는 그룹에 대한 역할을 선택하는 경우에만 필요합니다. 현재 선택한 그룹 역할의 권한을 변경한 후에는 필요하지 않습니다. 1. AWS IoT 콘솔 탐색 창의 **관리**에서 **Greengrass 디바이스**를 확장한 다음 **그룹(V1)을** 선택합니다. 1. 대상 그룹을 선택합니다. 1. 그룹 구성 페이지에서 **설정 보기**를 선택합니다. 1. **그룹 역할**에서 역할을 추가하거나 변경하도록 선택합니다. + 역할을 추가하려면 **역할 연결**을 선택한 다음 역할 목록에서 역할을 선택합니다. 이는에서 신뢰할 수 AWS 계정 있는 엔터 AWS IoT Greengrass 티로 정의하는 역할입니다. + 다른 역할을 선택하려면 **역할 편집**을 선택한 다음 역할 목록에서 역할을 선택합니다. 1. **저장**을 선택합니다.   ### Greengrass 그룹 역할 제거(콘솔) Greengrass 그룹에서 역할을 분리하려면 다음 단계를 수행하십시오. 1. AWS IoT 콘솔 탐색 창의 **관리**에서 **Greengrass 디바이스**를 확장한 다음 **그룹(V1)을** 선택합니다. 1. 대상 그룹을 선택합니다. 1. 그룹 구성 페이지에서 **설정 보기**를 선택합니다. 1. **그룹 역할**에서 **역할 연결 해제**를 선택합니다. 1. 확인 대화 상자에서 **연결 해제**를 선택합니다. 이 단계는 그룹에서 역할을 제거하지만 역할은 삭제하지 않습니다. 역할을 삭제하려면 IAM 콘솔을 사용합니다. ## Greengrass 그룹 역할 관리(CLI) 다음 역할 관리 작업에 AWS CLI 를 사용할 수 있습니다. + [Greengrass 그룹 역할 가져오기](#get-group-role) + [Greengrass 그룹 역할 생성](#create-group-role) + [Greengrass 그룹 역할 제거](#remove-group-role)   ### Greengrass 그룹 역할 가져오기(CLI) Greengrass 그룹에 연결된 역할이 있는지 확인하려면 다음 단계를 수행하십시오. 1. 그룹 목록에서 대상 그룹의 ID를 가져옵니다. ``` aws greengrass list-groups ``` 다음은 `list-groups` 응답의 예입니다. 응답의 각 그룹에는 그룹 ID가 포함된 `Id` 속성이 포함됩니다. ``` { "Groups": [ { "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE", "Name": "MyFirstGroup", "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z", "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE", "CreationTimestamp": "2019-11-11T05:47:31.435Z", "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE", "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE" }, { "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE", "Name": "GreenhouseSensors", "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z", "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE", "CreationTimestamp": "2020-01-07T19:58:36.774Z", "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE", "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE" }, ... ] } ``` `query` 옵션을 사용하여 결과를 필터링하는 예제를 비롯한 자세한 내용은 [그룹 ID 가져오기](deployments.md#api-get-group-id) 단원을 참조하십시오. 1. 출력에서 대상 그룹의 `Id`을 복사합니다. 1. 그룹 역할을 가져옵니다. *group-id*를 대상 그룹의 ID로 바꿉니다. ``` aws greengrass get-associated-role --group-id group-id ``` 역할이 Greengrass 그룹과 연결된 경우, 다음 역할 메타데이터가 반환됩니다. ``` { "AssociatedAt": "timestamp", "RoleArn": "arn:aws:iam::account-id:role/path/role-name" } ``` 그룹에 연결된 역할이 없으면 다음 오류가 반환됩니다. ``` An error occurred (404) when calling the GetAssociatedRole operation: You need to attach an IAM role to this deployment group. ```   ### Greengrass 그룹 역할 생성(CLI) 역할을 생성하고 Greengrass 그룹에 연결하려면 다음 단계를 수행하십시오. **IAM을 사용하여 그룹 역할을 생성하려면** 1. 가 역할을 수 AWS IoT Greengrass 임하도록 허용하는 신뢰 정책을 사용하여 역할을 생성합니다. 이 예제에서는 `MyGreengrassGroupRole`라는 역할을 생성하지만, 다른 이름을 사용할 수 있습니다. *혼동된 대리자* 보안 문제를 방지하려면 신뢰 정책에 `aws:SourceArn` 및 `aws:SourceAccount` 글로벌 조건 컨텍스트 키도 포함하는 것이 좋습니다. 조건 컨텍스트 키는 지정된 계정 및 Greengrass 작업 영역에서 들어오는 요청만 허용하도록 액세스를 제한합니다. 혼동된 대리자 문제에 대한 자세한 내용은, [교차 서비스 혼동된 대리인 방지](cross-service-confused-deputy-prevention.md)를 참조하세요. ------ #### [ Linux, macOS, or Unix ] ``` aws iam create-role --role-name MyGreengrassGroupRole --assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "greengrass.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "ArnLike": { "aws:SourceArn": "arn:aws:greengrass:region:account-id:/greengrass/groups/group-id" } } } ] }' ``` ------ #### [ Windows command prompt ] ``` aws iam create-role --role-name MyGreengrassGroupRole --assume-role-policy-document "{\"Version\":\"2012-10-17\", \"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"greengrass.amazonaws.com\"},\"Action\":\"sts:AssumeRole\",\"Condition\":{\"ArnLike\":{\"aws:SourceArn\":\"arn:aws:greengrass:region:account-id:/greengrass/groups/group-id\"},\"StringEquals\":{\"aws:SourceAccount\":\"account-id\"}}}]}" ``` ------ 1. 출력의 역할 메타데이터에서 역할 ARN을 복사합니다. ARN을 사용하여 역할을 그룹과 연결합니다. 1. 비즈니스 사례를 지원할 관리형 또는 인라인 정책을 역할에 연결합니다. 예를 들어 사용자 정의 Lambda 함수를 Amazon S3에서 읽는 경우 `AmazonS3ReadOnlyAccess` 관리형 정책을 역할에 연결할 수 있습니다. ``` aws iam attach-role-policy --role-name MyGreengrassGroupRole --policy-arn arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess ``` 성공하면 응답이 반환되지 않습니다.   **역할을 Greengrass 그룹과 연결하려면** 1. 그룹 목록에서 대상 그룹의 ID를 가져옵니다. ``` aws greengrass list-groups ``` 다음은 `list-groups` 응답의 예입니다. 응답의 각 그룹에는 그룹 ID가 포함된 `Id` 속성이 포함됩니다. ``` { "Groups": [ { "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE", "Name": "MyFirstGroup", "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z", "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE", "CreationTimestamp": "2019-11-11T05:47:31.435Z", "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE", "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE" }, { "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE", "Name": "GreenhouseSensors", "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z", "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE", "CreationTimestamp": "2020-01-07T19:58:36.774Z", "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE", "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE" }, ... ] } ``` `query` 옵션을 사용하여 결과를 필터링하는 예제를 비롯한 자세한 내용은 [그룹 ID 가져오기](deployments.md#api-get-group-id) 단원을 참조하십시오. 1. 출력에서 대상 그룹의 `Id`을 복사합니다. 1. 역할을 그룹과 연결합니다. *group-id*를 대상 그룹의 ID로 바꾸고 *role-arn*을 그룹 역할의 ARN으로 바꿉니다. ``` aws greengrass associate-role-to-group --group-id group-id --role-arn role-arn ``` 성공하면 다음 응답이 반환됩니다. ``` { "AssociatedAt": "timestamp" } ```   ### Greengrass 그룹 역할 제거(CLI) Greengrass 그룹에서 그룹 역할의 연결을 해제하려면 다음 단계를 수행하십시오. 1. 그룹 목록에서 대상 그룹의 ID를 가져옵니다. ``` aws greengrass list-groups ``` 다음은 `list-groups` 응답의 예입니다. 응답의 각 그룹에는 그룹 ID가 포함된 `Id` 속성이 포함됩니다. ``` { "Groups": [ { "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE", "Name": "MyFirstGroup", "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z", "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE", "CreationTimestamp": "2019-11-11T05:47:31.435Z", "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE", "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE" }, { "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE", "Name": "GreenhouseSensors", "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z", "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE", "CreationTimestamp": "2020-01-07T19:58:36.774Z", "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE", "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE" }, ... ] } ``` `query` 옵션을 사용하여 결과를 필터링하는 예제를 비롯한 자세한 내용은 [그룹 ID 가져오기](deployments.md#api-get-group-id) 단원을 참조하십시오. 1. 출력에서 대상 그룹의 `Id`을 복사합니다. 1. 그룹에서 역할의 연결을 해제합니다. *group-id*를 대상 그룹의 ID로 바꿉니다. ``` aws greengrass disassociate-role-from-group --group-id group-id ``` 성공하면 다음 응답이 반환됩니다. ``` { "DisassociatedAt": "timestamp" } ``` **참고** 그룹 역할을 사용하지 않는 경우 삭제할 수 있습니다. 먼저 [https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role-policy.html)를 사용하여 역할에서 각 관리형 정책을 연결 해제하고, [https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role.html](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role.html)을 사용하여 역할을 삭제합니다. 자세한 내용은 *IAM 사용 설명서*에서 [역할 또는 인스턴스 프로파일 삭제](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html)를 참조하세요. ## 다음 사항도 참조하세요. + *IAM 사용자 설명서*의 관련 주제 + [AWS 서비스에 권한을 위임하는 역할 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) + [역할 변경](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) + [IAM 자격 증명 권한 추가 및 제거](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) + [역할 또는 인스턴스 프로파일 삭제](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) + AWS IoT Greengrass 명령 *AWS CLI 참조의 명령* + [list-groups](https://docs.aws.amazon.com/cli/latest/reference/greengrass/list-groups.html) + [associate-role-to-group](https://docs.aws.amazon.com/cli/latest/reference/greengrass/associate-role-to-group.html) + [disassociate-role-from-group](https://docs.aws.amazon.com/cli/latest/reference/greengrass/disassociate-role-from-group.html) + [get-associated-role](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-associated-role.html) + *AWS CLI 명령 참조에서* 사용 가능한 IAM 명령 + [attach-role-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html) + [create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html) + [delete-role](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role.html) + [delete-role-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-role-policy.html) # 교차 서비스 혼동된 대리인 방지 혼동된 대리자 문제는 작업을 수행할 권한이 없는 엔터티가 권한이 더 많은 엔터티에게 작업을 수행하도록 강요할 수 있는 보안 문제입니다. 에서 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 Greengrass 제공하는 권한을 제한하는 것이 좋습니다. 두 전역 조건 컨텍스트 키를 모두 사용하는 경우 `aws:SourceAccount` 값과 `aws:SourceArn` 값의 계정은 동일한 정책 문에서 사용할 경우 동일한 계정 ID를 사용해야 합니다. `aws:SourceArn`의 값은 `sts:AssumeRole` 요청과 관련된 Greengrass 고객 리소스여야 합니다. 혼동된 대리인 문제로부터 보호하는 가장 효과적인 방법은 리소스의 전체 ARN이 포함된 `aws:SourceArn`글로벌 조건 컨텍스트 키를 사용하는 것입니다. 리소스의 전체 ARN을 모를 경우 또는 여러 리소스를 지정하는 경우, ARN의 알 수 없는 부분에 대해 와일드카드(`*`)를 포함한 `aws:SourceArn`전역 조건 컨텍스트 키를 사용합니다. 예제: `arn:aws:greengrass:region:account-id:*`. `aws:SourceArn` 및 `aws:SourceAccount` 전역 조건 컨텍스트 키를 사용하는 정책의 추가 예는 다음 주제를 참조하세요. + [Greengrass 서비스 역할 생성](service-role.md#create-service-role) + [Greengrass 그룹 역할 생성](group-role.md#create-group-role) + [벌크 배포를 위한 IAM 실행 역할 생성 및 구성](bulk-deploy-cli.md#bulk-deploy-cli-create-role) # 에 대한 자격 증명 기반 정책 예제 AWS IoT Greengrass 기본적으로 IAM 사용자 및 역할은 AWS IoT Greengrass 리소스를 생성하거나 수정할 수 있는 권한이 없습니다. 또한 AWS Management Console AWS CLI또는 AWS API를 사용하여 작업을 수행할 수 없습니다. IAM 관리자는 지정된 리소스에서 특정 API 작업을 수행할 수 있는 권한을 사용자와 역할에게 부여하는 IAM 정책을 생성해야 합니다. 그런 다음 관리자는 해당 권한이 필요한 IAM 사용자 또는 그룹에 이러한 정책을 연결해야 합니다. ## 정책 모범 사례 자격 증명 기반 정책에 따라 계정에서 사용자가 AWS IoT Greengrass 리소스를 생성, 액세스 또는 삭제할 수 있는지 여부가 결정됩니다. 이 작업으로 인해 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 에 대한 관리형 정책 AWS IoT Greengrass AWS IoT Greengrass 는 IAM 사용자 및 역할에 권한을 부여하는 데 사용할 수 있는 다음과 같은 AWS 관리형 정책을 유지합니다. | 정책 | 설명 | | --- | --- | | [AWSGreengrassFullAccess](https://console.aws.amazon.com/iam/home?region=us-west-2#/policies/arn%3Aaws%3Aiam%3A%3Aaws%3Apolicy%2FAWSGreengrassFullAccess) | 모든 AWS 리소스에 대한 모든 AWS IoT Greengrass 작업을 허용합니다. 이 정책은 AWS IoT Greengrass [서비스 관리자](security-iam.md#security_iam_audience) 또는 테스트 목적으로 권장됩니다. | | [ AWSGreengrassReadOnlyAccess](https://console.aws.amazon.com/iam/home?region=us-west-2#/policies/arn%3Aaws%3Aiam%3A%3Aaws%3Apolicy%2FAWSGreengrassReadOnlyAccess) | 모든 AWS 리소스에 대해 `List` 및 `Get` AWS IoT Greengrass 작업을 허용합니다. | | [AWSGreengrassResourceAccessRolePolicy](https://console.aws.amazon.com/iam/home?region=us-west-2#/policies/arn%3Aaws%3Aiam%3A%3Aaws%3Apolicy%2Fservice-role%2FAWSGreengrassResourceAccessRolePolicy) | 및 AWS IoT 디바이스 섀도우를 포함한 AWS AWS Lambda 서비스의 리소스에 대한 액세스를 허용합니다. [Greengrass 서비스 역할](service-role.md)에 사용되는 기본 정책입니다. 이 정책은 일반적인 접근성을 제공하도록 설계되었습니다. 보다 제한적인 사용자 지정 정책을 정의할 수 있습니다. | | [GreengrassOTAUpdateArtifactAccess](https://console.aws.amazon.com/iam/home?region=us-west-2#/policies/arn%3Aaws%3Aiam%3A%3Aaws%3Apolicy%2Fservice-role%2FGreengrassOTAUpdateArtifactAccess) | 모든 AWS 리전에서 AWS IoT Greengrass 코어 소프트웨어의 over-the-air(OTA) 업데이트 아티팩트에 대한 읽기 전용 액세스를 허용합니다. | ## 정책 예시 다음 예제의 고객 정의 정책은 일반적인 시나리오에 대한 권한을 부여합니다. **Topics** + [사용자가 자신의 고유한 권한을 볼 수 있도록 허용](#security_iam_id-based-policy-examples-view-own-permissions) 이러한 예제 JSON 정책 문서를 사용하여 IAM ID 기반 정책을 생성하는 방법을 알아보려면 *IAM 사용자 설명서*의 [JSON 탭에서 정책 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)을 참조하세요. ### 사용자가 자신의 고유한 권한을 볼 수 있도록 허용 이 예제는 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 IoT Greengrass 다음 정보를 사용하여 및 IAM으로 작업할 때 발생할 수 있는 일반적인 문제를 진단 AWS IoT Greengrass 하고 수정할 수 있습니다. **Topics** + [에서 작업을 수행할 권한이 없음 AWS IoT Greengrass](#security_iam_troubleshoot-no-permissions) + [오류: Greengrass is not authorized to assume the Service Role associated with this account 또는 오류: Failed: TES service role is not associated with this account.](#troubleshoot-assume-service-role) + [오류: 역할을 사용하려고 할 때 권한이 거부되었습니다.:role/ to access s3 url https://-greengrass-updates.s3..amazonaws.com/core//greengrass-core-.tar.gz.](#troubleshoot-ota-region-access) + [장치 섀도우가 클라우드와 동기화하지 않습니다.](#troubleshoot-shadow-sync) + [iam:PassRole을 수행하도록 인증되지 않음](#security_iam_troubleshoot-passrole) + [관리자인데 다른 사람이에 액세스하도록 허용하려고 함 AWS IoT Greengrass](#security_iam_troubleshoot-admin-delegate) + [내 외부의 사람이 내 AWS IoT Greengrass 리소스에 액세스 AWS 계정 하도록 허용하고 싶습니다.](#security_iam_troubleshoot-cross-account-access) 일반적인 문제 해결 도움말은 [문제 해결 AWS IoT Greengrass](gg-troubleshooting.md) 섹션을 참조하십시오. ## 에서 작업을 수행할 권한이 없음 AWS IoT Greengrass 작업을 수행할 권한이 없다는 오류가 수신되면 관리자에게 문의하여 도움을 받아야 합니다. 관리자는 사용자 이름과 암호를 제공한 사람입니다. 다음 예제 오류는 `mateojackson` IAM 사용자가 코어 정의 버전에 대한 세부 정보를 보려고 하지만 `greengrass:GetCoreDefinitionVersion` 권한이 없는 경우에 발생합니다. ``` User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: greengrass:GetCoreDefinitionVersion on resource: resource: arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/78cd17f3-bc68-ee18-47bd-5bda5EXAMPLE/versions/368e9ffa-4939-6c75-859c-0bd4cEXAMPLE ``` 이 경우, Mateo는 `arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/78cd17f3-bc68-ee18-47bd-5bda5EXAMPLE/versions/368e9ffa-4939-6c75-859c-0bd4cEXAMPLE` 작업을 사용하여 `greengrass:GetCoreDefinitionVersion` 리소스에 액세스하도록 허용하는 정책을 업데이트하라고 관리자에게 요청합니다. ## 오류: Greengrass is not authorized to assume the Service Role associated with this account 또는 오류: Failed: TES service role is not associated with this account. **해결책:** 배포에 실패하면 이 오류가 발생할 수 있습니다. Greengrass 서비스 역할이 현재 AWS 리전의 AWS 계정 계정과 연결되어 있는지 확인합니다. 자세한 내용은 [Greengrass 서비스 역할 관리(CLI)](service-role.md#manage-service-role-cli) 또는 [Greengrass 서비스 역할 관리(콘솔)](service-role.md#manage-service-role-console)을 참조하세요. ## 오류: 역할을 사용하려고 할 때 권한이 거부되었습니다.:role/ to access s3 url https://-greengrass-updates.s3..amazonaws.com/core//greengrass-core-.tar.gz. **해결책:** 무선(OTA) 업데이트가 실패하면 이 오류가 발생할 수 있습니다. 서명자 역할 정책에서 대상 AWS 리전 을 `Resource`로서 추가합니다. 이 서명자 역할은 AWS IoT Greengrass 소프트웨어 업데이트를 위한 S3 URL에 미리 서명하는 데 사용됩니다. 자세한 내용은 [S3 URL 서명자 역할](core-ota-update.md#s3-url-signer-role)을 참조하십시오. ## 장치 섀도우가 클라우드와 동기화하지 않습니다. **해결 방법:** AWS IoT Greengrass 에 [Greengrass 서비스 역할](service-role.md)의 `iot:UpdateThingShadow` 및 `iot:GetThingShadow` 작업에 대한 권한이 있는지 확인합니다. 서비스 역할이 `AWSGreengrassResourceAccessRolePolicy` 관리형 정책을 사용하는 경우 이러한 권한은 기본적으로 포함됩니다. [섀도우 동기화 제한 시간 문제 해결](gg-troubleshooting.md#troubleshooting-shadow-sync)을(를) 참조하세요. 다음은 AWS IoT Greengrass에서 작업할 때 발생할 수 있는 일반적인 IAM 문제입니다. ## iam:PassRole을 수행하도록 인증되지 않음 `iam:PassRole` 작업을 수행할 수 있는 권한이 없다는 오류가 수신되면 AWS IoT Greengrass에 역할을 전달할 수 있도록 정책을 업데이트해야 합니다. 일부 AWS 서비스 에서는 새 서비스 역할 또는 서비스 연결 역할을 생성하는 대신 기존 역할을 해당 서비스에 전달할 수 있습니다. 이렇게 하려면 역할을 서비스에 전달할 권한이 있어야 합니다. 다음 예 오류는 `marymajor`라는 IAM 사용자가 콘솔을 사용하여 AWS IoT Greengrass에서 작업을 수행하려고 하는 경우에 발생합니다. 하지만 작업을 수행하려면 서비스 역할이 부여한 권한이 서비스에 있어야 합니다. Mary는 서비스에 역할을 전달할 권한이 없습니다. ``` User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole ``` 이 경우, Mary가 `iam:PassRole`작업을 수행할 수 있도록 Mary의 정책을 업데이트해야 합니다. 도움이 필요한 경우 AWS 관리자에게 문의하세요. 관리자는 로그인 자격 증명을 제공한 사람입니다. ## 관리자인데 다른 사람이에 액세스하도록 허용하려고 함 AWS IoT Greengrass 다른 사용자에게 액세스를 허용하려면 액세스 권한이 필요한 사용자 또는 애플리케이션에 권한을 부여해야 AWS IoT Greengrass합니다. AWS IAM Identity Center 를 사용하여 사용자 및 애플리케이션을 관리하는 경우 사용자 또는 그룹에 권한 세트를 할당하여 액세스 수준을 정의합니다. 권한 세트는 IAM 정책을 자동으로 생성하고 사용자 또는 애플리케이션과 연결된 IAM 역할에 할당합니다. 자세한 내용은 *AWS IAM Identity Center 사용 설명서*에서 [권한 세트](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)를 참조하세요. IAM Identity Center를 사용하지 않는 경우 액세스가 필요한 사용자 또는 애플리케이션에 대한 IAM 엔터티(사용자 또는 역할)를 생성해야 합니다. 그런 다음 AWS IoT Greengrass에 대한 올바른 권한을 부여하는 정책을 엔터티에 연결해야 합니다. 권한이 부여되면 사용자 또는 애플리케이션 개발자에게 자격 증명을 제공합니다. 이들은 이 자격 증명을 사용하여 AWS에 액세스합니다. IAM 사용자, 그룹, 정책 및 권한 생성에 대해 자세히 알아보려면 *IAM 사용자 설명서*의 [IAM 자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)과 [IAM의 권한 및 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)을 참조하세요. ## 내 외부의 사람이 내 AWS IoT Greengrass 리소스에 액세스 AWS 계정 하도록 허용하고 싶습니다. 다른 계정의 사용자 또는 조직 외부의 사용자가 AWS 리소스에 액세스하는 데 사용할 수 있는 IAM 역할을 생성할 수 있습니다. 역할을 수임할 신뢰할 수 있는 사람을 지정할 수 있습니다. 자세한 내용은 [IAM 사용 설명서의 AWS 계정 자신이 소유한 다른의 IAM 사용자에게 액세스 권한](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html) [제공 및 타사가 소유한 Amazon Web Services 계정에 액세스 권한](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html) 제공을 참조하세요. ** AWS IoT Greengrass 는 리소스 기반 정책 또는 액세스 제어 목록(ACLs)을 기반으로 하는 교차 계정 액세스를 지원하지 않습니다.