프로젝트 생성 및 관리

프로젝트는 카카오클라우드에서 서비스를 보유하고, 해당 리소스를 사용하는 상위 개념입니다. 본 문서에서 설명하는 프로젝트 생성 및 관리 기능은 다음과 같은 IAM 역할을 부여받은 사용자에게만 허용됩니다.

IAM 역할별 프로젝트 관리

기능	조직 소유자(Owner)	조직 관리자(Admin)	조직 리더(Reader)	프로젝트 관리자(Admin)	프로젝트 멤버(Member)	프로젝트 리더(Reader)
전체 프로젝트 조회		✓	✓
프로젝트 생성		✓
프로젝트 정보 수정		✓
기본 프로젝트 설정		✓
프로젝트 삭제 요청		✓

프로젝트 생성

카카오클라우드의 리소스를 사용하려면 먼저 조직 내에 프로젝트를 생성해야 합니다. 프로젝트 생성은 조직 관리자 권한을 가진 사용자가 프로젝트를 생성할 수 있습니다.

안내

프로젝트 생성에 앞서 결제 수단을 등록해야 합니다. 결제 수단 등록 방법은 결제수단 관리를 참고하시기 바랍니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 좌측의 프로젝트 메뉴에서 [프로젝트 생성] 버튼을 클릭합니다.

3. 팝업창에서 프로젝트 생성에 필요한 정보를 입력하고, [생성] 버튼을 클릭합니다.

   프로젝트 생성

   구분	설명
   조직 이름	조직 소유자가 최초 가입 시 등록한 조직 이름(자동 입력)
   프로젝트 닉네임	생성할 프로젝트 이름
   프로젝트 이름	API 상에서 고유한 프로젝트 식별자 - 프로젝트 생성 완료 후 변경 불가
   설명(선택)	프로젝트에 대한 설명을 입력

프로젝트 관리

전체 프로젝트 보기

조직 관리자는 조직 내 전체 프로젝트를 조회할 수 있습니다. 프로젝트 관리자와 프로젝트 멤버는 소속된 프로젝트만 조회할 수 있습니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 좌측의 프로젝트 메뉴에서 조직의 전체 프로젝트를 확인합니다.

   조직 프로젝트 목록

프로젝트 정보 수정

조직 관리자는 프로젝트 이름과 설명 등의 정보를 수정할 수 있습니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 좌측의 프로젝트 메뉴에서 변경할 프로젝트의 [더 보기] 아이콘에서 프로젝트 수정을 선택합니다.

   • 프로젝트 정보는 해당 프로젝트가 소속된 조직에서만 수정 가능합니다. 따라서 프로젝트 정보를 수정하기 전에 해당 프로젝트가 속한 조직을 선택해야 합니다.

3. 프로젝트 수정 팝업창에서 프로젝트 닉네임과 설명을 수정하고, [저장] 버튼을 클릭합니다.

   프로젝트 수정

   구분	설명
   프로젝트 닉네임	생성할 프로젝트 이름
   프로젝트 설명(선택)	프로젝트 설명을 입력

기본 프로젝트 설정

카카오클라우드 콘솔에 로그인 시 최근 작업한 프로젝트 정보가 없는 경우 기본 프로젝트의 대시보드로 이동됩니다. 기본 프로젝트는 하나만 설정할 수 있으며, 자유롭게 변경할 수 있습니다.
조직 관리자는 사용자의 기본 프로젝트를 설정할 수 있습니다.

안내

조직 관리자 또는 조직 소유자가 설정한 기본 프로젝트를 사용자가 변경할 수 있습니다. 사용자가 직접 기본 프로젝트를 설정하는 방법은 기본 프로젝트 설정을 참고하시기 바랍니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 좌측의 사용자 메뉴에서 [더 보기] 아이콘 > 사용자 정보를 클릭합니다.

3. IAM 역할 탭에서 기본 프로젝트 설정을 선택합니다.

