기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS CodeStar Notifications 및 AWS CodeConnections의 ID 및 액세스 관리

AWS Identity and Access Management (IAM)는 관리자가 AWS 리소스에 대한 액세스를 안전하게 제어하는 데 도움이 AWS 서비스 되는 입니다. IAM 관리자는 누가 AWS CodeStar Notifications 및CodeConnections AWS CodeConnections 리소스를 사용할 수 있는 인증(로그인) 및 권한(권한 있음)을 받을 수 있는지 제어합니다. IAM은 추가 비용 없이 사용할 수 AWS 서비스 있는 입니다.

대상

AWS Identity and Access Management (IAM)를 사용하는 방법은 역할에 따라 다릅니다.

ID를 통한 인증

인증은 자격 증명 자격 증명을 AWS 사용하여에 로그인하는 방법입니다. AWS 계정 루트 사용자, IAM 사용자 또는 IAM 역할을 수임하여 인증되어야 합니다.

AWS IAM Identity Center (IAM Identity Center), Single Sign-On 인증 또는 Google/Facebook 자격 증명과 같은 자격 증명 소스의 자격 증명을 사용하여 페더레이션 자격 증명으로 로그인할 수 있습니다. 로그인에 대한 자세한 내용은 AWS 로그인 사용 설명서의 에 로그인하는 방법을 AWS 계정 참조하세요.

프로그래밍 방식 액세스를 위해는 요청에 암호화 방식으로 서명할 수 있는 SDK 및 CLI를 AWS 제공합니다. 자세한 내용은 IAM 사용 설명서의 AWS API 요청에 대한 서명 버전 4를 참조하세요.

AWS 계정 루트 사용자

를 생성할 때 모든 AWS 서비스 및 리소스에 대한 완전한 액세스 권한이 있는 AWS 계정 theroot 사용자라는 하나의 로그인 자격 증명으로 AWS 계정시작합니다. 일상적인 작업에 루트 사용자를 사용하지 않는 것이 좋습니다. 루트 사용자 자격 증명이 필요한 태스크는 IAM 사용 설명서의 루트 사용자 자격 증명이 필요한 태스크를 참조하세요.

IAM 사용자 및 그룹

IAM 사용자는 단일 사용자 또는 애플리케이션에 대한 특정 권한이 있는 자격 증명입니다. 장기 자격 증명이 있는 IAM 사용자 대신 임시 자격 증명을 사용하는 것이 좋습니다. 자세한 내용은 IAM 사용 설명서의 자격 증명 공급자와의 페더레이션을 사용하여 임시 자격 증명을 AWS 사용하여에 액세스하도록 인간 사용자에게 요구하기를 참조하세요.

IAM 그룹은 IAM 사용자 모음을 지정하고 대규모 사용자 집합에 대한 관리 권한을 더 쉽게 만듭니다. 자세한 내용은 IAM 사용 설명서의 IAM 사용자 사용 사례를 참조하세요.

IAM 역할

IAM 역할은 임시 자격 증명을 제공하는 특정 권한이 있는 자격 증명입니다. 사용자에서 IAM 역할(콘솔)로 전환하거나 또는 API 작업을 호출하여 역할을 수임할 수 있습니다. AWS CLI AWS 자세한 내용은 IAM 사용 설명서의 역할 수임 방법을 참조하세요.

IAM 역할은 페더레이션 사용자 액세스, 임시 IAM 사용자 권한, 교차 계정 액세스, 교차 서비스 액세스 및 Amazon EC2에서 실행되는 애플리케이션에 유용합니다. 자세한 내용은 IAM 사용 설명서의 교차 계정 리소스 액세스를 참조하세요.

정책을 사용하여 액세스 관리

