조직

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

Organization이란 무엇인가요?

조직 기능을 사용하면 팀원과 앱을 공유하면서도 각 사용자의 권한을 정밀하게 제어할 수 있습니다. 모든 Capgo 계정은 최소 하나 이상의 조직에 속하며, 필요한 만큼 조직을 생성할 수 있습니다.

액세스 권한은 다음을 통해 관리됩니다: 역할 기반 액세스 제어(RBAC). 각 팀원은 조직 전체 또는 특정 앱 단위로 역할이 부여되며, 이 역할에 따라 볼 수 있는 정보와 수행할 수 있는 작업이 결정됩니다. 채널 액세스 권한은 채널별 권한 재정의(override)를 통해 더욱 세밀하게 조정할 수 있습니다.

Organization 설정 개요

Organization 설정 페이지는 다음을 클릭하여 접속할 수 있습니다: 설정 왼쪽 사이드바에서 조직 탭을 선택하세요. 여기에서 다음 섹션 간을 이동할 수 있습니다:

탭	설명
일반	조직 이름, 로고, 관리자 이메일 확인 및 수정
멤버	팀 멤버 및 권한 관리
그룹	대량 역할 할당을 위한 사용자 그룹 생성 및 관리
API 키	프로그래밍 방식 액세스를 위한 API 키 관리
플랜	구독 플랜 확인 및 관리
크레딧	추가 크레딧 확인 및 구매
보안	보안 정책 설정 (2FA, 비밀번호 요구 사항)
사용량	조직 사용 통계 모니터링
감사 로그	조직 활동 로그 확인
Webhook	webhook 연동 설정
결제	결제 정보 및 인보이스 관리

조직 전환 방법

다음을 클릭하세요: 조직 선택기 사이드바 상단 왼쪽의 드롭다운을 통해 접근 가능한 조직을 확인하고 전환할 수 있습니다.

멤버 관리

멤버 보기

Members 섹션에서는 조직에 액세스 권한이 있는 모든 사용자를 다음 정보와 함께 표시합니다:

멤버: 아바타와 이름
역할: 현재 역할(Super Admin, Admin, Billing Manager 또는 Member)과 활성 또는 대기 중 배지
액션: 역할 편집, 앱 수준 권한 관리 또는 조직에서 제거

활성 멤버는 역할 우선순위대로 정렬됩니다. 대기 중인 초대는 주황색 대기 중 배지가 표시됩니다.

멤버 초대하기

Members 섹션에서 + 추가 버튼을 클릭하세요
어떤 역할 선택 모달이 나타납니다 — 새 멤버의 조직(org) 레벨 역할을 선택하세요:

사용 가능한 조직 레벨 역할은 다음과 같습니다:

멤버 — 읽기 전용 액세스
결제 관리자 — 결제 전용 액세스
관리자 — 전체 관리 (결제 및 삭제 권한 제외)
슈퍼 관리자 — 전체 제어 권한

클릭 확인, 그런 다음 초대 양식(이메일, 선택 사항인 이름/성, 캡차)을 작성하고 초대 보내기.

초대받은 사용자는 매직 링크가 포함된 이메일을 받게 됩니다. 사용자가 수락하면 선택한 역할로 조직에 추가됩니다.

앱 레벨 역할 할당하기

조직 수준의 역할 외에도, 특정 멤버에게 더 세분화된 역할을 부여하여 특정 앱에 대한 액세스 권한을 줄 수 있습니다. 멤버 옆의 접근 제어 버튼(방패 아이콘)을 클릭하여 앱 액세스 모달을 엽니다:

이 모달에서 다음 작업을 수행할 수 있습니다:

앱 검색 및 선택
드롭다운에서 앱 수준의 역할을 선택하세요

사용 가능한 앱 수준 역할은 다음과 같습니다:

앱 관리자 — 앱에 대한 전체 관리 권한
앱 개발자 — 번들 업로드 및 디바이스 관리 가능 (파괴적 작업 불가)
앱 업로더 — 앱 데이터 조회 및 번들 업로드 가능
앱 조회자 — 앱에 대한 읽기 전용 권한

클릭 할당 역할을 부여하려면.

멤버 역할 수정

멤버 옆의 수정 버튼(렌치 아이콘)을 클릭하여 조직 레벨의 역할을 변경하세요. 동일한 역할 선택 모달이 나타나며 현재 역할이 미리 선택되어 있습니다.

제한 사항:

조직 생성자의 역할은 변경할 수 없습니다.
마지막 Super Admin을 삭제할 수 없습니다. 최소 한 명의 Super Admin이 항상 존재해야 합니다.
Super Admin의 권한을 승격하거나 강등하려면 본인도 Super Admin이어야 합니다.

멤버 제거