4. 팝업창에서 프로젝트를 선택하고 [적용] 버튼을 클릭합니다.

리전에 대한 안내

한시적으로 프로젝트 생성 시 리소스가 위치하는 리전을 제한하고 있습니다. 2023년 5월 31일 이전에 가입한 고객은 kr-central-1 만 선택할 수 있으며, 이후에 가입한 고객은 kr-central-2 만 선택할 수 있습니다.
가입 일자(2023년 5월 31일)를 기준으로 현재 선택할 수 있는 리전은 콘솔 우측 상단의 리전 선택 아이콘에서 확인할 수 있습니다.

• 개발 환경에 따라 부득이하게 프로젝트에 활성화된 리전 추가가 필요한 경우, 헬프데스크에 접속 후, 기술 문의 유형을 서비스, 질문 유형을 프로젝트 리전 추가로 선택 후 문의하시기 바랍니다.
  
• 리전에 대한 상세 설명은 리전(Region)과 가용 영역(AZ)을 참고하시기 바랍니다.

프로젝트 삭제 요청

조직 관리자 역할을 가진 사용자는 헬프데스크에 관련 문의를 남겨 프로젝트의 삭제를 요청할 수 있습니다.
콘솔에서 직접 프로젝트를 삭제할 수 있는 기능은 지원 예정입니다.

주의

프로젝트 삭제 시, 해당 프로젝트에서 생성한 모든 리소스도 함께 삭제되며 복구할 수 없으므로 주의하시기 바랍니다.

1. 헬프데스크에서 우측 상단에 위치한 [질문하기] 버튼을 클릭합니다.

2. [기술 문의] 버튼을 클릭 후, 정보를 입력하고 [등록] 버튼을 클릭합니다.

   프로젝트 삭제 요청

   구분	설명
   질문 유형	일반 또는 기술 문의 중 선택 - 프로젝트 삭제는 기술 문의 유형 선택
   유형 상세	질문의 상세 유형 - 프로젝트 삭제는 서비스의 프로젝트 삭제 선택
   프로젝트 명	삭제를 요청할 프로젝트 이름
   제목	질문의 제목
   질문 내용	질문의 상세 내용 - 비밀글 여부 활성화
   첨부 파일	필요시 파일 첨부

서비스 계정 관리

서비스 계정은 실제 IAM 사용자 계정이 아니며, 프로젝트 내 리소스에 접근하거나 이를 제어하기 위한 계정입니다. 프로젝트 단위에서 활용할 API 토큰을 발급하기 위해 IAM 사용자 계정 대신 사용할 수 있습니다. 본 문서에서 설명하는 서비스 계정 관리 관련 기능은 다음의 IAM 권한을 부여받은 사용자만 가능합니다.

IAM 권한별 서비스 계정 관리

기능	조직 소유자(Owner)	조직 관리자(Admin)	조직 리더(Reader)	프로젝트 관리자(Admin)	프로젝트 멤버(Member)	프로젝트 리더(Reader)
서비스 계정 조회				✓	✓	✓
서비스 계정 생성				✓	✓
서비스 계정 상태 변경				✓	✓
서비스 계정 삭제				✓	✓
서비스 액세스 키 추가 및 삭제				✓	✓
서비스 에이전트 계정 조회				✓	✓	✓

서비스 계정 보기

서비스 계정은 프로젝트 구성원이 서비스 계정 API 인증 토큰으로 API를 호출하여 카카오클라우드 서비스의 리소스에 접근하거나 이를 제어하기 위한 계정입니다. 서비스 계정을 조회하는 방법은 다음과 같습니다.

안내