정책을 AWS 생성하고 자격 증명 또는 리소스에 연결하여 AWS 에서 액세스를 제어합니다. 정책은 자격 증명 또는 리소스와 연결될 때 권한을 정의합니다.는 보안 주체가 요청할 때 이러한 정책을 AWS 평가합니다. 대부분의 정책은에 JSON 문서 AWS 로 저장됩니다. JSON 정책 문서에 대한 자세한 내용은 IAM 사용 설명서의 JSON 정책 개요를 참조하세요.

정책을 사용하여 관리자는 어떤 보안 주체가 어떤 리소스에 대해 어떤 조건에서 작업을 수행할 수 있는지 정의하여 누가 무엇을 액세스할 수 있는지 지정합니다.

기본적으로, 사용자 및 역할에는 어떠한 권한도 없습니다. IAM 관리자는 IAM 정책을 생성하고 사용자가 수임할 수 있는 역할에 추가합니다. IAM 정책은 작업을 수행하는 데 사용되는 방법에 관계없이 권한을 정의합니다.

ID 기반 정책

자격 증명 기반 정책은 자격 증명(사용자, 그룹 또는 역할)에 연결하는 JSON 권한 정책 문서입니다. 이러한 정책은 자격 증명이 수행할 수 있는 작업, 리소스 및 조건을 제어합니다. 자격 증명 기반 정책을 생성하는 방법을 알아보려면 IAM 사용 설명서에서 고객 관리형 정책으로 사용자 지정 IAM 권한 정의를 참조하세요.

자격 증명 기반 정책은 인라인 정책(단일 자격 증명에 직접 포함) 또는 관리형 정책(여러 자격 증명에 연결된 독립 실행형 정책)일 수 있습니다. 관리형 정책과 인라인 정책 중에서 선택하는 방법을 알아보려면 IAM 사용 설명서의 관리형 정책과 인라인 정책 중에서 선택을 참조하세요.

AWS CodeConnections 권한 참조

다음 표에는 각 AWS CodeConnections API 작업, 권한을 부여할 수 있는 해당 작업, 권한 부여에 사용할 리소스 ARN의 형식이 나와 있습니다. AWS CodeConnections APIs는 해당 API에서 허용하는 작업 범위에 따라 테이블로 그룹화됩니다. IAM 자격 증명에 연결할 수 있는 쓰기 권한 정책(자격 증명 기반 정책)을 설정할 때 다음 표를 참조하세요.

권한 정책 생성 시 정책의 Action 필드에 작업을 지정합니다. 와일드카드(*) 사용 여부와 상관없이 정책의 Resource 필드에 리소스 값으로 ARN을 지정합니다.

연결 정책에서 조건을 표현하려면 여기에서 설명하고 조건 키에 나열되어 있는 조건 키를 사용합니다. AWS전체 조건 키를 사용할 수도 있습니다. AWS전체 키의 전체 목록은 IAM 사용 설명서의 사용 가능한 키를 참조하세요.

작업을 지정하려면 codeconnections 접두사 다음에 API 작업 이름을 사용합니다(예: codeconnections:ListConnections 또는 codeconnections:CreateConnection).

와일드카드 사용

여러 작업이나 리소스를 지정하려면 ARN에서 와일드카드(*)를 사용합니다. 예를 들어, codeconnections:*는 all AWS CodeConnections 작업을 지정하고 단어로 시작하는 all AWS CodeConnections 작업을 codeconnections:Get* 지정합니다Get. 다음 예는 이름이 MyConnection으로 시작되는 모든 리소스에 대한 액세스 권한을 부여합니다.