멤버 옆의 삭제 버튼(휴지통 아이콘)을 클릭하세요. 이 작업은 되돌릴 수 없다는 경고와 함께 확인 대화 상자가 나타납니다. 확인을 위해 삭제 클릭하세요. 클릭 즉시 해당 멤버의 조직, 앱 및 채널에 대한 모든 접근 권한이 취소됩니다.

역할 개요

Capgo는 다음을 사용합니다 역할 기반 액세스 제어(RBAC) 범위(scope)별로 구성된 역할. 다음 단계에서 역할을 할당할 수 있습니다. 조직 레벨(모든 항목에 대한 액세스 권한 부여) 또는 특정 앱. 채널별 권한 재정의를 통해 채널 액세스 권한을 더욱 세밀하게 설정할 수 있습니다.

조직 역할

멤버 초대 시 할당됩니다. 조직 전체에 적용됩니다.

역할	내부 이름	설명
슈퍼 관리자	`org_super_admin`	모든 권한 — 결제, 삭제, 소유권 이전. 조직 생성자에게 자동으로 부여됩니다.
관리자	`org_admin`	관리 권한 — 멤버, 앱, 채널 관리. 결제 및 삭제 권한은 없습니다.
결제 관리자	`org_billing_admin`	결제 전용 — 결제 정보와 인보이스를 조회/수정하고 결제 감사 내역을 확인합니다. 앱이나 멤버에는 접근할 수 없습니다.
멤버	`org_member`	조직 및 모든 앱에 대해 읽기 전용 권한을 가집니다.

앱 역할

단일 앱에 한정된 권한입니다. 팀원이 조직 전체가 아닌 특정 앱에서만 작업해야 할 때 사용하세요.

역할	내부 이름	설명
앱 관리자	`app_admin`	단일 앱에 대한 전체 제어 권한 — 채널, 디바이스, 팀 관리. 앱 삭제나 이전은 불가능합니다.
앱 개발자	`app_developer`	Bundle 업로드, 디바이스 관리, 빌드 트리거, 채널 업데이트. 삭제 및 설정 변경은 불가합니다.
앱 업로더	`app_uploader`	읽기 권한 + 새 bundle 버전 업로드 가능.
앱 조회자	`app_reader`	읽기 전용 — 통계, bundles, 채널, logs, 디바이스.

채널별 권한 재정의

기본적으로 채널 액세스 권한은 app role을 상속받습니다. 사용자 또는 그룹별로 특정 채널 권한을 재정의할 수 있습니다. 예를 들어, App Reader가 해당 staging channel에 bundle을 연결할 수 있도록 허용할 수 있습니다. 설정 방법은 앱 단위 액세스 관리 아래 내용을 참조하세요.

앱 단위 액세스 관리

각 앱에는 전용 액세스 탭이 있어 앱 접근 권한 및 앱 역할, 채널별 권한 재정의를 포함한 작업 범위를 관리할 수 있습니다.

앱 액세스 보기

앱으로 이동하여 다음을 클릭하세요: 액세스 탭을 확인하세요. 액세스 목록에는 각 사용자 또는 그룹과 다음 정보가 표시됩니다:

이메일 — 사용자 이메일(또는 그룹 이름)
역할 — 앱 레벨 역할(App Admin, App Developer, App Uploader 또는 App Reader)
권한 부여일: — 역할이 할당된 시점
액션 — 채널 권한(방패 아이콘), 역할 수정(렌치 아이콘) 및 삭제(휴지통 아이콘)

앱 역할 변경

Members 섹션에서 수정 사용자 옆의 버튼(렌치 아이콘)을 클릭해 앱 수준 역할을 변경하세요:

새 역할을 선택하고 클릭하세요 확인. 사용 가능한 역할은 다음과 같습니다:

앱 개발자 — 번들 업로드 및 디바이스 관리 가능 (파괴적 작업 불가)
앱 업로더 — 앱 데이터 조회 및 번들 업로드 가능
앱 조회자 — 읽기 전용 액세스

채널 권한 재정의

Members 섹션에서 채널 권한 사용자의 기본 채널 권한을 재정의하려면 사용자 옆의 버튼(방패 아이콘)을 클릭하세요:

모달에는 사용자의 현재 앱 역할이 표시되며, 개별적으로 재정의 가능한 세 가지 권한을 가진 모든 채널 목록이 나타납니다:

권한	설명
Read	채널 및 현재 번들 확인
History	번들 할당 이력 보기
번들 연결	채널의 활성 번들 설정 또는 변경

각 권한의 기본값은 기본값 (허용) — 즉, 앱 역할을 상속받음을 의미합니다. 특정 권한을 명시적으로 허용 또는 거부 하도록 특정 채널에 대해 설정하여, 사용자의 전체 앱 역할을 변경하지 않고도 세밀하게 제어할 수 있습니다.

