AWS CodeStar 알림에 대한 ID 및 액세스 관리 AWS CodeConnections

AWS Identity and Access Management (IAM) 은 관리자가 리소스에 대한 액세스를 안전하게 제어할 수 AWS 서비스 있도록 AWS 도와줍니다. IAM 관리자는 AWS CodeStar 알림 및 리소스를 사용할 수 있는 인증 (로그인) 및 권한 부여 (권한 보유) 를 받을 수 있는 사용자를 제어합니다. AWS CodeConnections IAM은 추가 AWS 서비스 비용 없이 사용할 수 있습니다.

참고

새 서비스 접두사로 생성된 리소스에 대한 작업을 사용할 수 codeconnections 있습니다. 새 서비스 접두사로 리소스를 생성하면 리소스 codeconnections ARN에서 사용됩니다. codestar-connections서비스 접두사에 대한 작업 및 리소스는 계속 사용할 수 있습니다. IAM 정책에서 리소스를 지정할 때 서비스 접두사는 리소스의 접두사와 일치해야 합니다.

주제

• 고객
• ID를 통한 인증
• 정책을 사용한 액세스 관리
• 개발자 도구 콘솔의 기능이 IAM에서 작동하는 방식
• AWS CodeConnections 권한 참조
• 자격 증명 기반 정책 예시
• 태그를 사용하여 AWS CodeConnections 리소스에 대한 액세스를 제어합니다.
• 콘솔에서 알림 및 연결 사용
• 사용자가 자신이 권한을 볼 수 있도록 허용
• AWS CodeStar 알림, AWS CodeConnections ID 및 액세스 문제 해결
• 알림에 서비스 연결 역할 사용 AWS CodeStar
• AWS CodeConnections에 서비스 연결 역할 사용
• AWS 에 대한 관리형 정책 AWS CodeConnections

고객

사용 방법 AWS Identity and Access Management (IAM) 은 알림 및 에서 수행하는 작업에 따라 다릅니다. AWS CodeStar AWS CodeConnections

서비스 사용자 - AWS CodeStar 알림 및 AWS CodeConnections 서비스를 사용하여 작업을 수행하는 경우 관리자가 필요한 자격 증명과 권한을 제공합니다. 더 많은 AWS CodeStar 알림 및 AWS CodeConnections 기능을 사용하여 업무를 수행함에 따라 추가 권한이 필요할 수 있습니다. 액세스 권한 관리 방식을 이해하면 적절한 권한을 관리자에게 요청할 수 있습니다. AWS CodeStar 알림 및 AWS CodeConnections 기능에 액세스할 수 없는 경우 을 참조하십시오AWS CodeStar 알림, AWS CodeConnections ID 및 액세스 문제 해결.

서비스 관리자 — 회사에서 AWS CodeStar 알림 및 AWS CodeConnections 리소스를 담당하는 경우 알림 및 리소스에 AWS CodeStar 대한 전체 액세스 권한이 있을 수 AWS CodeConnections 있습니다. 서비스 사용자가 액세스해야 하는 AWS CodeStar 알림, AWS CodeConnections 기능 및 리소스를 결정하는 것은 여러분의 몫입니다. 그런 다음, IAM 관리자에게 요청을 제출하여 서비스 사용자의 권한을 변경해야 합니다. 이 페이지의 정보를 검토하여 IAM의 기본 개념을 이해하십시오. 회사에서 IAM을 AWS CodeStar 알림 및 과 함께 사용하는 방법에 대해 자세히 AWS CodeConnections 알아보려면 을 참조하십시오개발자 도구 콘솔의 기능이 IAM에서 작동하는 방식.

IAM 관리자 — IAM 관리자라면 알림 및 에 대한 액세스를 관리하기 위한 정책을 작성하는 방법에 대해 자세히 알고 싶을 것입니다 AWS CodeStar . AWS CodeConnections IAM에서 사용할 수 있는 AWS CodeStar 알림 및 AWS CodeConnections 자격 증명 기반 정책의 예를 보려면 을 참조하십시오. 자격 증명 기반 정책 예시

ID를 통한 인증

인증은 자격 증명 자격 증명을 AWS 사용하여 로그인하는 방법입니다. IAM 사용자로 인증 (로그인 AWS) 하거나 IAM 역할을 맡아 인증 (로그인) 해야 합니다. AWS 계정 루트 사용자

