AWS CodeCommit에 대한 인증 및 액세스 제어 - AWS CodeCommit
인증액세스 제어액세스 관리 개요

AWS CodeCommit 는 더 이상 신규 고객이 사용할 수 없습니다. AWS CodeCommit 의 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세히 알아보기

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

AWS CodeCommit에 대한 인증 및 액세스 제어

에 액세스하려면 자격 증명이 AWS CodeCommit 필요합니다. 이러한 자격 증명에는 Git 자격 증명 또는 Git 연결을 만드는 데 사용하는 SSH 퍼블릭 키를 관리하는 데 사용하는 CodeCommit 리포지토리 및 IAM 사용자와 같은 AWS 리소스에 액세스할 수 있는 권한이 있어야 합니다. 다음 섹션에서는 AWS Identity and Access Management (IAM) 및 CodeCommit을 사용하여 리소스에 대한 액세스를 보호할 수 있는 방법에 대해 세부 정보를 제공합니다.

인증

CodeCommit 리포지토리는 Git 기반이며 Git 보안 인증 정보를 비롯하여 기본적인 Git 기능을 지원하므로, CodeCommit 작업 시 IAM 사용자를 사용하는 것이 좋습니다. 다른 자격 증명 유형을 사용하여 CodeCommit에 액세스할 수도 있지만, 다른 자격 증명 유형은 아래 설명과 같이 제한적일 수 있습니다.