서비스 계정의 액세스 키를 사용하여 API 인증 토큰을 발급할 수 있습니다. 이때, 서비스 계정의 API 인증 토큰으로 액세스 키를 추가하거나, 해당 서비스 계정 및 액세스 키를 삭제할 수 없습니다.
- 또한 신규 서비스 계정을 생성하거나, 다른 서비스 계정 및 액세스 키를 삭제할 수 없습니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 서비스 계정 메뉴에서 프로젝트에 생성된 서비스 계정을 조회합니다.

   • 서비스 계정의 경우, ID 우측에 [액세스 키 추가] 버튼이 표시됩니다.

   서비스 계정 목록

   구분	설명
   상태	서비스 계정 상태 - 🟢 사용: 서비스 계정을 이용할 수 있는 기본 상태 - ⚪️ 미사용: 서비스 계정 이용에 제약이 있는 상태
   이름	서비스 계정 이름 - 사용자가 직접 입력한 서비스 계정 이름
   아이디	서비스 계정 ID - 형식: {직접 입력}-프로젝트 고유 ID@kc.serviceaccount.com
   [액세스 키 추가] 버튼	클릭 시 서비스 계정 액세스 키 추가 팝업창으로 이동 - 서비스 계정만 클릭 가능

서비스 계정 생성

서비스 계정은 실제 IAM 사용자 계정은 아니며, 프로젝트 구성원이 서비스 계정 API 인증 토큰으로 API를 호출하여 카카오클라우드 서비스의 리소스에 접근하거나 이를 제어하기 위한 계정입니다. 서비스 계정을 생성하는 방법은 다음과 같습니다.

안내

서비스 계정은 비활성화 상태의 계정을 포함해 프로젝트 당 최대 100개까지 생성할 수 있습니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 좌측의 서비스 계정 메뉴에서 [서비스 계정 생성] 버튼을 클릭합니다.

3. 서비스 계정 생성 팝업창에서 생성에 필요한 정보를 입력하고, [생성] 버튼을 클릭합니다.

   서비스 계정 생성

   구분	설명
   프로젝트	소속 프로젝트 이름(자동 입력)
   서비스 계정	- 이름: 서비스 계정 이름   ㄴ 30자 이하 입력 - ID: 서비스 계정 ID   ㄴ 입력 후 이메일 형식({직접 입력}-프로젝트 고유 ID@kc.serviceaccount.com)으로 자동 생성
   프로젝트 레벨 역할	프로젝트 멤버 역할 자동 입력

서비스 계정 상태 변경

서비스 계정을 사용 또는 미사용 상태로 변경할 수 있습니다. 일시적으로 사용하지 않는 서비스 계정을 미사용할 경우, 발급한 액세스 키와 API 인증 토큰이 즉시 만료되어 일부 리소스를 정상적으로 이용할 수 없으므로 주의하시기 바랍니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.
2. 서비스 계정 메뉴에서 상태를 변경할 서비스 계정의 [더 보기] 아이콘에서 서비스 계정 정보를 선택합니다.
3. 팝업창에서 상태를 변경하고, [저장] 버튼을 클릭합니다.

서비스 계정 삭제

더 이상 사용하지 않는 서비스 계정을 삭제할 수 있습니다.

주의

서비스 계정 삭제 시, 해당 계정으로 발급한 액세스 키와 API 인증 토큰이 즉시 만료되므로 주의하시기 바랍니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 서비스 계정 메뉴에서 삭제할 서비스 계정의 체크박스를 클릭하고, [서비스 계정 삭제] 버튼을 클릭합니다.

3. 팝업창에서 서비스 계정 삭제를 입력하고, [삭제] 버튼을 클릭합니다.

서비스 계정의 액세스 키 발급받기

카카오클라우드 API를 사용하기 위해서는 API 인증 토큰인 액세스 키(액세스 키 ID와 보안 액세스 키) 정보를 발급받아야 합니다. 액세스 키를 발급받는 방법은 다음과 같습니다.

주의

• 액세스 키 추가 시 발급되는 보안 액세스 키는 발급 이후 다시 조회할 수 없습니다.
  