ID 소스를 통해 제공된 자격 증명을 사용하여 페더레이션 ID로 로그인할 수 있습니다. AWS AWS IAM Identity Center (IAM ID 센터) 사용자, 회사의 싱글 사인온 인증, Google 또는 Facebook 자격 증명이 페더레이션 ID의 예입니다. 페더레이션 ID로 로그인할 때 관리자가 이전에 IAM 역할을 사용하여 ID 페더레이션을 설정했습니다. 페더레이션을 사용하여 액세스하는 경우 AWS 간접적으로 역할을 맡게 됩니다.

사용자 유형에 따라 AWS Management Console 또는 AWS 액세스 포털에 로그인할 수 있습니다. 로그인에 대한 자세한 내용은 AWS 로그인 사용 설명서의 내 로그인 방법을 참조하십시오. AWS AWS 계정

AWS 프로그래밍 방식으로 액세스하는 경우 자격 증명을 사용하여 요청에 암호화 방식으로 서명할 수 있는 소프트웨어 개발 키트 (SDK) 와 명령줄 인터페이스 (CLI) 를 AWS 제공합니다. AWS 도구를 사용하지 않는 경우 요청에 직접 서명해야 합니다. 권장 방법을 사용하여 직접 요청에 서명하는 방법에 대한 자세한 내용은 IAM 사용 설명서의 AWS API 요청 서명을 참조하십시오.

사용하는 인증 방법에 상관없이 추가 보안 정보를 제공해야 할 수도 있습니다. 예를 들어, AWS 계정의 보안을 강화하기 위해 다단계 인증 (MFA) 을 사용할 것을 권장합니다. 자세한 내용은 AWS IAM Identity Center 사용 설명서의 다중 인증 및 IAM 사용 설명서의 AWS에서 다중 인증(MFA) 사용을 참조하십시오.

AWS 계정 루트 사용자

계정을 만들 때는 먼저 AWS 계정계정의 모든 AWS 서비스 리소스와 모든 리소스에 완전히 액세스할 수 있는 하나의 로그인 ID로 시작합니다. 이 ID를 AWS 계정 루트 사용자라고 하며, 계정을 만들 때 사용한 이메일 주소와 비밀번호로 로그인하여 액세스할 수 있습니다. 일상적인 태스크에 루트 사용자를 사용하지 않을 것을 강력히 권장합니다. 루트 사용자 보안 인증 정보를 보호하고 루트 사용자만 수행할 수 있는 태스크를 수행하는 데 사용하세요. 루트 사용자로 로그인해야 하는 전체 작업 목록은 IAM 사용 설명서의 Tasks that require root user credentials를 참조하십시오.

IAM 사용자 및 그룹

IAM 사용자는 단일 사용자 또는 애플리케이션에 대한 특정 권한을 가진 사용자 내의 자격 증명입니다. AWS 계정 가능하면 암호 및 액세스 키와 같은 장기 보안 인증이 있는 IAM 사용자를 생성하는 대신 임시 보안 인증을 사용하는 것이 좋습니다. 하지만 IAM 사용자의 장기 보안 인증이 필요한 특정 사용 사례가 있는 경우, 액세스 키를 교체하는 것이 좋습니다. 자세한 내용은 IAM 사용 설명서의 장기 보안 인증이 필요한 사용 사례의 경우 정기적으로 액세스 키 교체를 참조하십시오.

IAM 그룹은 IAM 사용자 컬렉션을 지정하는 자격 증명입니다. 사용자는 그룹으로 로그인할 수 없습니다. 그룹을 사용하여 여러 사용자의 권한을 한 번에 지정할 수 있습니다. 그룹을 사용하면 대규모 사용자 집합의 권한을 더 쉽게 관리할 수 있습니다. 예를 들어, IAMAdmins라는 그룹이 있고 이 그룹에 IAM 리소스를 관리할 권한을 부여할 수 있습니다.

사용자는 역할과 다릅니다. 사용자는 한 사람 또는 애플리케이션과 고유하게 연결되지만, 역할은 해당 역할이 필요한 사람이라면 누구나 수임할 수 있습니다. 사용자는 영구적인 장기 보안 인증 정보를 가지고 있지만, 역할은 임시 보안 인증만 제공합니다. 자세한 내용은 IAM 사용 설명서의 IAM 사용자를 만들어야 하는 경우(역할이 아님)를 참조하십시오.