자격 증명 유형:

  • IAM 사용자 – IAM 사용자는 특정 사용자 지정 권한을 보유한 Amazon Web Services 계정 내의 자격 증명입니다. 예를 들어, IAM 사용자에는 CodeCommit 리포지토리에 액세스하는 데 필요한 Git 보안 인증 정보를 생성 및 관리할 권한이 있을 수 있습니다. CodeCommit 작업용으로 권장되는 사용자 유형입니다. IAM 사용자 이름과 암호를 사용하여 AWS Management 콘솔, AWS 토론 포럼 또는 AWS Support 센터와 같은 보안 AWS 웹 페이지에 로그인할 수 있습니다.

    Git 보안 인증 정보를 생성하거나 SSH 퍼블릭 키를 IAM 사용자와 연결하거나 git-remote-codecommit를 설치 및 구성할 수 있습니다. 이 방법들은 CodeCommit 리포지토리 작업용으로 Git을 설정하는 가장 쉬운 방법입니다. Git 보안 인증 정보를 사용하여 IAM에서 정적 사용자 이름 및 암호를 생성합니다. 그런 다음 Git 사용자 이름 및 암호 인증을 지원하는 Git 및 타사 도구에서 HTTPS 연결용으로 이러한 보안 인증 정보를 사용합니다. SSH 연결을 사용하여 Git 및 CodeCommit에서 SSH 인증에 사용하는 퍼블릭 및 프라이빗 키 파일을 로컬 시스템에서 생성합니다. 퍼블릭 키를 IAM 사용자와 연결하면 로컬 컴퓨터에 프라이빗 키를 저장합니다. git-remote-codecommit는 Git 자체를 확장하며 사용자에 대한 Git 보안 인증 정보를 설정할 필요가 없습니다.

    또한 각 사용자마다 액세스 키를 생성할 수도 있습니다. AWS SDKs 중 하나를 통해 또는 AWS Command Line Interface (AWS CLI)를 사용하여 프로그래밍 방식으로 AWS 서비스에 액세스할 때 액세스 키를 사용합니다. SDK 및 CLI 도구는 액세스 키를 사용하여 요청에 암호화 방식으로 서명합니다. AWS 도구를 사용하지 않는 경우 요청에 직접 서명해야 합니다. CodeCommit은 인바운드 API 요청을 인증하기 위한 프로토콜인 서명 버전 4를 지원합니다. 요청 인증에 대한 자세한 내용은 https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html의AWS 일반 참조서명 버전 4 서명 프로세스를 참조하세요.

  • Amazon Web Services 계정 루트 사용자 - 가입 AWS할 때 Amazon Web Services 계정과 연결된 이메일 주소와 암호를 제공합니다. 이 두 가지가 루트 보안 인증 정보이며 모든 AWS 리소스에 대한 전체 액세스 권한을 제공합니다. 일부 CodeCommit 기능은 루트 계정 사용자에게 사용할 수 없습니다. 또한 루트 계정에서 Git을 사용하는 유일한 방법은에 포함된 보안 AWS 인증 도우미를 설치 및 구성git-remote-codecommit(권장)하거나 구성하는 것입니다 AWS CLI. Git 보안 인증 정보나 SSH 퍼블릭-프라이빗 키 페어는 루트 계정 사용자와 함께 사용할 수 없습니다. 이러한 이유로 CodeCommit과 상호 작용 시 루트 계정 사용자를 사용하지 않는 것이 좋습니다.

    중요

    보안상 관리자 사용자, 즉 AWS 계정에 대한 전체 권한이 있는 IAM 사용자를 만들 때만 루트 보안 인증 정보를 사용하는 것이 좋습니다. 그런 다음 이 관리자 사용자를 사용하여 제한된 권한이 있는 다른 IAM 사용자 및 역할을 만들 수 있습니다. 자세한 내용은 IAM 사용 설명서에서 IAM 모범 사례 및 관리자 사용자 및 그룹 생성을 참조하세요.

  • IAM Identity Center 및 IAM Identity Center의 사용자 - AWS IAM Identity Center 는의 기능을 확장 AWS Identity and Access Management 하여 사용자 관리와 및 AWS 계정 클라우드 애플리케이션에 대한 액세스를 통합하는 중앙 위치를 제공합니다. AWS를 사용하는 대부분의 사용자에게 모범 사례로 권장되지만, IAM Identity Center는 현재 Git 보안 인증 정보 또는 SSH 키 페어에 대한 메커니즘을 제공하지 않습니다. 이 사용자들은 git-remote-codecommit을 설치하고 구성하여 CodeCommit 리포지토리를 로컬로 복제할 수 있지만, 모든 IDE (통합 개발 환경)가 git-remote-codecommit을 사용한 복제, 푸시 또는 풀링을 지원하는 것은 아닙니다.

    가장 좋은 방법은 인간 사용자에게 자격 증명 공급자와의 페더레이션을 사용하여 임시 자격 증명을 AWS 서비스 사용하여에 액세스하도록 요구하는 것입니다.

    페더레이션 자격 증명은 엔터프라이즈 디렉터리, 웹 자격 증명 공급자 또는 자격 증명 소스의 자격 증명을 AWS 서비스 사용하여 Directory Service 에 액세스하는 사용자입니다. 페더레이션 자격 증명은 임시 자격 증명을 제공하는 역할을 수임합니다.

    중앙 집중식 액세스 관리의 경우를 사용하는 것이 좋습니다 AWS IAM Identity Center. 자세한 정보는 AWS IAM Identity Center 사용 설명서의 IAM Identity Center란 무엇인가요? 섹션을 참조하세요.

  • IAM 역할 – IAM 사용자와 마찬가지로, IAM 역할은 특정 권한을 부여하기 위해 계정에서 생성할 수 있는 IAM 자격 증명입니다.

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

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

    참고

    Git 보안 인증 정보나 SSH 퍼블릭 키 페어는 페더레이션 사용자와 함께 사용할 수 없습니다. 또한 페더레이션 사용자에는 사용자 기본 설정을 사용할 수 없습니다. 페더레이션 액세스를 사용하여 연결을 설정하는 방법에 대한 자세한 내용은 git-remote-codecommit을 AWS CodeCommit 사용하여에 HTTPS 연결을 위한 설정 단계 단원을 참조하세요.

액세스 제어

요청을 인증하는 데 유효한 보안 인증 정보가 있더라도 권한이 없다면 CodeCommit 리소스를 생성하거나 액세스할 수 없습니다. 예를 들면 리포지토리 보기, 코드 푸시, Git 보안 인증 정보 생성 및 관리 등의 작업을 수행할 수 있는 권한이 있어야 합니다.

다음 단원에서는 CodeCommit에 대한 권한을 관리하는 방법에 대해 설명합니다. 먼저 개요를 읽어 보면 도움이 됩니다.

CodeCommit 리소스에 대한 액세스 권한 관리 개요

모든 AWS 리소스는 Amazon Web Services 계정이 소유합니다. 리소스를 생성하고 액세스할 수 있는 권한은 권한 정책에서 관리합니다. 계정 관리자는 IAM 자격 증명(사용자, 그룹 및 역할)에 권한 정책을 연결할 수 있습니다. 와 같은 일부 서비스는 리소스에 권한 정책 연결 AWS Lambda도 지원합니다.

참고

계정 관리자 또는 관리자 사용자는 관리자 권한이 있는 사용자입니다. 자세한 설명은 IAM 사용자 가이드의 IAM 모범 사례 섹션을 참조하십시오.

