프로젝트 생성 및 관리

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

IAM 역할별 프로젝트 관리

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

프로젝트 생성

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

안내

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

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

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

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

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

프로젝트 관리

전체 프로젝트 보기

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

1. 카카오클라우드 콘솔 > Management > IAM 메뉴로 이동합니다.
2. 좌측의 프로젝트 메뉴에서 조직의 전체 프로젝트를 확인합니다.

프로젝트 정보 수정

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

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

2. 좌측의 프로젝트 메뉴에서 변경할 프로젝트의 편집 아이콘을 선택합니다.

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

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

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

프로젝트 삭제 요청

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

주의

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

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

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

   프로젝트 삭제 요청

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

서비스 계정 관리

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

IAM 권한별 서비스 계정 관리

안내

2024년 11월 15일 기준, 프로젝트 멤버와 프로젝트 리더 권한이 일부 축소되었습니다.

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

서비스 계정 보기

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

안내

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

1. 카카오클라우드 콘솔 > 대시보드 > 프로젝트 선택하여 서비스 계정을 확인하기 위한 프로젝트로 이동합니다.

2. 선택한 프로젝트에서 대시보드 > 프로젝트 관리로 이동으로 이동합니다.

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

   구분	설명
   ID	서비스 계정 ID - 형식: {직접 입력}-프로젝트 고유 ID@kc.serviceaccount.com
   이름	서비스 계정 이름 - 사용자가 직접 입력한 서비스 계정 이름
   상태	서비스 계정 상태 - 🟢 사용: 서비스 계정을 이용할 수 있는 기본 상태 - ⚪️ 미사용: 서비스 계정 이용에 제약이 있는 상태
   생성일	서비스 계정의 생성 일시

서비스 계정 생성

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

안내

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

1. 카카오클라우드 콘솔 > 대시보드 > 프로젝트 선택하여 서비스 계정을 확인하기 위한 프로젝트로 이동합니다.

2. 선택한 프로젝트에서 대시보드 > 프로젝트 관리로 이동으로 이동합니다.

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

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

   서비스 계정 생성

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

서비스 계정 상태 변경

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

1. 카카오클라우드 콘솔 > 대시보드 > 프로젝트 선택하여 서비스 계정을 확인하기 위한 프로젝트로 이동합니다.
2. 선택한 프로젝트에서 대시보드 > 프로젝트 관리로 이동으로 이동합니다.
3. 서비스 계정 메뉴에서 상태를 변경할 서비스 계정의 [더 보기] 메뉴에서 설정을 선택합니다.
4. 팝업창에서 상태를 사용/미사용으로 변경하고, [저장] 버튼을 클릭합니다.

서비스 계정 삭제

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

주의

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

1. 카카오클라우드 콘솔 > 대시보드 > 프로젝트 선택하여 서비스 계정을 확인하기 위한 프로젝트로 이동합니다.
2. 선택한 프로젝트에서 대시보드 > 프로젝트 관리로 이동으로 이동합니다.
3. 서비스 계정 메뉴에서 삭제할 서비스 계정의 체크박스를 클릭하고, [삭제] 버튼을 클릭합니다.
4. 팝업창에서 서비스 계정 삭제를 입력하고, [삭제] 버튼을 클릭합니다.

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

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

주의

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

1. 카카오클라우드 콘솔 > 대시보드 > 프로젝트 선택하여 서비스 계정을 확인하기 위한 프로젝트로 이동합니다.

2. 선택한 프로젝트에서 대시보드 > 프로젝트 관리로 이동으로 이동합니다.

3. 서비스 계정 메뉴에서 액세스 키를 추가할 서비스 계정 ID를 클릭하여 상세 페이지로 이동합니다.

4. 액세스키 탭에서 [액세스 키 생성] 메뉴를 클릭합니다.

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

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

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

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

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

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

주의

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

1. 카카오클라우드 콘솔 > 대시보드 > 프로젝트 선택하여 서비스 계정을 확인하기 위한 프로젝트로 이동합니다.

2. 선택한 프로젝트에서 대시보드 > 프로젝트 관리로 이동으로 이동합니다.

3. 서비스 계정 메뉴에서 액세스 키를 삭제할 서비스 계정 상세 페이지로 이동합니다.

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

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

서비스 에이전트 조회

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

1. 카카오클라우드 콘솔 > 대시보드 > 프로젝트 선택하여 서비스 계정을 확인하기 위한 프로젝트로 이동합니다.

2. 선택한 프로젝트에서 대시보드 > 프로젝트 관리로 이동으로 이동합니다.

3. 서비스 에이전트 메뉴에서 프로젝트의 서비스 에이전트를 조회합니다.

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

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

카카오클라우드 환경에서 프로젝트를 생성하면 해당 프로젝트에 고유한 프로젝트 ID가 생성됩니다.
프로젝트 ID는 카카오클라우드 콘솔 메인 화면 상단의 작업 중인 프로젝트 또는 IAM > 프로젝트 목록에서 프로젝트 ID를 확인할 수 있습니다.