IAM 역할

IAM 역할은 특정 권한을 가진 사용자 AWS 계정 내의 자격 증명입니다. IAM 사용자와 유사하지만, 특정 개인과 연결되지 않습니다. 역할을 AWS Management Console 전환하여 에서 일시적으로 IAM 역할을 맡을 수 있습니다. AWS CLI 또는 AWS API 작업을 호출하거나 사용자 지정 URL을 사용하여 역할을 수임할 수 있습니다. 역할 사용 방법에 대한 자세한 내용은 IAM 사용 설명서의 IAM 역할 사용을 참조하십시오.

임시 보안 인증이 있는 IAM 역할은 다음과 같은 상황에서 유용합니다.

• 페더레이션 사용자 액세스 - 페더레이션 ID에 권한을 부여하려면 역할을 생성하고 해당 역할의 권한을 정의합니다. 페더레이션 ID가 인증되면 역할이 연결되고 역할에 정의된 권한이 부여됩니다. 페더레이션 역할에 대한 자세한 내용은 IAM 사용 설명서의 서드 파티 ID 공급자의 역할 생성 단원을 참조하십시오. IAM Identity Center를 사용하는 경우, 권한 집합을 구성합니다. 인증 후 ID가 액세스할 수 있는 항목을 제어하기 위해 IAM Identity Center는 권한 세트를 IAM의 역할과 연관짓습니다. 권한 세트에 대한 자세한 내용은 AWS IAM Identity Center 사용 설명서의 권한 세트를 참조하십시오.

• 임시 IAM 사용자 권한 - IAM 사용자 또는 역할은 IAM 역할을 수임하여 특정 태스크에 대한 다양한 권한을 임시로 받을 수 있습니다.

• 크로스 계정 액세스 - IAM 역할을 사용하여 다른 계정의 사용자(신뢰할 수 있는 보안 주체)가 내 계정의 리소스에 액세스하도록 허용할 수 있습니다. 역할은 계정 간 액세스를 부여하는 기본적인 방법입니다. 그러나 일부 AWS 서비스경우에는 역할을 프록시로 사용하는 대신 정책을 리소스에 직접 연결할 수 있습니다. 크로스 계정 액세스에 대한 역할과 리소스 기반 정책의 차이점을 알아보려면 IAM 사용 설명서의 IAM의 크로스 계정 리소스 액세스를 참조하세요.

• 서비스 간 액세스 — 일부는 다른 AWS 서비스서비스의 기능을 AWS 서비스 사용합니다. 예를 들어 서비스에서 직접적 호출을 수행하면 일반적으로 해당 서비스는 Amazon EC2에서 애플리케이션을 실행하거나 Amazon S3에 객체를 저장합니다. 서비스는 직접적으로 호출하는 보안 주체의 권한을 사용하거나, 서비스 역할을 사용하거나, 또는 서비스 연결 역할을 사용하여 이 태스크를 수행할 수 있습니다.

  • 순방향 액세스 세션 (FAS) — IAM 사용자 또는 역할을 사용하여 작업을 수행하는 경우 보안 AWS주체로 간주됩니다. 일부 서비스를 사용하는 경우 다른 서비스에서 다른 작업을 시작하는 작업을 수행할 수 있습니다. FAS는 전화를 거는 주체의 권한을 다운스트림 AWS 서비스서비스에 AWS 서비스 요청하기 위한 요청과 결합하여 사용합니다. FAS 요청은 다른 서비스 AWS 서비스 또는 리소스와의 상호 작용이 필요한 요청을 서비스가 수신한 경우에만 이루어집니다. 이 경우 두 작업을 모두 수행할 수 있는 권한이 있어야 합니다. FAS 요청 시 정책 세부 정보는 전달 액세스 세션을 참조하세요.

  • 서비스 역할 - 서비스 역할은 서비스가 사용자를 대신하여 태스크를 수행하기 위해 맡는 IAM 역할입니다. IAM 관리자는 IAM 내에서 서비스 역할을 생성, 수정 및 삭제할 수 있습니다. 자세한 내용은 IAM 사용 설명서의 AWS 서비스에 대한 권한을 위임할 역할 생성을 참조하십시오.

  • 서비스 연결 역할 — 서비스 연결 역할은 에 연결된 서비스 역할의 한 유형입니다. AWS 서비스서비스는 사용자를 대신하여 작업을 수행하기 위해 역할을 수임할 수 있습니다. 서비스 연결 역할은 사용자에게 AWS 계정 표시되며 해당 서비스가 소유합니다. IAM 관리자는 서비스 링크 역할의 권한을 볼 수 있지만 편집은 할 수 없습니다.