권한을 부여하려면 권한을 부여 받을 사용자, 권한 대상이 되는 리소스, 해당 리소스에 허용되는 특정 작업을 결정합니다.

CodeCommit 리소스 및 작업

CodeCommit에서는 리포지토리가 기본 리소스입니다. 각 리소스에는 관련된 고유 Amazon 리소스 이름(ARN)이 있습니다. 정책에서 Amazon 리소스 이름(ARN)을 사용하여 정책이 적용되는 리소스를 식별합니다. ARN에 대한 자세한 내용은 Amazon Web Services 일반 참조에서 Amazon 리소스 이름(ARN) 및 AWS 서비스 네임스페이스를 참조하세요. CodeCommit은 현재 하위 리소스라고도 하는 다른 리소스 유형을 지원하지 않습니다.

다음 표에서는 CodeCommit 리소스를 지정하는 방법에 대해 설명합니다.

리소스 유형 ARN 형식
리포지토리

arn:aws:codecommit:region:account-id:repository-name

모든 CodeCommit 리포지토리

arn:aws:codecommit:*

지정된 계정에서 소유한 모든 CodeCommit 리포지토리 AWS 리전

arn:aws:codecommit:region:account-id:*
참고

대부분의 AWS 서비스는 ARNs로 취급합니다. 하지만 CodeCommit에서는 리소스 패턴 및 규칙에 정확히 일치하는 항목이 있어야 합니다. 이벤트 패턴을 만들 때 리소스에서 ARN 구문이 일치하도록 정확한 문자를 사용해야 합니다.

예를 들어 명령문에서 다음과 같이 ARN을 사용하여 특정 리포지토리(MyDemoRepo)를 나타낼 수 있습니다.

"Resource": "arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo"

특정 계정에 속하는 모든 리포지토리를 지정하려면 다음과 같이 와일드카드 문자(*)를 사용합니다.

"Resource": "arn:aws:codecommit:us-west-2:111111111111:*"

모든 리소스를 지정해야 하거나 특정 API 작업이 ARN을 지원하지 않는 경우 다음과 같이 Resource 요소에 와일드카드 문자(*)를 사용합니다.

"Resource": "*"

와일드카드 문자(*)를 사용하여 리포지토리 이름의 일부와 일치하는 모든 리소스를 지정할 수도 있습니다. 예를 들어, 다음 ARN은 이름이 MyDemo로 시작하며 us-east-2 AWS 리전의 Amazon Web Services 계정 111111111111에 등록된 CodeCommit 리포지토리를 지정합니다.

arn:aws:codecommit:us-east-2:111111111111:MyDemo*

CodeCommit 리소스로 작동하는 사용 가능한 작업의 목록은 CodeCommit 권한 참조 섹션을 참조하세요.

리소스 소유권 이해

Amazon Web Services 계정은 리소스 생성자와 상관없이 계정에서 생성된 리소스를 소유합니다. 인라인 정책을 포함하면 해당 정책의 권한이 잘못된 보안 주체 엔터티에 실수로 추가되는 일을 예방할 수 있습니다. 다음의 예제에서는 이러한 작동 방법을 설명합니다.

  • Amazon Web Services 계정에서 IAM 사용자를 생성하고 CodeCommit 리소스를 생성할 수 있는 권한을 해당 사용자에게 부여하면 해당 사용자는 CodeCommit 리소스를 생성할 수 있습니다. 하지만 해당 사용자가 속한 Amazon Web Services 계정이 CodeCommit 리소스를 소유합니다.

  • Amazon Web Services 계정의 루트 계정 보안 인증 정보를 사용하여 규칙을 생성하면, Amazon Web Services 계정이 CodeCommit 리소스의 소유자가 됩니다.

  • Amazon Web Services 계정에서 CodeCommit 리소스를 생성할 권한이 있는 IAM 역할을 만드는 경우, 해당 역할을 담당할 수 있는 사람은 누구나 CodeCommit 리소스를 생성할 수 있습니다. 이 경우 역할이 속한 Amazon Web Services 계정이 CodeCommit 리소스를 소유합니다.

리소스 액세스 관리

AWS 리소스에 대한 액세스를 관리하려면 권한 정책을 사용합니다. 권한 정책은 누가 무엇에 액세스할 수 있는지를 나타냅니다. 다음 단원에서는 권한 정책을 만드는 데 옵션에 대해 설명합니다.