arn:aws:codeconnections:us-west-2:account-ID:connection/*

다음 표에 나열된 connection 리소스에만 와일드카드를 사용할 수 있습니다. region 또는 account-id 리소스에는 와일드카드를 사용할 수 없습니다. 와일드카드에 대한 자세한 내용은 IAM 사용 설명서에서 IAM 식별자를 참조하세요.

연결 관리 권한

AWS CLI 또는 SDK를 사용하여 연결을 보거나 생성하거나 삭제하도록 지정된 역할 또는 사용자는 다음으로 제한된 권한을 가져야 합니다.

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

다음 작업은 아래의 조건 키를 지원합니다.

호스트 관리를 위한 권한

AWS CLI 또는 SDK를 사용하여 호스트를 확인, 생성 또는 삭제하도록 지정된 역할 또는 사용자는 다음으로 제한된 권한을 가져야 합니다.

codeconnections:CreateHost
codeconnections:DeleteHost
codeconnections:GetHost
codeconnections:ListHosts

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

다음 작업은 아래의 조건 키를 지원합니다.

VpcId 조건 키를 사용하는 정책 예제는 섹션을 참조하세요예: VpcId 컨텍스트 키를 사용하여 호스트 VPC 권한 제한 .

연결을 완료하기 위한 권한

콘솔에서 연결을 관리하도록 지정된 역할 또는 사용자에게는 콘솔에서 연결을 완료하고 설치를 만드는 데 필요한 권한이 있어야 합니다. 여기에는 공급자에게 핸드셰이크 권한을 부여하고 사용할 연결에 대한 설치를 만드는 권한이 포함됩니다. 위의 권한 외에 다음 권한을 사용하십시오.

브라우저 기반 핸드셰이크를 수행하는 경우 콘솔에서 다음 IAM 작업이 사용됩니다. ListInstallationTargets, GetInstallationUrl, StartOAuthHandshake, UpdateConnectionInstallation, GetIndividualAccessToken은 IAM 정책 권한입니다. API 작업이 아닙니다.

codeconnections:GetIndividualAccessToken
codeconnections:GetInstallationUrl
codeconnections:ListInstallationTargets
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation

이를 기반으로 콘솔에서 연결을 사용, 생성, 업데이트 또는 삭제하려면 다음 권한이 필요합니다.

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

다음 작업은 아래의 조건 키를 지원합니다.

호스트 설정에 대한 권한

콘솔에서 연결을 관리하도록 지정된 역할 또는 사용자에게는 콘솔에서 호스트를 설정하는 데 필요한 권한이 있어야 합니다. 여기에는 공급자에 대한 핸드셰이크를 승인하고 호스트 앱을 설치하는 권한이 포함됩니다. 위의 호스트에 대한 권한 외에 다음 권한을 사용합니다.

브라우저 기반 호스트 등록을 수행할 때 콘솔에서 다음 IAM 작업이 사용됩니다. RegisterAppCode 및 StartAppRegistrationHandshake는 IAM 정책 권한입니다. API 작업이 아닙니다.

codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

이를 기반으로 콘솔에서 호스트(예: 설치된 공급자 유형)를 사용, 생성, 업데이트 또는 삭제하려면 다음 권한이 필요합니다.

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken
codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

다음 작업은 아래의 조건 키를 지원합니다.

서비스에 연결 전달

서비스에 연결을 전달하는 경우(예: 파이프라인을 만들거나 업데이트하기 위해 파이프라인 정의에 연결 ARN 제공) 사용자에게 codeconnections:PassConnection 권한이 있어야 합니다.

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

또한 이 작업은 다음 조건 키를 지원합니다.

연결 사용

CodePipeline 같은 서비스에서 연결을 사용하는 경우 해당 연결에 대한 codeconnections:UseConnection 권한이 서비스 역할에 있어야 합니다.

콘솔에서 연결을 관리하려면 사용자 정책에 codeconnections:UseConnection 권한이 있어야 합니다.

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

또한 이 작업은 다음 조건 키를 지원합니다.

일부 기능에 필요한 조건 키는 시간이 지남에 따라 변경될 수 있습니다. 액세스 제어 요구 사항에 따라 다른 권한이 필요하지 않는 한, codeconnections:UseConnection을 사용하여 연결에 대한 액세스를 제어하는 것이 좋습니다.

ProviderAction에 대해 지원되는 액세스 유형

AWS 서비스에서 연결을 사용하면 소스 코드 공급자에 대한 API 호출이 수행됩니다. 예를 들어 서비스에서 https://api.bitbucket.org/2.0/repositories/username API를 호출하여 Bitbucket 연결에 사용할 리포지토리를 나열할 수 있습니다.

ProviderAction 조건 키를 사용하면 공급자에 대한 호출을 수행할 수 있는 API를 제한할 수 있습니다. API 경로는 동적으로 생성될 수 있으며 공급자마다 경로가 다르기 때문에 ProviderAction 값은 API의 URL이 아닌 추상 작업 이름에 매핑됩니다. 이를 통해 연결의 공급자 유형에 관계없이 동일한 효과를 갖는 정책을 작성할 수 있습니다.

지원되는 각 ProviderAction 값에 대해 부여되는 액세스 유형은 다음과 같습니다. IAM 정책 권한은 다음과 같습니다. API 작업이 아닙니다.

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

연결 리소스 태깅에 대해 지원되는 권한

연결 리소스에 태깅할 때 다음 IAM 작업을 사용합니다.

codeconnections:ListTagsForResource
codeconnections:TagResource
codeconnections:UntagResource

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

리포지토리 링크에 연결 전달

동기화 구성에서 리포지토리 링크가 제공되는 경우 사용자에게 리포지토리 링크 ARN/리소스에 대한 codeconnections:PassRepository 권한이 있어야 합니다.

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

또한 이 작업은 다음 조건 키를 지원합니다.

리포지토리 링크에 지원되는 조건 키

리포지토리 링크 및 동기화 구성 리소스에 대한 작업은 다음 조건 키를 통해 지원됩니다.

연결 공유에 지원되는 권한

연결을 공유할 때 다음 IAM 작업이 사용됩니다.

codeconnections:GetResourcePolicy

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

연결 공유에 대한 자세한 내용은 섹션을 참조하세요와 연결 공유 AWS 계정.

콘솔에서 알림 및 연결 사용

알림 환경은 CodeBuild, CodeCommit, CodeDeploy, CodePipeline 콘솔은 물론, [설정(Settings)] 탐색 모음 자체의 개발자 도구 콘솔에도 내장되어 있습니다. 콘솔의 알림에 액세스하려면 해당 서비스에 대한 관리형 정책 중 하나가 적용되었거나 최소 권한 집합이 있어야 합니다. 이러한 권한은 AWS 계정의 AWS CodeStar Notifications 및 AWS CodeConnections 리소스에 대한 세부 정보를 나열하고 볼 수 있도록 허용해야 합니다. 최소 필수 권한보다 더 제한적인 보안 인증 기반 정책을 만들면 콘솔이 해당 정책에 연결된 개체(IAM 사용자 또는 역할)에 대해 의도대로 작동하지 않습니다. 이러한 콘솔에 대한 액세스를 AWS CodePipeline포함하여 AWS CodeBuild에 대한 액세스 권한 부여 AWS CodeCommit AWS CodeDeploy에 대한 자세한 내용은 다음 주제를 참조하세요.

AWS CodeStar Notifications에는 AWS 관리형 정책이 없습니다. 알림 기능에 대한 액세스를 제공하려면 앞에 나열된 서비스 중 하나에 대해 관리형 정책 중 하나를 적용하거나, 사용자 또는 엔터티에 부여하고자 하는 권한 수준이 포함된 정책을 생성한 다음 이 정책을 권한이 필요한 사용자, 그룹 또는 역할에 연결해야 합니다. 자세한 내용과 예는 다음을 참조하세요.

AWS CodeConnections에는 AWS 관리형 정책이 없습니다. 연결을 완료하기 위한 권한에서 설명하는 권한과 같이 개별 권한과 권한의 조합을 액세스에 사용합니다.

자세한 내용은 다음 자료를 참조하세요.

AWS CLI 또는 AWS 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": "*"
        }
    ]
}