• Amazon EC2에서 실행되는 애플리케이션 — IAM 역할을 사용하여 EC2 인스턴스에서 실행되고 API 요청을 AWS CLI 하는 애플리케이션의 임시 자격 증명을 관리할 수 있습니다. AWS 이는 EC2 인스턴스 내에 액세스 키를 저장할 때 권장되는 방법입니다. EC2 인스턴스에 AWS 역할을 할당하고 모든 애플리케이션에서 사용할 수 있게 하려면 인스턴스에 연결된 인스턴스 프로필을 생성합니다. 인스턴스 프로파일에는 역할이 포함되어 있으며 EC2 인스턴스에서 실행되는 프로그램이 임시 보안 인증을 얻을 수 있습니다. 자세한 내용은 IAM 사용 설명서의 IAM 역할을 사용하여 Amazon EC2 인스턴스에서 실행되는 애플리케이션에 권한 부여를 참조하십시오.

IAM 역할을 사용할지 또는 IAM 사용자를 사용할지를 알아보려면 IAM 사용 설명서의 IAM 역할(사용자 대신)을 생성하는 경우를 참조하십시오.

정책을 사용한 액세스 관리

정책을 생성하고 이를 AWS ID 또는 리소스에 AWS 연결하여 액세스를 제어할 수 있습니다. 정책은 ID 또는 리소스와 연결될 때 AWS 해당 권한을 정의하는 객체입니다. AWS 주도자 (사용자, 루트 사용자 또는 역할 세션) 가 요청할 때 이러한 정책을 평가합니다. 정책에서 권한은 요청이 허용되거나 거부되는 지를 결정합니다. 대부분의 정책은 JSON 문서로 AWS 저장됩니다. JSON 정책 문서의 구조와 콘텐츠에 대한 자세한 내용은 IAM 사용 설명서의 JSON 정책 개요를 참조하십시오.

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 보안 주체가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.

기본적으로, 사용자와 역할에는 어떠한 권한도 없습니다. 사용자에게 사용자가 필요한 리소스에서 작업을 수행할 권한을 부여하려면 IAM 관리자가 IAM 정책을 생성하면 됩니다. 그런 다음 관리자가 IAM 정책을 역할에 추가하고, 사용자가 역할을 수임할 수 있습니다.

IAM 정책은 작업을 수행하기 위해 사용하는 방법과 상관없이 작업에 대한 권한을 정의합니다. 예를 들어, iam:GetRole 작업을 허용하는 정책이 있다고 가정합니다. 해당 정책을 사용하는 사용자는 AWS Management Console, AWS CLI, 또는 AWS API에서 역할 정보를 가져올 수 있습니다.

보안 인증 기반 정책

ID 기반 정책은 IAM 사용자, 사용자 그룹 또는 역할과 같은 ID에 연결할 수 있는 JSON 권한 정책 문서입니다. 이러한 정책은 사용자와 역할이 어떤 리소스와 어떤 조건에서 어떤 태스크를 수행할 수 있는지를 제어합니다. ID 기반 정책을 생성하는 방법을 알아보려면 IAM 사용 설명서의 IAM 정책 생성을 참조하십시오.

보안 인증 기반 정책은 인라인 정책 또는 관리형 정책으로 한층 더 분류할 수 있습니다. 인라인 정책은 단일 사용자, 그룹 또는 역할에 직접 포함됩니다. 관리형 정책은 내 여러 사용자, 그룹 및 역할에 연결할 수 있는 독립형 정책입니다. AWS 계정관리형 정책에는 AWS 관리형 정책과 고객 관리형 정책이 포함됩니다. 관리형 정책 또는 인라인 정책을 선택하는 방법을 알아보려면 IAM 사용 설명서의 관리형 정책과 인라인 정책의 선택을 참조하십시오.

AWS CodeConnections 권한 참조

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

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

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

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

와일드카드 사용

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

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

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

연결 관리 권한