참고

이 섹션에서는 CodeCommit의 맥락에서 IAM을 사용하는 방법에 대해 설명하며, IAM 서비스에 대한 자세한 정보는 다루지 않습니다. IAM에 대한 자세한 내용은 IAM 사용 설명서의 IAM이란 무엇입니까? 단원을 참조하세요. IAM 정책 구문과 설명에 대한 자세한 내용은 IAM 사용 설명서의 IAM 정책 참조 섹션을 참조하세요.

자격 증명 기반 정책(IAM 정책)이라고 하는 IAM 자격 증명에 연결된 권한 정책입니다. 리소스에 연결된 권한 정책을 리소스 기반 정책이라고 합니다. 현재 CodeCommit은 자격 증명 기반 정책(IAM 정책)만 지원합니다.

자격 증명 기반 정책(IAM 정책)

AWS 리소스에 대한 액세스를 관리하려면 IAM 자격 증명에 권한 정책을 연결합니다. CodeCommit에서 자격 증명 기반 정책을 사용하여 리포지토리에 대한 액세스 권한을 관리합니다. 예를 들어, 다음을 수행할 수 있습니다.

  • 계정 내 사용자 또는 그룹에 권한 정책 연결 – CodeCommit 콘솔에서 CodeCommit 리소스를 볼 수 있는 사용자 권한을 부여하려면 자격 증명 권한 정책을 사용자 또는 사용자가 속하는 그룹에 연결합니다.

  • 권한 정책을 역할에 연결(크로스 계정 권한을 부여하기 위해) – 위임(크로스 계정 액세스를 부여하려는 경우 등). 위임하려면 리소스에 속하는 계정(트러스트 계정)과 해당 리소스에 액세스해야 하는 사용자를 포함하는 계정(신뢰 계정) 간의 신뢰를 구축해야 합니다. 권한 정책은 역할 사용자에게 리소스에 대해 의도한 작업을 수행하는 데 필요한 권한을 부여합니다. 신뢰 정책은 어느 신뢰받는 계정이 사용자에게 해당 역할을 위임할 권한을 부여하도록 허용할지 지정합니다. 자세한 내용은 IAM 용어 및 개념을 참조하세요.

    크로스 계정 권한을 부여하려면 자격 증명 기반 권한 정책을 IAM 역할에 연결합니다. 예를 들어 계정 A의 관리자는 다음과 같이 다른 Amazon Web Services 계정(예: 계정 B) 또는 AWS 서비스에 교차 계정 권한을 부여하는 역할을 생성할 수 있습니다.

    1. 계정 A 관리자는 IAM 역할을 생성하고 계정 A의 리소스에 대한 권한을 부여하는 역할에 권한 정책을 연결합니다.

    2. 계정 A 관리자는 계정 B를 역할을 수임할 보안 주체로 식별하는 역할에 신뢰 정책을 연결합니다.

    3. 그런 다음 계정 B 관리자는 계정 B의 사용자에게 역할을 수임할 수 있는 권한을 위임할 수 있습니다. 이렇게 하면 계정 B의 사용자가 계정 A에서 리소스를 생성하거나 액세스할 수 있습니다. 역할을 수임할 수 있는 AWS 서비스 권한을 부여하려면 신뢰 정책의 보안 주체도 서비스 보안 주체가 AWS 될 수 있습니다. 자세한 내용은 IAM 용어 및 개념을 참조하세요.

    IAM을 사용하여 권한을 위임하는 방법에 대한 자세한 내용은 IAM 사용자 설명서의 액세스 관리를 참조하세요.

다음 예제 정책에서는 사용자가 MyDemoRepo라는 리포지토리에서 브랜치를 생성하도록 허용합니다.

JSON
{
  "Version":"2012-10-17",		 	 	 
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codecommit:CreateBranch"
      ],
      "Resource" : "arn:aws:codecommit:us-east-2:111122223333:MyDemoRepo"
    }
  ]
}

계정의 사용자가 액세스할 수 있는 호출 및 리소스를 제한하려면 특정 IAM 정책을 생성하고 나서 IAM 사용자에 이러한 정책을 연결합니다. IAM 역할 생성 방법 및 CodeCommit용 IAM 정책 명령문 예제를 살펴보는 방법에 대한 자세한 내용은 고객 관리형 자격 증명 정책 예 단원을 참조하세요.

리소스 기반 정책

