

Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

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

# CodeCatalyst 설정 및 로그인
<a name="setting-up-topnode"></a>

CodeCatalyst에서는 두 가지 유형의 스페이스를 설정할 수 있습니다. 하나는 AWS Builder ID 사용자를 지원하는 스페이스이며, 다른 하나는 IAM Identity Center에서 SSO 사용자 및 그룹을 관리하는 ID 페더레이션을 지원하는 스페이스입니다. AWS Builder ID 스페이스의 사용자는 자신의 AWS Builder ID로 CodeCatalyst에 로그인하고, ID 페더레이션을 위해 설정된 스페이스의 사용자는 해당 스페이스와 연결된 회사의 SSO 포털을 사용하여 CodeCatalyst에 로그인합니다.

**참고**  
CodeCatalyst 사용자 이름의 최소 길이는 3자, 최대 길이는 100자입니다. 100자보다 긴 제공된 사용자 이름은 잘립니다. 이로 인해 사용자 이름이 다른 100자 길이의 사용자 이름과 중복되는 것처럼 보일 수 있습니다. 자세한 내용은 [사용자 이름이 잘려서 새 사용자로 BID 스페이스에 액세스할 수 없거나 새 SSO 사용자로 추가할 수 없습니다](troubleshooting.md#troubleshoot-username-truncated) 섹션을 참조하세요.

AWS Builder ID 스페이스를 설정하고 관리하는 단계는 이 안내서에 나와 있습니다. CodeCatalyst AWS Builder ID 스페이스를 사용하려면, CodeCatalyst에 로그인하는 데 사용하는 사용자 설정 및 AWS Builder ID를 사용하여 CodeCatalyst를 설정합니다.

ID 페더레이션을 지원하는 스페이스를 설정하고 관리하는 단계는 *CodeCatalyst 관리자 안내서*에 나와 있습니다. ID 페더레이션을 위해 설정된 스페이스로 작업하려면, Amazon CodeCatalyst 관리자 안내서의 [CodeCatalyst 스페이스 설정 및 관리](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/what-is.html)를 참조하세요.

이 섹션에서는 AWS Builder ID 스페이스를 사용하여 Amazon CodeCatalyst에서 작동하도록 설정하는 두 가지 일반적인 경로, 즉 스페이스와 프로젝트를 첫 번째 사용자로서 생성하는 경로와 기존 스페이스 또는 프로젝트에 대한 초대를 수락하는 경로를 제공합니다. 이러한 설정 워크플로에는 반드시 큰 차이가 나타날 수 밖에 없습니다. 다음 다이어그램은 다음과 같이 두 가입 프로세스를 보여줍니다.

1. 첫 번째 경우에는 회사, 팀 또는 그룹을 위한 스페이스를 생성 및 설정하고, 이러한 리소스에 다른 사람을 초대하기 전에 프로젝트를 생성합니다. 청구를 위해 AWS 계정을 제공해야 합니다. 이 경우 여전히 프리 티어를 기본값으로 설정할 수 있습니다.

1. 두 번째 경우 프로젝트 초대를 수락하여 CodeCatalyst에 가입하면 다른 사람이 이미 생성한 스페이스와 프로젝트가 있습니다. 하지만, 프로파일을 구성해 다른 사용자와 작업을 시작할 준비해야 합니다.

![\[가입하고 멤버를 초대할 수 있는 스페이스를 생성합니다.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/sign-up-types.png)


**작은 정보**  
CodeCatalyst는 스페이스를 사용하여 프로젝트와 리소스를 그룹화합니다. CodeCatalyst에 처음 가입하면 프로젝트뿐만 아니라 스페이스를 생성하라는 메시지가 표시됩니다.

스페이스 및 프로젝트를 생성하기 위해 가입하든 초대 수락 과정으로 가입하든 상관 없이 CodeCatalyst에 로그인하는 데 사용할 AWS Builder ID를 생성합니다. AWS Builder ID를 생성하려면 AWS 애플리케이션에 로그인하는 데 사용하는 전체 이름, 암호 및 이메일 주소를 입력합니다. 이 시점 이후에는 이메일과 암호를 사용하여 CodeCatalyst에 로그인합니다. 이 AWS Builder ID를 사용하여 AWS Builder ID 자격 증명을 사용하는 다른 애플리케이션에 로그인할 수도 있습니다.

CodeCatalyst 및 AWS Builder ID에서 *프로파일*은 로그인 정보를 기반으로 생성됩니다. 프로파일에는 CodeCatalyst 프로젝트의 언어 및 알림 설정에 대한 CodeCatalyst 기본 설정이 포함되어 있습니다.

**작은 정보**  
Amazon CodeCatalyst 프로파일에 가입하는 동안 문제가 발생하면 해당 페이지에 제공된 단계를 따르세요. 추가 도움이 필요한 경우 [가입 문제](ipa-troubleshooting.md#id-troubleshooting-sign-up) 섹션을 참조하세요.

**Topics**
+ [새 스페이스 및 개발 역할 생성(초대 없이 시작)](sign-up-create-resources.md)
+ [초대 수락 및 AWS Builder ID 생성](sign-up-sign-in.md)
+ [AWS Builder ID로 로그인](id-how-to-sign-in.md)
+ [SSO로 로그인](sign-in-sso.md)
+ [사용자의 모든 스페이스 및 프로젝트 보기](home.md)
+ [CodeCatalyst 프로파일 보기 및 관리](view-profiles.md)
+ [CodeCatalyst AWS CLI 에서를 사용하도록 설정](set-up-cli.md)

# 새 스페이스 및 개발 역할 생성(초대 없이 시작)
<a name="sign-up-create-resources"></a>

기존 스페이스 또는 프로젝트에 초대하지 않고도 Amazon CodeCatalyst에 가입할 수 있습니다. 이렇게 하면 AWS Builder ID를 생성한 후 스페이스와 프로젝트를 생성합니다. 스페이스 생성의 일환으로 AWS 계정 결제 목적으로를 추가해야 합니다.

**작은 정보**  
Amazon CodeCatalyst 프로파일에 가입하는 동안 문제가 발생하면 해당 페이지에 제공된 단계를 따르세요. 추가 도움이 필요한 경우 [가입 문제](ipa-troubleshooting.md#id-troubleshooting-sign-up) 섹션을 참조하세요.

다음은 프로젝트 또는 스페이스에 대한 초대 없이 CodeCatalyst로 시작하는 사용자에게 가능한 흐름 중 하나입니다.

Mary Major는 CodeCatalyst에 관심이 있는 개발자로, CodeCatalyst를 사용해 보기로 결정합니다. 그는 CodeCatalyst 콘솔로 이동하여, 등록하고 AWS Builder ID를 생성하는 옵션을 선택합니다. Mary는 이메일 주소와 암호를 제공하여 AWS Builder ID를 생성합니다. AWS Builder ID를 사용하여 CodeCatalyst 및 기타 애플리케이션에 로그인할 수 있습니다. 별칭을 선택하라는 메시지가 표시되면 `MaryMajor`을 CodeCatalyst에 표시될 CodeCatalyst 사용자 이름으로 지정하고 다른 프로젝트 멤버가 @mention Mary에 사용할 수 있도록 지정합니다.

다음으로 Mary는 자동으로 스페이스를 생성하라는 지시를 받습니다. 이 흐름의 일환으로 Mary는 첫 번째 프로젝트 빌드 및 배포에서 샘플 코드를 볼 수 있도록를 생성하는 AWS 계정 공간과 연결하라는 요청을 받습니다. 그는 해당 정보를 추가하고 스페이스를 생성하여 새 스페이스의 프로젝트에 사용할 수 있는 미리 보기 개발 역할을 생성하는 옵션을 선택합니다. Mary는 프로젝트를 생성하기로 선택한 다음 프로젝트의 블루프린트 목록을 봅니다. 사용 가능한 블루프린트에 대한 정보를 검토한 후, 첫 번째 프로젝트에 대한 **최신 3계층 웹 애플리케이션** 블루프린트를 사용해 보기로 결정합니다. Mary는 필수 필드를 작성하고 프로젝트를 생성합니다. 프로젝트가 준비되자마자 Mary는 최근 활동뿐만 아니라 프로젝트 코드에 대한 링크와 해당 코드를 자동으로 빌드하고 배포하는 워크플로가 포함된 프로젝트 요약 페이지로 이동합니다. 배포된 샘플 웹 애플리케이션을 보는 것을 포함하여 코드와 워크플로를 모두 살펴봅니다. Mary는 자신이 본 것을 마음에 들어 CodeCatalyst 탐색을 시작하기 위해 프로젝트에 동료를 초대하기로 결정합니다.

잠시 시간이 되면 Mary는 멀티 팩터 인증(MFA)을 사용하여 CodeCatalyst에 로그인하도록 AWS Builder ID를 구성합니다. MFA를 구성하면 Mary는 CodeCatalyst 암호와 승인된 타사 인증 앱의 암호 또는 토큰을 조합하여 CodeCatalyst에 로그인할 수 있습니다.

## 새 스페이스 및 IAM 역할 생성
<a name="sign-up-first"></a>

이 단계에 따라 Amazon CodeCatalyst 프로파일에 가입하고, 스페이스를 만들고, 스페이스에 대한 계정, 지원 역할, 개발자 역할을 추가합니다.

최종 절차에서는 개발자 역할을 생성하고 추가합니다. 개발자 역할은 CodeCatalyst 워크플로가 AWS AWS 리소스에 액세스할 수 있도록 하는 IAM 역할입니다. 개발자 역할은를 관리하는 데 사용되는 서비스 역할이며 로그인한 계정에서 AWS 서비스 생성됩니다. 서비스 역할은 서비스가 사용자를 대신하여 작업을 수행하는 것으로 가정하는 [IAM 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)입니다. IAM 관리자는 IAM 내에서 서비스 역할을 생성, 수정 및 삭제할 수 있습니다. 역할에는 `CodeCatalystWorkflowDevelopmentRole-spaceName` 이름이 있습니다. 역할 및 역할 정책에 대한 자세한 내용은 [**CodeCatalystWorkflowDevelopmentRole-*spaceName*** 서비스 역할 이해](ipa-iam-roles.md#ipa-iam-roles-service-role) 섹션을 참조하세요.

**참고**  
보안 모범 사례는 스페이스의 AWS 리소스에 대한 액세스를 관리해야 하는 관리 사용자 및 개발자에게만 관리 액세스 권한을 할당하는 것입니다.

시작하기 전에 관리 권한이 있는 계정의 AWS 계정 ID를 제공할 준비가 되어 있어야 합니다. 12자리 AWS 계정 ID를 준비합니다. AWS 계정 ID 찾기에 대한 자세한 내용은 [AWS 계정 ID 및 해당 별칭을 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html).

**새 사용자 등록**

1. CodeCatalyst 콘솔에서 시작하기 전에를 열고 AWS Management Console스페이스를 생성하는 데 사용할 AWS 계정 것과 동일한 로 로그인했는지 확인합니다.

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 시작 페이지에서 **가입**을 선택합니다. ** AWS Builder ID 만들기** 페이지가 표시됩니다. AWS Builder ID는 로그인하기 위해 생성한 자격 증명입니다. 와 동일하지 않습니다 AWS 계정.

1. **이메일 주소**에 CodeCatalyst에 연결하여 사용하려는 이메일 주소를 입력합니다. 그리고 **다음**을 선택합니다.

1. **이름**에 AWS Builder ID를 사용하는 애플리케이션에 표시할 이름과 성을 입력합니다. 공백을 사용할 수 있습니다. Mary **Major**와 같은 AWS Builder ID 프로파일 이름이 됩니다. 이 이름은 나중에 변경할 수 있습니다.

   **다음**을 선택합니다. **이메일 확인** 페이지가 표시됩니다.

1. 지정한 이메일로 확인 코드가 전송됩니다. **확인 코드** 에 이 코드를 입력한 다음, **확인**을 선택합니다. 5분 후에도 코드를 받지 못하고 스팸 폴더나 정크 폴더에서 코드를 찾을 수 없다면, 코드 **재전송**을 선택하세요.

1. 코드를 확인한 후 **암호** 및 **암호 확인**의 요구 사항을 충족하는 암호를 입력합니다.

    AWS 고객 계약 및 AWS 서비스 약관에 대한 계약을 확인하는 확인란을 선택한 다음 ** AWS Builder ID 생성을** 선택합니다.

1. **CodeCatalyst 별칭 생성** 페이지에서 CodeCatalyst에서 고유한 사용자 식별자에 사용할 별칭을 입력합니다. **MaryMajor**와 같이 공백이 없는 이름의 단축 버전을 선택합니다. 다른 CodeCatalyst 사용자는 댓글과 풀 요청에서 이 별칭을 사용하여 사용자에게 @mention을 보냅니다. CodeCatalyst 프로파일에는 AWS Builder ID의 전체 이름과 CodeCatalyst 별칭이 모두 포함됩니다. CodeCatalyst 별칭은 나중에 변경할 수 없습니다.

   전체 이름과 별칭은 CodeCatalyst의 여러 영역에 표시됩니다. 예를 들어 프로파일 이름은 활동 피드에서 나열된 액티비티에 표시되지만, 프로젝트 멤버는 사용자의 별칭을 사용자를 @mention하는 데 사용합니다.

   **다음**을 선택합니다. 페이지가 업데이트되어 **CodeCatalyst 스페이스 생성** 섹션이 표시됩니다.

1. **스페이스 이름 지정**에서 스페이스 이름을 입력합니다. 이 이름은 나중에 변경할 수 없습니다.
**참고**  
스페이스 이름은 CodeCatalyst 전체에서 고유해야 합니다. 삭제된 스페이스의 이름은 재사용할 수 없습니다.

1. **AWS 리전** 드롭다운 메뉴에서 스페이스 및 프로젝트 데이터를 저장할 리전을 선택합니다. 이 이름은 나중에 변경할 수 없습니다.

1. **다음**을 선택합니다. 페이지가 업데이트되어 AWS 계정을 추가하기 위한 페이지가 표시됩니다. 이 계정은 스페이스의 청구 계정으로 사용됩니다.

1. **AWS 계정 ID**의 경우, 스페이스에 연결하려는 계정의 12자리 ID를 입력합니다.

   **AWS 계정 확인 토큰**에서 생성된 토큰 ID를 복사합니다. 토큰은 자동으로 복사되지만 AWS 연결 요청을 승인하는 동안에 토큰을 저장할 수 있습니다.

1. ** AWS 콘솔로 이동을 선택하여 확인합니다**.

1.  AWS Management Console에서 **Amazon CodeCatalyst 스페이스 확인** 페이지가 열립니다. **Amazon CodeCatalyst 스페이스** 페이지입니다. 페이지에 액세스하려면 로그인해야 할 수 있습니다.

   에서 AWS Management Console스페이스를 생성하려는 AWS 리전 동일한를 선택해야 합니다.

   페이지에 직접 액세스하려면 https://console.aws.amazon.com/codecatalyst/home/에서 Amazon CodeCatalyst Spaces AWS Management Console 에 로그인합니다.

   의 확인 토큰 필드는 CodeCatalyst에서 생성된 토큰으로 AWS Management Console 자동으로 채워집니다.

1. (선택 사항) **승인된 유료 티어**에서 **유료 티어 승인(표준, 엔터프라이즈)**을 선택하여 청구 계정의 유료 티어를 활성화할 수 있습니다.
**참고**  
이렇게 해도 청구 계층은 유료 티어로 업그레이드되지 않습니다. 그러나 CodeCatalyst에서 언제든지 스페이스의 결제 계층을 변경할 수 AWS 계정 있도록를 구성합니다. 언제든지 유료 티어를 활성화할 수 있습니다. 이러한 변경이 없다면, 스페이스는 프리 티어만 사용할 수 있습니다.

1. **스페이스 확인**을 선택합니다.

   계정이 스페이스에 추가되었음을 보여주는 **계정 확인** 성공 메시지가 표시됩니다.

1. ** Amazon CodeCatalyst 스페이스 확인** 페이지에 머무릅니다. 다음 링크를 선택합니다. **이 스페이스에 대한 IAM 역할을 추가하려면 스페이스 세부 정보를 봅니다.**

    AWS Management Console에서 **CodeCatalyst 스페이스 세부 정보** 페이지가 열립니다. **Amazon CodeCatalyst 스페이스** 페이지입니다. 페이지에 액세스하려면 로그인해야 할 수 있습니다.

1. CodeCatalyst 페이지로 돌아가 **다음**을 선택합니다.

1. 스페이스가 생성되는 동안 상태 메시지가 표시됩니다. 스페이스가 생성되면 CodeCatalyst에 다음과 같은 메시지가 표시됩니다. **스페이스가 준비되었습니다. 마지막 단계는 프로젝트 생성입니다.** 다음 중 하나를 수행할 수 있습니다.
   + **지금 건너뛰기**를 선택합니다.
   + 스페이스에 대한 **첫 번째 프로젝트 생성**을 선택합니다. 블루프린트를 사용하여 프로젝트를 생성하는 방법을 보여주는 자습서는 [자습서: 최신 3계층 웹 애플리케이션 블루프린트로 프로젝트 만들기](getting-started-template-project.md) 섹션을 참조하세요.
**참고**  
권한 오류 또는 배너가 표시되면 페이지를 새로 고치고 페이지를 다시 확인해 봅니다.

**CodeCatalyst **CodeCatalystWorkflowDevelopmentRole-*spaceName***을 생성하고 추가하려면**

1. CodeCatalyst 콘솔에서 시작하기 전에를 열고 스페이스 AWS 계정 에 대해 동일한 로 로그인했는지 AWS Management Console확인합니다.

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다. **설정**을 선택한 다음 **AWS 계정**를 선택합니다.

1. 역할을 생성하려는 AWS 계정 의 링크를 선택합니다. **AWS 계정 세부 정보** 페이지가 표시됩니다.

1. **역할 관리를 AWS Management Console** 선택합니다.

    AWS Management Console에서 **Amazon CodeCatalyst 스페이스에 IAM 역할 추가** 페이지가 열립니다. **Amazon CodeCatalyst 스페이스** 페이지입니다. 페이지에 액세스하려면 로그인해야 할 수 있습니다.

1. **IAM에서 CodeCatalyst 개발 관리자 역할 생성**을 선택합니다. 이 옵션은 개발 역할에 대한 권한 정책 및 신뢰 정책을 포함하는 서비스 역할을 생성합니다. 역할에는 `CodeCatalystWorkflowDevelopmentRole-spaceName` 이름이 있습니다. 역할 및 역할 정책에 대한 자세한 내용은 [**CodeCatalystWorkflowDevelopmentRole-*spaceName*** 서비스 역할 이해](ipa-iam-roles.md#ipa-iam-roles-service-role) 섹션을 참조하세요.
**참고**  
이 역할은 개발자 계정에서만 사용하는 것이 권장되며 `AdministratorAccess` AWS 관리형 정책을 사용하여 여기에 새 정책 및 리소스를 생성할 수 있는 전체 액세스 권한을 부여합니다 AWS 계정.

1. **개발 역할 생성**을 선택합니다.

1. 연결 페이지에 있는 **CodeCatalyst에서 사용할 수 있는 IAM 역할**에서 계정에 추가된 IAM 역할 목록의 `CodeCatalystWorkflowDevelopmentRole-spaceName` 역할을 봅니다.

1. 스페이스로 돌아가려면 **Amazon CodeCatalyst로 이동**을 선택합니다.

**CodeCatalyst **AWSRoleForCodeCatalystSupport**을 생성하고 추가하려면**

1. CodeCatalyst 콘솔에서 시작하기 전에를 열고 스페이스 AWS 계정 에 대해 동일한 로 로그인했는지 AWS Management Console확인합니다.

1. CodeCatalyst 스페이스로 이동합니다. **설정**을 선택한 다음 **AWS 계정**를 선택합니다.

1. 역할을 생성하려는 AWS 계정 의 링크를 선택합니다. **AWS 계정 세부 정보** 페이지가 표시됩니다.

1. **역할 관리를 AWS Management Console** 선택합니다.

    AWS Management Console에서 **Amazon CodeCatalyst 스페이스에 IAM 역할 추가** 페이지가 열립니다. **Amazon CodeCatalyst 스페이스** 페이지입니다. 페이지에 액세스하려면 로그인해야 할 수 있습니다.

1. **CodeCatalyst 스페이스 세부 정보**에서 **CodeCatalyst 지원 역할 추가**를 선택합니다. 이 옵션은 미리 보기 개발 역할에 대한 권한 정책 및 신뢰 정책을 포함하는 서비스 역할을 생성합니다. 역할에는 고유한 식별자가 추가된 **AWSRoleForCodeCatalystSupport** 이름이 있습니다. 역할 및 역할 정책에 대한 자세한 내용은 [**AWSRoleForCodeCatalystSupport** 서비스 역할 이해](ipa-iam-roles.md#ipa-iam-roles-support-role) 섹션을 참조하세요.

1. **CodeCatalyst 지원에 역할 추가** 페이지에서 기본값을 선택한 상태로 두고 **역할 생성**을 선택합니다.

1. **CodeCatalyst에서 사용할 수 있는 IAM 역할**에서 계정에 추가된 IAM 역할 목록의 `CodeCatalystWorkflowDevelopmentRole-spaceName` 역할을 봅니다.

1. 스페이스로 돌아가려면 **Amazon CodeCatalyst로 이동**을 선택합니다.

 AWS Builder ID를 생성하고, 첫 번째 스페이스를 생성하고, 계정을 추가한 후 프로젝트를 생성할 수 있습니다. 자세한 내용은 [프로젝트 생성](projects-create.md) 단원을 참조하십시오. CodeCatalyst 처음 사용하는 경우 [자습서: 최신 3계층 웹 애플리케이션 블루프린트로 프로젝트 만들기](getting-started-template-project.md) 섹션부터 시작하는 것이 좋습니다.

# 초대 수락 및 AWS Builder ID 생성
<a name="sign-up-sign-in"></a>

프로젝트 또는 스페이스에 대한 초대를 수락하는 과정에서 Amazon CodeCatalyst에 처음으로 로 가입하는 방법을 알아봅니다. 초대를 수락하는 과정에서 AWS Builder ID를 생성하라는 메시지가 표시됩니다. AWS Builder ID를 사용하여 CodeCatalyst의 리소스에 액세스합니다.

**작은 정보**  
추가 도움이 필요한 경우 [가입 문제](ipa-troubleshooting.md#id-troubleshooting-sign-up) 섹션을 참조하세요.

다음은 프로젝트 또는 스페이스에 대한 초대로 CodeCatalyst를 시작하는 사용자에게 가능한 흐름 중 하나입니다.

Saanvi Sarkar는 프로젝트 관리자로 CodeCatalyst 프로젝트에 초대를 받은 개발자입니다. Saanvi는 초대를 수락하면 CodeCatalyst에 대한 로그인 페이지가 열립니다. Saanvi는 가입하기로 선택하고 이메일 주소와 암호를 제공하여 AWS Builder ID를 생성합니다. Saanvi는 AWS Builder ID를 사용하여 CodeCatalyst 및 기타 애플리케이션에 로그인할 수 있습니다. 나중에 프로파일을 편집하여 로그인 이메일 주소 또는 암호를 변경할 수 있습니다. 별칭을 선택하라는 메시지가 표시되면 Saanvi는 CodeCatalyst에 표시될 CodeCatalyst 별칭으로 `SaanviSarkar`를 지정하고 다른 프로젝트 멤버가 @mention Saanvi에 사용할 수 있도록 지정합니다. Saanvi는 가입한 후 AWS Builder ID 자격 증명을 사용하는 다른 애플리케이션에도 로그인 자격 증명을 사용할 수 있습니다.

가입이 완료되면 Saanvi는 초대에 지정된 CodeCatalyst 프로젝트와 스페이스에 자동으로 참여합니다. 초대는 프로젝트 및 스페이스에서 역할에 대한 사전 결정된 권한도 제공합니다. 프로젝트 설정에서 Saanvi의 별칭은 할당된 프로젝트 역할과 함께 멤버 목록에 표시됩니다. CodeCatalyst에서 소스 리포지토리를 사용하기 위해 Saanvi는 개인 액세스 토큰(PAT)을 생성합니다. PAT는 인증 토큰이 필요한 소스 변경 또는 작업을 수행할 때 CodeCatalyst에서 인증을 위해 사용됩니다.

Saanvi가 프로젝트에서 작업하면 프로젝트의 작업 활동 로그에 별칭이 나열됩니다. Saanvi의 문제와 의견은 다른 프로젝트 멤버가 그녀를 답글로 @mention할 수 있는 별칭을 보여줍니다. 다른 프로젝트 멤버를 @mention하기 위해 Saanvi는 CodeCatalyst 프로파일에서 별칭을 조회합니다.

잠시 시간이 되면 Saanvi는 멀티 팩터 인증(MFA)을 사용하여 CodeCatalyst에 로그인하도록 AWS Builder ID를 구성합니다. MFA를 구성하면 Saanvi는 CodeCatalyst 암호와 승인된 타사 인증 앱의 암호 또는 토큰을 조합하여 CodeCatalyst에 로그인할 수 있습니다.

## 초대 수락 및 AWS Builder ID 생성
<a name="id-how-to"></a>

Amazon CodeCatalyst의 프로젝트 또는 스페이스에 초대를 받으면 notify@codecatalyst.aws에서 초대 수락을 요청하는 이메일을 받게 됩니다. AWS Builder ID가 이미 있고 CodeCatalyst에 로그인한 경우 **초대 수락**을 선택하면 브라우저 탭에서 프로젝트 또는 공간이 자동으로 열립니다. 콘솔에 로그인하지 않았지만 AWS Builder ID가 있는 경우 로그인 페이지로 이동합니다. 자세한 내용은 [AWS Builder ID로 로그인](id-how-to-sign-in.md) 단원을 참조하십시오.

 AWS Builder ID가 없는 경우 **초대 수락**을 선택하면 로그인 페이지로 이동합니다. 로그인 페이지에서 AWS Builder ID를 생성하는 옵션을 선택해야 합니다.

**중요**  
초대를 수락하고 개발 환경에서 리포지토리를 열면 스크립트가 CodeCatalyst 자격 증명에 액세스하여 실행될 수 있습니다. 계속하기 전에 소스를 신뢰해야 합니다.

**초대를 수락하고 AWS Builder ID를 생성하려면**

1. 초대 이메일에서 **초대 수락**을 선택합니다.

1. 로그인 페이지에서 **가입하지 않았나요?을 선택합니다. AWS Builder ID를 생성합니다**.
**작은 정보**  
 AWS Builder ID는 로그인하기 위해 생성한 자격 증명입니다. AWS 계정와 동일하지 않습니다.

1. ** AWS Builder ID 생성** 페이지의 **이메일 주소**에 AWS Builder ID에 사용할 이메일 주소를 입력합니다.

   **이름**에 AWS Builder ID를 사용하는 애플리케이션에 표시할 이름과 성을 입력합니다. 공백을 사용할 수 있습니다. Mary **Major**와 같은 AWS Builder ID 프로파일 이름이 됩니다. 이 이름은 나중에 변경할 수 있습니다.

   **다음**을 선택합니다.

   지정한 이메일로 확인 코드가 전송됩니다. **확인 코드** 에 이 코드를 입력한 다음, **확인**을 선택합니다. 5분 후에도 코드를 받지 못하고 스팸 폴더나 정크 폴더에서 코드를 찾을 수 없다면, 코드 **재전송**을 선택하세요.

1. 코드가 확인되면, **암호** 및 **암호 확인**의 요구 사항을 충족하는 암호를 입력합니다.

1. ** AWS Builder ID 생성을** 선택합니다.

1. **별칭 생성** 페이지에서 CodeCatalyst에서 고유한 사용자 식별자에 사용할 별칭을 입력합니다. **MaryMajor**와 같이 공백이 없는 이름의 단축 버전을 선택합니다. 다른 CodeCatalyst 사용자는 댓글과 풀 요청에서 이 별칭을 사용하여 사용자에게 @mention을 보냅니다. CodeCatalyst 프로파일에는 AWS Builder ID의 전체 이름과 CodeCatalyst 별칭이 모두 포함됩니다. CodeCatalyst 별칭은 변경할 수 없습니다.

   전체 이름과 별칭은 CodeCatalyst의 여러 영역에 표시됩니다. 예를 들어 프로파일 이름은 활동 피드에서 나열된 액티비티에 표시되지만, 프로젝트 멤버는 사용자의 별칭을 사용자를 @mention하는 데 사용합니다.

   **별칭 생성**을 선택합니다. 초대받은 프로젝트 또는 스페이스로 이동합니다.

# AWS Builder ID로 로그인
<a name="id-how-to-sign-in"></a>

다음 단계에 따라 Amazon CodeCatalyst 프로파일에 로그인합니다.

**참고**  
다중 인증(MFA)용 디바이스를 아직 등록하지 않으셨습니까? 보안을 높이려면 Amazon CodeCatalyst에서 MFA를 구성하는 것이 좋습니다. 자세한 내용은 [다중 인증에 사용할 디바이스를 등록하는 방법](mfa.md#id-how-to-register) 섹션을 참조하세요.

**AWS Builder ID로 로그인하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. **이메일 주소**를 입력합니다. 원하는 경우 향후 로그인을 위해 이메일 주소를 저장하려면 **내 이메일 주소 저장**을 선택합니다. **계속**을 선택합니다.

1. **암호**를 입력합니다. **로그인**을 선택합니다. 암호가 기억나지 않는 경우 [암호를 잊어버렸습니다](troubleshooting.md#id-forgot-password)의 단계를 따르세요.

## 신뢰할 수 있는 디바이스
<a name="id-trusted-device"></a>

로그인 페이지에서 **신뢰할 수 있는 디바이스** 옵션을 선택하면, Amazon CodeCatalyst는 향후 해당 디바이스를 통한 모든 로그인이 승인된 것으로 간주합니다. Amazon CodeCatalyst는 신뢰할 수 있는 디바이스를 사용하는 한 MFA 코드를 입력하는 옵션을 제공하지 않습니다. 브라우저에서 로그인하거나 디바이스에 알 수 없는 IP 주소가 발급된 경우 등 몇 가지 예외가 있습니다.

# SSO로 로그인
<a name="sign-in-sso"></a>

SSO를 사용하여 Amazon CodeCatalyst 로그인하려면 다음 단계를 따르세요.

AWS Builder ID을 대신 사용하여 로그인하려면 [AWS Builder ID로 로그인](id-how-to-sign-in.md) 섹션을 참조하세요.

**SSO로 로그인하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. **로그인 옵션 선택**에서 **AWS Single Sign-On(SSO) 사용**을 선택합니다.

1. **AWS Identity Center 애플리케이션 이름**에 ID 페더레이션 관리자가 제공한 애플리케이션 이름을 입력합니다.

1. **IAM Identity Center로 계속 진행**을 선택합니다.

# 사용자의 모든 스페이스 및 프로젝트 보기
<a name="home"></a>

사용자 홈 페이지에서 스페이스 및 프로젝트 목록을 볼 수 있습니다. 사용자 홈 페이지에는 사용자가 속한 각 스페이스, **스페이스 관리자**와 같은 해당 스페이스의 사용자 역할, 사용자가 멤버십을 보유한 각 스페이스의 프로젝트 목록이 표시됩니다.

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 브라우저에 다음 주소를 입력합니다. [https://codecatalyst.aws/home](https://codecatalyst.aws/home)   
![\[사용자 홈 페이지에는 사용자가 멤버인 모든 스페이스와 프로젝트가 나열됩니다.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/user_home.png)

1. 열려는 스페이스 또는 프로젝트를 선택합니다. 예상했던 스페이스나 프로젝트가 보이지 않으면 에서 다른 사용자로 로그인해야 할 수 있습니다.

# CodeCatalyst 프로파일 보기 및 관리
<a name="view-profiles"></a>

Amazon CodeCatalyst에서 사용자 프로파일을 확인하여 이메일 주소 및 CodeCatalyst 별칭과 같은 정보를 얻을 수 있습니다. 프로필과 AWS Builder ID를 업데이트할 수도 있습니다. 암호를 잊어버린 경우 암호 재설정을 요청하면 됩니다.

## CodeCatalyst 프로파일 보기
<a name="view-your-profile"></a>

가입 시 Amazon CodeCatalyst에 로그인하기 위한 자격 증명으로 사용되며 프로파일에서 관리되는 정보를 제공합니다. 여기에는 **이름**, **별명**, CodeCatalyst에 로그인할 때 사용하는 **이메일 주소**가 포함됩니다.

**참고**  
 AWS Builder ID **별명은** CodeCatalyst 별칭이 아닙니다. 가입 시 CodeCatalyst 별칭을 선택했습니다.

**CodeCatalyst 프로파일 보기**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 오른쪽 상단에서 첫 번째 이니셜이 있는 아이콘 옆의 화살표를 선택한 다음 **내 설정**을 선택합니다. CodeCatalyst **내 설정** 페이지가 열립니다.

1.  AWS Builder ID 이메일 주소 또는 암호를 업데이트하거나 MFA를 설정하려면 ** AWS Builder ID 관리를** 선택합니다. AWS Builder ID 페이지가 열립니다.

## 다른 사용자의 CodeCatalyst 프로파일 보기
<a name="view-another-user-profile"></a>

**다른 사용자의 CodeCatalyst 프로파일 보기**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 측면 탐색에서 **프로젝트 설정**을 선택합니다. **멤버** 탭을 선택합니다. CodeCatalyst 프로젝트의 멤버 목록을 확인합니다.

1. 조회하려는 멤버 이름을 선택하거나 @멘션합니다. **내 설정** 페이지에는 사용자의 별칭, 이메일 주소, 성명이 표시됩니다. 프로젝트 멤버를 @멘션할 때 CodeCatalyst 별칭을 사용합니다.
**참고**  
사용자의 AWS Builder ID **별칭**은 CodeCatalyst 별칭이 아닙니다. 가입 시 CodeCatalyst 별칭을 선택했습니다.

   프로젝트에서 다른 사용자의 프로파일을 보려면 목록에서 해당 사용자의 이름을 선택하세요.

# 프로파일 업데이트
<a name="your-profile"></a>

CodeCatalyst에서 프로파일은 **AWS Builder ID**로 관리되는 개인 정보와 CodeCatalyst에서 관리되는 설정으로 구성됩니다.
+ 프로파일의 전체 이름, 이메일 주소 및 암호는 **AWS Builder ID**에서 관리합니다. 가입할 때 이 정보를 입력했습니다. 애플리케이션 로그인에 인증 앱을 사용하도록 MFA를 설정하면 CodeCatalyst는 **AWS Builder ID** 페이지로 이동합니다.
+ 개인 액세스 토큰(PAT), CodeCatalyst 알림 및 언어 기본 설정에 대한 CodeCatalyst 설정은 CodeCatalyst의 **내 설정** 페이지에서 관리합니다. 자세한 내용은 [개인 액세스 토큰을 사용하여 사용자 리포지토리 액세스 권한 부여](ipa-tokens-keys.md) 단원을 참조하십시오.

**참고**  
 AWS Builder ID 전체 이름(CodeCatalyst 표시 이름)과 이름을 업데이트할 수 있습니다. 단, CodeCatalyst 별칭은 변경할 수 없습니다.

## AWS Builder ID 또는 이메일 주소 업데이트
<a name="id-update-profile"></a>

**AWS Builder ID 또는 이메일 주소를 업데이트하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 오른쪽 상단에서 첫 번째 이니셜이 있는 아이콘 옆의 화살표를 선택한 다음 **내 설정**을 선택합니다. CodeCatalyst **내 설정** 페이지가 열립니다.

1. 프로필 페이지에서 ** AWS Builder ID 관리를** 선택합니다. **AWS Builder ID** 페이지가 열립니다.

1. 페이지 왼쪽에서 **내 세부 정보 **를 선택합니다.

1. **프로파일 정보**에서 **편집**을 선택하여 **이름** 또는 **별칭**을 업데이트합니다. 별명을 지정하지 않은 경우 **별명** 필드에 전체 이름의 이름이 반영됩니다. CodeCatalyst 별칭이 아닙니다.
**참고**  
그러면 AWS Builder ID 전체 이름과 이름이 업데이트됩니다. 이렇게 해도 CodeCatalyst 별칭은 업데이트되지 않습니다.

   **연락처 정보**에서 **편집**을 선택하여 **이메일 주소**를 업데이트합니다.
**참고**  
이렇게 하면 CodeCatalyst 에 로그인하는 데 사용할 이메일 주소가 업데이트됩니다.

# AWS Builder ID와 연결된 CodeCatalyst 암호 변경
<a name="id-change-password"></a>

다음 지침에 따라 AWS Builder ID와 연결된 Amazon CodeCatalyst 암호를 변경합니다.

**참고**  
SSO를 사용하여 CodeCatalyst에 로그인하는 경우 암호 변경에 대해 관리자에게 문의하세요.

**CodeCatalyst 암호를 변경하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 오른쪽 상단에서 첫 번째 이니셜이 있는 아이콘 옆의 화살표를 선택한 다음 **사용자 프로파일**을 선택합니다. CodeCatalyst **내 설정** 페이지가 열립니다.

1. 프로파일 페이지에서 **AWS Builder ID 관리**를 선택합니다. AWS Builder ID 페이지가 열립니다.

1. 페이지 왼쪽에서 **보안**을 선택합니다.

1. **암호 변경**을 선택하고 지침을 따릅니다.

# CodeCatalyst AWS CLI 에서를 사용하도록 설정
<a name="set-up-cli"></a>

Amazon CodeCatalyst 콘솔에서는 대부분의 일상 작업을 수행합니다. 그러나 CodeCatalyst에서 개발 환경, 개인 액세스 토큰 또는 이벤트 로그를 사용할 AWS CLI 때를 설정하고 구성할 수 있습니다. CodeCatalyst AWS CLI 와 함께 사용하려면 먼저를 설치하고 프로필을 구성해야 합니다.<a name="how-to-set-up-cli"></a>

# CodeCatalyst AWS CLI 용를 설정하려면
<a name="how-to-set-up-cli"></a>

1.  AWS CLI의 최신 버전을 설치합니다. 버전이 이미 AWS CLI 설치되어 있는 경우 버전이 최신 버전이고 CodeCatalyst에 대한 명령이 포함되어 있는지 확인하고 필요한 경우 업데이트합니다. CodeCatalyst 명령이 포함된 버전이 설치되어 있는지 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.

   ```
   aws codecatalyst help
   ```

   CodeCatalyst 명령 목록이 표시되면 CodeCatalyst를 지원하는 버전이 설치되어 있는 것입니다. 명령이 인식되지 않으면의 버전을 AWS CLI 최신 버전으로 업데이트합니다. 자세한 내용은 AWS Command Line Interface 사용 설명서의 [의 최신 버전 설치 또는 업데이트를 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 참조하세요.

1. 프로파일이 없거나 CodeCatalyst 전용으로 이름이 지정된 프로파일을 사용하려는 경우, **aws configure** 명령을 실행하여 프로파일을 생성합니다. 특별히 CodeCatalyst 와 함께 사용하기 위해 명명된 프로파일을 생성하는 것을 권장하지만, 기본 프로파일도 사용할 수 있습니다. 자세한 정보는 [구성 기본 사항](https://docs.aws.amazon.com//cli/latest/userguide/cli-configure-quickstart.html)을 참조하세요.

1. 다음과 같이 프로파일의 `config` 파일을 편집하여 CodeCatalyst에 연결하기 위한 섹션을 추가합니다. `config` 파일은 `~/.aws/config`(Linux 또는 macOS) 또는 `C:\Users\USERNAME\.aws\config`(Windows)에 저장됩니다.

   ```
   [profile codecatalyst]
   region = us-west-2
   sso_session = codecatalyst
   
   [sso-session codecatalyst]
   sso_region = us-east-1
   sso_start_url = https://view.awsapps.com/start
   sso_registration_scopes = codecatalyst:read_write
   ```

1. 파일을 저장합니다.

1. CodeCatalyst 명령을 실행해보기 전에 새 터미널 또는 명령 프롬프트를 열고 다음 명령을 실행하여 `aws codecatalyst` 명령을 실행할 자격 증명을 요청하고 검색합니다. 필요한 경우 `codecatalyst`를 프로파일 이름으로 바꿉니다.

   ```
   aws sso login --profile codecatalyst
   ```

**codecatalyst** 명령의 예를 보려면 다음 주제를 참조하세요.
+ [개인 액세스 토큰을 사용하여 사용자 리포지토리 액세스 권한 부여](ipa-tokens-keys.md)
+ [이벤트 로깅을 사용하여 로깅된 이벤트에 액세스](ipa-logs.md)