또는 SDK를 사용하여 연결을 보거나 만들거나 삭제하도록 지정된 역할 또는 사용자는 다음과 같은 권한으로 제한되어야 합니다. AWS CLI

참고

다음 권한만으로는 콘솔에서 연결을 완료하거나 사용할 수 없습니다. 연결을 완료하기 위한 권한의 권한을 추가해야 합니다.

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

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

AWS CodeConnections 연결 관리에 필요한 권한
AWS CodeConnections 액션	필요한 권한	리소스
CreateConnection	codeconnections:CreateConnection CLI 또는 콘솔을 사용하여 연결을 생성하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결-ID
DeleteConnection	codeconnections:DeleteConnection CLI 또는 콘솔을 사용하여 연결을 삭제하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
GetConnection	codeconnections:GetConnection CLI 또는 콘솔을 사용하여 연결에 대한 세부 정보를 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListConnections	codeconnections:ListConnections CLI 또는 콘솔을 사용하여 계정의 모든 연결을 나열하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID

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

작업	조건 키
codeconnections:CreateConnection	codeconnections:ProviderType
codeconnections:DeleteConnection	N/A
codeconnections:GetConnection	N/A
codeconnections:ListConnections	codeconnections:ProviderTypeFilter

호스트 관리를 위한 권한

또는 SDK를 사용하여 호스트를 보거나 만들거나 삭제하도록 지정된 역할 또는 사용자는 다음과 같이 제한된 권한을 가져야 합니다. AWS CLI

참고

다음 권한만으로는 호스트에서 연결을 완료하거나 사용할 수 없습니다. 호스트 설정에 대한 권한의 권한을 추가해야 합니다.

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

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

AWS CodeConnections 호스트 관리에 필요한 권한
AWS CodeConnections 조치	필요한 권한	리소스
CreateHost	codeconnections:CreateHost CLI 또는 콘솔을 사용하여 호스트를 생성하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정 ID:호스트/ 호스트 ID
DeleteHost	codeconnections:DeleteHost CLI 또는 콘솔을 사용하여 호스트를 삭제하는 데 필요합니다.	코드 연결: 지역: 계정 ID: 호스트/ 호스트 ID
GetHost	codeconnections:GetHost CLI 또는 콘솔을 사용하여 호스트에 대한 세부 정보를 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정 ID: 호스트/ 호스트 ID
ListHosts	codeconnections:ListHosts CLI 또는 콘솔을 사용하여 계정의 모든 호스트를 나열하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정 ID:호스트/ 호스트 ID

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

작업	조건 키
codeconnections:CreateHost	codeconnections:ProviderType
codeconnections:DeleteHost	N/A
codeconnections:GetHost	N/A
codeconnections:ListHosts	codeconnections:ProviderTypeFilter

연결을 완료하기 위한 권한

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

브라우저 기반 핸드셰이크를 수행하는 경우 콘솔에서 다음 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

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

AWS CodeConnections 연결을 완료하는 데 필요한 권한
AWS CodeConnections 액션	필요한 권한	리소스
GetIndividualAccessToken	codeconnections:GetIndividualAccessToken 콘솔을 사용하여 연결을 완료하는 데 필요합니다. IAM 정책 권한일 뿐, API 작업이 아닙니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결-ID
GetInstallationUrl	codeconnections:GetInstallationUrl 콘솔을 사용하여 연결을 완료하는 데 필요합니다. IAM 정책 권한일 뿐, API 작업이 아닙니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListInstallationTargets	codeconnections:ListInstallationTargets 콘솔을 사용하여 연결을 완료하는 데 필요합니다. IAM 정책 권한일 뿐, API 작업이 아닙니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
StartOAuthHandshake	codeconnections:StartOAuthHandshake 콘솔을 사용하여 연결을 완료하는 데 필요합니다. IAM 정책 권한일 뿐, API 작업이 아닙니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
UpdateConnectionInstallation	codeconnections:UpdateConnectionInstallation 콘솔을 사용하여 연결을 완료하는 데 필요합니다. IAM 정책 권한일 뿐, API 작업이 아닙니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID

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

작업	조건 키
codeconnections:GetIndividualAccessToken	codeconnections:ProviderType
codeconnections:GetInstallationUrl	codeconnections:ProviderType
codeconnections:ListInstallationTargets	N/A
codeconnections:StartOAuthHandshake	codeconnections:ProviderType
codeconnections:UpdateConnectionInstallation	codeconnections:InstallationId