Amazon S3와 같은 일부 서비스는 리소스 기반 권한 정책도 지원합니다. 예를 들어, 리소스 기반 정책을 S3 버킷에 연결하여 해당 버킷에 대한 액세스 권한을 관리할 수 있습니다. CodeCommit은 리소스 기반 정책을 지원하지 않지만, 태그를 사용하여 리소스를 식별한 다음 IAM 정책에서 사용할 수 있습니다. 태그 기반 정책의 예제는 자격 증명 기반 정책(IAM 정책) 단원을 참조하세요.

CodeCommit에서 리소스 범위 지정

CodeCommit에서는 CodeCommit 리소스 및 작업에 설명된 대로 자격 증명 기반 정책 및 권한의 범위를 리소스로 지정할 수 있습니다. 하지만 ListRepositories 권한의 범위를 리소스 하나로 지정할 수는 없습니다. 대신에 모든 리소스로 범위를 지정할 수 있습니다(* 와일드카드 사용). 그렇지 않으면 작업이 실패합니다.

다른 모든 CodeCommit 권한은 범위를 리소스로 지정할 수 있습니다.

정책 요소 지정: 리소스, 작업, 효과 및 보안 주체

사용자의 리소스 액세스를 허용 또는 거부하는 정책을 만들거나 사용자가 해당 리소스에서 특정 작업을 수행하도록 허용 또는 거부하는 정책을 만들 수 있습니다. CodeCommit은 사용자가 CodeCommit 콘솔, SDKs, AWS CLI를 통해 또는 해당 API를 직접 호출하여 서비스를 사용하는 방법을 정의하는 퍼블릭 APIs 작업 세트를 정의합니다. 이러한 API 작업에 대한 권한을 부여하기 위해 CodeCommit에서는 정책에서 지정할 수 있는 작업을 정의합니다.

일부 API 작업은 두 가지 이상의 작업에 대한 권한이 필요합니다. 리소스 및 API 작업에 대한 자세한 설명은 CodeCommit 리소스 및 작업 및 CodeCommit 권한 참조 섹션을 참조하십시오.

다음은 정책의 기본 요소입니다:

  • 리소스 – Amazon 리소스 이름(ARN)을 사용하여 정책을 적용할 리소스를 식별합니다. 자세한 내용은 CodeCommit 리소스 및 작업 단원을 참조하십시오.

  • 작업 – 작업 키워드를 사용하여 허용 또는 거부할 리소스 작업을 식별합니다. 예를 들면 지정한 Effect에 따라 codecommit:GetBranch 권한은 사용자에게 GetBranch 작업(CodeCommit 리포지토리에서 브랜치에 대한 세부 정보를 가져옴)을 수행하도록 허용하거나 거부합니다.

  • 효과 – 사용자가 특정 작업을 요청할 때 발생되는 결과(허용 또는 거부)를 지정합니다. 명시적으로 리소스에 대한 액세스 권한을 부여(허용)하지 않는 경우, 액세스는 묵시적으로 거부됩니다. 다른 정책에서 액세스 권한을 부여하는 경우라도 사용자가 해당 리소스에 액세스할 수 없도록 하기 위해 리소스에 대한 권한을 명시적으로 거부할 수도 있습니다.

  • 보안 주체 – 자격 증명 기반 정책(IAM 정책)에서 CodeCommit가 해당 자격 증명이 연결된 사용자를 지원하는 유일한 정책 유형은 암시적 보안 주체입니다.

IAM 정책 구문에 대한 자세한 내용은 IAM 사용 설명서의 IAM 정책 참조 섹션을 참조하세요.

모든 CodeCommit API 작업과 해당 작업이 적용되는 리소스를 보여주는 표는 CodeCommit 권한 참조 섹션을 참조하세요.

정책에서 조건 지정

권한을 부여할 때 IAM에 대한 액세스 정책 언어를 사용하여 정책이 적용될 조건을 지정합니다. 예를 들어, 특정 날짜 이후에만 정책을 적용할 수 있습니다. 정책 언어에서의 조건 지정에 관한 자세한 내용은 IAM 사용 설명서의 조건 및 정책 문법을 참조하세요.

조건을 표시하려면 미리 정의된 조건 키를 사용합니다. CodeCommit에만 해당되는 특정한 조건 키는 없습니다. 그러나 필요에 따라 사용할 수 있는 AWS전체 조건 키가 있습니다. AWS전체 키의 전체 목록은 IAM 사용 설명서의 조건에 사용 가능한 키를 참조하세요.