• 액세스 키 사용을 일시적으로 정지하거나, 만료일을 지정할 수 없습니다.
  

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 서비스 계정 메뉴에서 액세스 키를 추가할 서비스 계정의 [액세스 키 추가] 버튼을 클릭합니다.

3. 팝업창에서 정보를 입력하고, [추가] 버튼을 클릭합니다.

   서비스 계정 액세스 키 추가

   구분	설명
   서비스 계정	{직접 입력}-{프로젝트 고유 ID}@kc.serviceaccount.com 형식의 ID로, 자동 입력됨
   프로젝트 레벨 정보	- 프로젝트 닉네임 (프로젝트 이름): 소속 프로젝트 이름(자동 입력) - 프로젝트 레벨 역할: 프로젝트 멤버 역할(자동 입력)
   액세스 키 이름	서비스 계정 액세스 키 이름
   설명 (선택)	최대 30자 입력 가능 - 액세스 키 생성 후 정보 수정 불가능

4. 발급한 액세스 키 ID와 보안 액세스 키를 확인하고, [복사] 버튼을 클릭하여 보안 액세스 키를 복사합니다.

   • 액세스 키 생성 이후에는 보안 액세스 키를 다시 조회할 수 없으므로, 반드시 클립보드에 복사하여 안전하게 별도로 관리하시기 바랍니다.

5. [확인] 버튼을 클릭하여 액세스 키 생성을 완료합니다.

서비스 계정의 액세스 키 삭제하기

더 이상 사용하지 않는 액세스 키(액세스 키 ID와 보안 액세스 키) 를 삭제할 수 있습니다.

주의

액세스 키 삭제 시, 해당 액세스 키로 발급한 API 인증 토큰이 즉시 만료되므로 주의하시기 바랍니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 서비스 계정 메뉴에서 액세스 키를 삭제할 서비스 계정을 선택합니다.

3. 서비스 계정 상세 페이지에서 삭제할 액세스 키를 선택하고, [액세스 키 삭제] 버튼을 클릭합니다.

4. 팝업창에서 액세스 키를 확인하고, [삭제] 버튼을 클릭합니다.

서비스 계정 조회

서비스 계정은 카카오클라우드 서비스 백그라운드에서 직접 리소스에 접근하거나, 사용자의 요청 사항을 수행하기 위해 사용됩니다. 해당 계정은 카카오 카카오클라우드의 특정 서비스를 사용할 때 자동으로 생성되는 계정으로, 사용자가 직접 삭제하거나 정보를 수정할 수 없습니다. 서비스 계정을 조회하는 방법은 다음과 같습니다.

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.

2. 서비스 계정 메뉴에서 프로젝트에 생성된 서비스 계정과 서비스 에이전트를 조회합니다.

   서비스 계정 조회

   구분	설명
   상태	서비스 계정 상태 - 🟢  사용: 서비스 계정을 이용할 수 있는 기본 상태 - ⚪️ 미사용: 서비스 계정 이용에 제약이 있는 상태
   이름	서비스 에이전트의 이름 - 사용 중인 카카오클라우드 서비스 이름으로 자동 생성됨
   ID	서비스 에이전트 아이디 - 형식: 프로젝트 고유 ID@서비스 이름.kic.serviceaccount.com

부록. 프로젝트 ID 확인하기

카카오클라우드 환경에서 프로젝트를 생성하면 해당 프로젝트에 고유한 프로젝트 ID가 생성됩니다.
프로젝트 ID는 해당 프로젝트의 콘솔 주소창에 표시되는 URI(project_id의 값)에서 확인할 수 있습니다.

예를 들어 https://console.kakaocloud.com/transit-gateway/transit-gateways?project_id=073fc84cbd86412ef9f6d269780ef89bb&region=kr-central-2의 경우, 프로젝트 ID 값은 & 이전까지 해당되는 073fc84cbd86412ef9f6d269780ef89bb이 됩니다.