호스트 설정에 대한 권한

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

브라우저 기반 호스트 등록을 수행할 때 콘솔에서 다음 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

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

AWS CodeConnections 호스트 설정을 완료하는 데 필요한 권한
연결 작업	필요한 권한	리소스
RegisterAppCode	codeconnections:RegisterAppCode 콘솔을 사용하여 호스트 설정을 완료하는 데 필요합니다. IAM 정책 권한일 뿐, API 작업이 아닙니다.	arn:AWS:코드 연결: 지역: 계정 ID:호스트/ 호스트 ID
StartAppRegistrationHandshake	codeconnections:StartAppRegistrationHandshake 콘솔을 사용하여 호스트 설정을 완료하는 데 필요합니다. IAM 정책 권한일 뿐, API 작업이 아닙니다.	arn:AWS:코드 연결: 지역: 계정 ID:호스트/ 호스트 ID

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

서비스에 연결 전달

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

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

AWS CodeConnections 연결 통과에 필요한 권한
AWS CodeConnections 액션	필요한 권한	리소스
PassConnection	codeconnections:PassConnection 서비스에 연결을 전달하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결-ID

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

• codeconnections:PassedToService

조건 키에 지원되는 값
키	유효한 작업 공급자
codeconnections:PassedToService	codeguru-reviewer codepipeline.amazonaws.com proton.amazonaws.com

연결 사용

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

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

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

AWS CodeConnections 연결 사용을 위한 필수 조치
AWS CodeConnections 액션	필요한 권한	리소스
UseConnection	codeconnections:UseConnection 연결을 사용하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결-ID

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

• codeconnections:BranchName

• codeconnections:FullRepositoryId

• codeconnections:OwnerId

• codeconnections:ProviderAction

• codeconnections:ProviderPermissionsRequired

• codeconnections:RepositoryName

조건 키에 지원되는 값
키	유효한 작업 공급자
codeconnections:FullRepositoryId	리포지토리의 사용자 이름과 리포지토리 이름(예: my-owner/my-repository)입니다. 특정 리포지토리에 액세스하는 데 연결을 사용하는 경우에만 지원됩니다.
codeconnections:ProviderPermissionsRequired	read_only 또는 read_write
codeconnections:ProviderAction	GetBranch, ListRepositories, ListOwners, ListBranches, StartUploadArchiveToS3, GitPush, GitPull, GetUploadArchiveToS3Status, CreatePullRequestDiffComment, GetPullRequest, ListBranchCommits, ListCommitFiles, ListPullRequestComments, ListPullRequestCommits. 자세한 내용은 다음 섹션을 참조하세요.

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

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

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

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

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

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

AWS CodeConnections 지원되는 액세스 유형 ProviderAction
AWS CodeConnections 권한	필요한 권한	리소스
GetBranch	codeconnections:GetBranch 해당 브랜치의 최신 커밋 등 브랜치에 대한 정보에 액세스하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결-ID
ListRepositories	codeconnections:ListRepositories 소유자에게 속한 퍼블릭 및 프라이빗 리포지토리 목록(해당 리포지토리에 대한 세부 정보 포함)에 액세스하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListOwners	codeconnections:ListOwners 연결에서 액세스할 수 있는 소유자 목록에 액세스하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListBranches	codeconnections:ListBranches 해당 리포지토리에 있는 브랜치 목록에 액세스하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
StartUploadArchiveToS3	codeconnections:StartUploadArchiveToS3 소스 코드를 읽고 Amazon S3에 업로드하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
GitPush	codeconnections:GitPush Git를 사용하여 리포지토리에 쓰는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
GitPull	codeconnections:GitPull Git를 사용하여 리포지토리에서 읽는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
GetUploadArchiveToS3Status	codeconnections:GetUploadArchiveToS3Status StartUploadArchiveToS3에서 시작한 업로드의 상태(관련 오류 메시지 포함)에 액세스하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
CreatePullRequestDiffComment	codeconnections:CreatePullRequestDiffComment 끌어오기 요청에 대한 설명에 액세스하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
GetPullRequest	codeconnections:GetPullRequest 리포지토리에 대한 끌어오기 요청을 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListBranchCommits	codeconnections:ListBranchCommits 리포지토리 브랜치에 대한 커밋 목록을 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListCommitFiles	codeconnections:ListCommitFiles 커밋에 대한 파일 목록을 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListPullRequestComments	codeconnections:ListPullRequestComments 끌어오기 요청에 대한 설명 목록을 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID
ListPullRequestCommits	codeconnections:ListPullRequestCommits 끌어오기 요청에 대한 커밋 목록을 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결 ID

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

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