그룹

Groups를 사용하면 개별 멤버를 일일이 관리하는 대신 사용자 그룹에 역할을 한 번에 할당할 수 있습니다. 그룹은 조직(organization)에 속하며, 조직(org) 또는 앱(app) 등 모든 범위에서 역할 바인딩을 가질 수 있습니다.

예시: “QA Team” 그룹을 생성하고, 여기에 앱 개발자 프로덕션 앱에 대한 역할을 그룹에 부여하면, 해당 그룹의 모든 멤버에게 즉시 그 앱의 Developer 권한이 부여됩니다. 팀원이 합류하거나 떠날 때 그룹에서 추가하거나 제거하기만 하면 되므로, 개별 권한 설정을 일일이 수정할 필요가 없습니다.

그룹 작동 방식

그룹이란 조직 범위(org-scoped) — 하나의 조직에 속하며 여러 조직에 걸쳐 존재할 수 없습니다.
사용자에게 역할을 부여하는 것과 동일한 방식으로 그룹에 역할을 부여할 수 있습니다. 즉, 역할 바인딩 시 그룹이 하나의 주체(principal)로 나타납니다.
사용자의 권한을 확인할 때, 해당 사용자가 속한 그룹 멤버십이 자동으로 확인됩니다. 속한 그룹 중 하나라도 필요한 권한을 가진 역할을 보유하고 있다면 액세스가 허용됩니다.
사용자는 여러 그룹에 속할 수 있으며, 모든 그룹의 권한이 합산되어 적용됩니다.

그룹 보기

다음으로 이동하세요: 그룹 탭은 조직 설정에 있습니다. 그룹 목록에는 각 그룹의 이름, 설명, 역할, 생성일, 그리고 작업 (수정 또는 삭제).

그룹 생성하기

Members 섹션에서 + 추가 그룹 생성 페이지를 여는 버튼:

다음 항목을 입력하세요:

이름 (필수) 및 설명 (선택)
조직 역할 — 조직 레벨 역할 선택 (없음, Admin, Billing Manager, Member)
접근 제어 탭 — 클릭하여 앱 수준의 역할을 할당합니다. + 앱 추가, 앱을 선택하고 역할(예: App Uploader, App Developer)을 지정합니다.

다음 작업이 슈퍼 관리자 또는 관리자 필요합니다: 그룹 생성.

그룹 멤버 관리

그룹을 클릭하여 상세 보기를 엽니다. 다음으로 전환하세요: 멤버 탭:

여기에서 현재 멤버와 이메일 주소를 확인할 수 있습니다. 멤버를 추가하려면 + 추가 를 클릭하세요:

모달에서 조직의 모든 멤버를 확인할 수 있습니다. 이름으로 검색한 뒤 추가할 멤버를 선택하고 멤버 추가.

결제

만 슈퍼 관리자 (org_super_admin) 및 결제 관리자 (org_billing_admin)만 결제를 관리할 수 있습니다. 플랜은 개인 계정이 아닌 조직에 연결됩니다.

자주 묻는 질문

조직을 여러 개 만들 수 있나요?

네. 필요한 만큼 조직을 생성할 수 있으며, 사이드바의 조직 선택기를 통해 간편하게 전환할 수 있습니다.

보안 정책은 어떻게 설정하나요?

Super Admin은 API 키 보안, 2FA 강제 적용, 비밀번호 정책을 보안 탭. 확인하세요 조직 보안 에서 확인하세요.

특정 앱이나 채널에만 접근 권한을 줄 수 있나요?

네 — Members 페이지나 앱의 Access 탭에서 앱 개발자 또는 앱 조회자) Members 페이지 또는 앱의 Access 탭에서 관리할 수 있습니다. 또한 다음을 사용하여 채널별로 액세스 권한을 세부적으로 조정할 수 있습니다. 채널 권한 오버라이드(channel permission overrides). 참조 액세스 제어 레퍼런스 를 사용하세요. 역할 전체 목록은 여기에서 확인 가능합니다.

Admin과 App Admin의 차이점은 무엇인가요?

관리자 (org_admin) 조직 전체에 대한 권한을 가집니다. 모든 앱, 모든 채널, 모든 멤버를 관리할 수 있습니다. 앱 관리자 (app_admin) 동일한 수준의 제어 권한을 갖지만, 특정 앱과 해당 채널에만 국한됩니다. 조직의 다른 부분에 대한 권한은 주지 않으면서 특정 앱의 모든 제어권을 위임하고 싶을 때 App Admin을 사용하세요.

Organization에서 계속하기

사용 중이라면 조직 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 구현 세부 사항은 API 키에서 기기 구현 세부 사항은 기기에서, 그리고 번들 Bundles의 구현 세부 사항은