codeconnections:ListTagsForResource
codeconnections:TagResource
codeconnections:UntagResource

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

AWS CodeConnections 연결 리소스에 태그를 지정하는 데 필요한 조치
AWS CodeConnections 작업	필요한 권한	리소스
ListTagsForResource	codeconnections:ListTagsForResource 연결 리소스와 연결된 태그의 목록을 보는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정-ID:연결/ 연결-ID , arn:AWS:코드 연결: 지역: 계정 ID:호스트/ 호스트 ID
TagResource	codeconnections:TagResource 연결 리소스를 태깅하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정 ID:연결/ 연결 ID , arn:AWS:코드 연결: 지역: 계정 ID:호스트/ 호스트 ID
UntagResource	codeconnections:UntagResource 연결 리소스에서 태그를 제거하는 데 필요합니다.	arn:AWS:코드 연결: 지역: 계정 ID:연결/ 연결 ID , arn:AWS:코드 연결: 지역: 계정 ID:호스트/ 호스트 ID

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

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

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

AWS CodeConnections 연결 전달에 필요한 권한
AWS CodeConnections 액션	필요한 권한	리소스
PassRepository	codeconnections:PassRepository 리포지토리 링크를 동기화 구성에 전달하는 데 필요합니다.	arn:aws:코드 연결: 지역: 계정 ID: 리포지토리 링크/ repository-link-id

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

• codeconnections:PassedToService

조건 키에 지원되는 값
키	유효한 작업 공급자
codeconnections:PassedToService	cloudformation.sync.codeconnections.amazonaws.com

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

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

• codeconnections:Branch

  요청에서 전달되는 브랜치 이름을 기준으로 액세스를 필터링합니다.

조건 키에 지원되는 작업
키	유효값
codeconnections:Branch	이 조건 키에는 다음 작업이 지원됩니다. CreateSyncConfiguration UpdateSyncConfiguration GetRepositorySyncStatus

콘솔에서 알림 및 연결 사용

알림 환경은 개발자 도구 콘솔의 CodeBuild 설정 탐색 표시줄 자체뿐만 아니라,,, 콘솔에도 기본 CodePipeline 제공됩니다. CodeCommit CodeDeploy 콘솔의 알림에 액세스하려면 해당 서비스에 대한 관리형 정책 중 하나가 적용되었거나 최소 권한 집합이 있어야 합니다. 이러한 권한을 통해 계정의 AWS CodeStar 알림 및 AWS CodeConnections 리소스에 대한 세부 정보를 나열하고 볼 수 AWS 있어야 합니다. 최소 필수 권한보다 더 제한적인 보안 인증 기반 정책을 만들면 콘솔이 해당 정책에 연결된 개체(IAM 사용자 또는 역할)에 대해 의도대로 작동하지 않습니다. AWS CodeBuild, AWS CodeCommit AWS CodeDeploy AWS CodePipeline, 및 콘솔에 대한 액세스 권한을 부여하는 방법 (해당 콘솔에 대한 액세스 권한 포함) 에 대한 자세한 내용은 다음 항목을 참조하십시오.

• CodeBuild: ID 기반 정책 사용 대상 CodeBuild

• CodeCommit: ID 기반 정책 사용 대상 CodeCommit

• AWS CodeDeploy: ID 및 액세스 관리 대상 AWS CodeDeploy

• CodePipeline: IAM 정책을 통한 액세스 제어

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

• 예: 알림 관리를 위한 관리자 수준의 정책 AWS CodeStar

• 예: 알림 사용에 대한 기여자 수준의 정책 AWS CodeStar

• 예: AWS CodeStar 알림 사용 read-only-level 정책.

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

자세한 내용은 다음 자료를 참조하십시오.

• 예: 관리를 위한 관리자 수준의 정책 AWS CodeConnections

• 예: 사용을 위한 기여자 수준의 정책 AWS CodeConnections

• 예: 사용에 대한 read-only-level 정책 AWS CodeConnections

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": "*"
        }
    ]
}