組織

インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。

Organizationとは？

Organizationを使用すると、チーム内でアプリを共有しながら、誰が何を行えるかを正確に制御できます。すべての Capgo アカウントは少なくとも1つのOrganizationに所属しており、必要に応じて複数のOrganizationを作成できます。

アクセス管理は、 ロールベースのアクセス制御（RBAC）を通じて行われます。各チームメンバーには、Organizationレベルまたは特定のアプリに限定されたロールが割り当てられ、それによって閲覧・操作権限が決定されます。また、Channelごとの権限上書き設定により、Channelアクセスの詳細な微調整も可能です。

Organization設定の概要

Organization設定ページは、以下をクリックしてアクセスします：設定の左サイドバーから、上部の組織タブを選択してください。そこから、以下のセクション間を移動できます：

タブ	説明
一般	組織名、ロゴ、管理用メールアドレスの表示と編集
メンバー	チームメンバーと権限の管理
グループ	ロールの一括割り当て用にユーザーグループを作成・管理
API キー	プログラムによるアクセス用の API キーを管理
プラン	サブスクリプションプランの確認と管理
クレジット	追加クレジットの確認と購入
セキュリティ	セキュリティポリシーの設定 (2FA、パスワード要件)
使い方	組織の使用統計をモニタリング
監査ログ	組織のアクティビティログを表示
Webhooks	Webhook連携の設定
請求	請求情報と請求書の管理

Organizationの切り替え方法

次の 組織セレクター サイドバー左上にあるドロップダウンから、アクセス権を持つ組織の表示や切り替えが可能です。

メンバーの管理

メンバーの表示

Membersセクションには、組織へのアクセス権を持つすべてのユーザーが以下の情報とともに表示されます：

メンバー・アバターと名前
ロール・現在のロール（Super Admin、Admin、Billing Manager、またはMember）および 提供中 または 保留中 のバッジ
アクションロールの編集、アプリレベルのアクセス管理、または組織からの削除を行います

アクティブなメンバーはロールの優先順位順に表示されます。保留中の招待にはオレンジ色の 保留中 バッジが表示されます。

メンバーの招待

次をクリックします： + 追加 Membersセクションのボタン
A ロールを選択 モーダルが表示されます。新しいメンバーに割り当てる組織レベルのロールを選択してください：

利用可能な組織レベルのロールは以下の通りです：

メンバー — 読み取り専用アクセス
請求マネージャー — 請求管理のみのアクセス
管理者 — フル管理者（請求・削除不可）
スーパー管理者 — 全権限（管理者）

クリック確認、その後招待フォーム（メールアドレス、任意の名・姓、CAPTCHA）を入力し、以下をクリックします： 招待を送信.

招待されたユーザーにマジックリンク付きのメールが届きます。ユーザーが承認すると、選択されたロールで組織に追加されます。

アプリレベルのロール割り当て

組織レベルのロールに加えて、特定のアプリに対してより詳細なロールをメンバーに付与できます。メンバーの横にある アクセス制御 ボタン（シールドアイコン）をクリックして、アプリアクセスのモーダルを開きます：

このモーダルでは以下の操作が可能です：

アプリの検索と選択
ドロップダウンからアプリレベルのロールを選択してください

利用可能なアプリレベルのロールは以下の通りです：

アプリ管理者 — アプリのフル管理権限
アプリ開発者 — bundleのアップロードやデバイス管理が可能（破壊的な操作は不可）
App Uploader — アプリデータの読み取りとbundleのアップロードが可能
App Reader — アプリへの読み取り専用アクセス

クリック 割り当て ロールを付与します。

メンバーのロールを編集する

メンバーの横にある編集ボタン（レンチアイコン）をクリックして、組織レベルのロールを変更します。同様に、 ロールを選択 現在のロールが事前選択された状態でモーダルが表示されます。

制約事項:

組織作成者のロールは変更できません
最後のSuper Adminを削除することはできません。必ず少なくとも1名は必要です。
Super Adminの昇格または降格を行うには、自身がSuper Adminである必要があります

メンバーの削除

メンバーの横にある削除ボタン（ゴミ箱アイコン）をクリックします。この操作は取り消せない旨の確認ダイアログが表示されます。「削除」をクリックして確定してください。これにより、そのメンバーの組織、アプリ、およびチャンネルへのすべてのアクセス権が即座に無効化されます。

ロールの概要

Capgo は ロールベースのアクセス制御（RBAC） ロールはスコープごとに整理されています。ロールは以下のいずれかのレベルで割り当て可能です：組織レベル（すべてのリソースへのアクセス）、または特定の アプリ。チャンネルごとの権限の上書き設定により、アクセス権をさらに細かくカスタマイズできます。

組織のロール

メンバーを招待する際に割り当てます。組織全体に適用されます。

ロール	内部名	説明
スーパー管理者	`org_super_admin`	フルコントロール — 請求、削除、譲渡。組織の作成者に自動的に付与されます。
管理者	`org_admin`	フル管理者 — メンバー、アプリ、チャンネルの管理。請求や削除は不可。
請求マネージャー	`org_billing_admin`	請求のみ — 支払い、請求書、請求監査の表示・更新が可能。アプリやメンバーへのアクセス権はありません。
メンバー	`org_member`	組織全体およびすべてのアプリに対する読み取り専用アクセス。

アプリのロール

単一のアプリに限定されます。チームメンバーに組織全体ではなく1つのアプリだけを担当させたい場合に使用します。

ロール	内部名	説明
アプリ管理者	`app_admin`	単一アプリのフルコントロール — チャンネル、デバイス、チームを管理。アプリの削除や譲渡はできません。
アプリ開発者	`app_developer`	bundleのアップロード、デバイス管理、buildの実行、channelの更新が可能です。削除や設定変更はできません。
アプリアップローダー	`app_uploader`	読み取り権限 + 新しいbundleバージョンのアップロード権限。
アプリリーダー	`app_reader`	読み取り専用 — stats、bundles、channels、logs、devices。

Channel権限の上書き

デフォルトでは、channelへのアクセス権はアプリロールから継承されます。ユーザーまたはグループごとに特定のchannel権限を上書きできます。例えば、App Readerに対して、その staging channelへのbundle紐付けを許可するといった設定が可能です。詳細はアプリレベルのアクセス管理のセクションで設定方法を確認してください。

アプリレベルのアクセス管理

各アプリには専用の アクセス権 タブがあり、アプリへのアクセス権を持つユーザーや、アプリロール、チャンネルごとの権限の上書きを含む、実行可能な操作を管理できます。

アプリのアクセス権を確認する

アプリに移動し、 アクセス権 タブをクリックします。アクセスリストには、各ユーザーまたはグループと以下の情報が表示されます：

メールアドレス — ユーザーのメールアドレス（またはグループ名）
ロール — アプリレベルのロール（App Admin、App Developer、App Uploader、または App Reader）
付与日 — ロールが割り当てられた日時
アクション — チャンネル権限（シールドアイコン）、ロールの編集（レンチアイコン）、および削除（ゴミ箱アイコン）

アプリのロールを変更する

次をクリックします：編集ユーザーの横にあるボタン（レンチアイコン）をクリックして、アプリレベルのロールを変更します：

新しいロールを選択して、以下をクリックします：確定。利用可能なロールは以下の通りです：

アプリ開発者 — bundleのアップロードやデバイス管理が可能（破壊的な操作は不可）
App Uploader — アプリデータの読み取りとbundleのアップロードが可能
App Reader — 読み取り専用アクセス

チャンネル権限の上書き

次をクリックします： チャンネル権限 ユーザーのデフォルトのチャンネル権限を上書きするための、ユーザーの横にあるボタン（シールドアイコン）:

このモーダルには、ユーザーの現在のアプリロールが表示され、個別に上書き可能な3つの権限を持つすべてのチャンネルがリストされます:

権限	説明
Read	チャンネルとその現在のbundleを表示
履歴	bundleの割り当て履歴を表示
bundleを紐付け	チャンネルの有効なbundleを設定または変更

各権限のデフォルトは デフォルト (許可) — つまり、アプリロールを継承することを意味します。特定の権限を明示的に許可または拒否特定のチャネルに対して設定でき、ユーザーの全体的なアプリロールを変更せずに、きめ細かな制御が可能です。

グループ

Groupsを使用すると、メンバー一人ひとりを個別に管理する代わりに、ユーザーセットに対して一括でロールを割り当てることができます。グループは組織に属し、組織（org）またはアプリ（app）の任意のスコープでロールのバインディングを持つことができます。

例: 「QA Team」グループを作成し、以下のロールを割り当てます： アプリ開発者 本番アプリのロールをグループに設定すると、そのグループの全メンバーに即座にそのアプリへのDeveloperアクセス権が付与されます。メンバーの加入や脱退が発生した際は、グループへの追加・削除を行うだけで済み、個別のロール設定を変更する必要はありません。

グループの仕組み

グループとは 組織（org）単位の — 1つの組織に属し、複数の組織をまたぐことはできません。
ユーザーにロールを割り当てるのと同じ方法で、グループにロールを割り当てることができます。ロールのバインディングにおいて、グループはプリンシパルとして扱われます。
ユーザーの権限がチェックされる際、所属するグループへのメンバーシップが自動的に解決されます。所属するいずれかのグループが、必要な権限を持つロールを有していれば、アクセスが許可されます。
ユーザーは複数のグループに所属でき、すべてのグループの権限が合算されます。

グループの表示

に移動し、 グループ タブを開きます。グループ一覧には、各グループの名前, 説明, ロール, 作成日や アクション （編集または削除）が表示されます。

グループの作成

次をクリックします： + 追加 グループ作成ページを開くボタン:

以下の項目を入力してください:

名称 (必須) および説明 (任意)
組織ロール — 組織レベルのロールを任意で割り当てます (None, Admin, Billing Manager, または Member)
アクセス制御 タブ — クリックしてアプリレベルのロールを割り当てます + Appを追加、アプリを選択し、ロール（例：App Uploader、App Developer）を選択します

には、 スーパー管理者 または 管理者 グループの作成が必要です。

グループメンバーの管理

グループをクリックして詳細ビューを開きます。次に メンバー タブ:

ここでは現在のメンバーとメールアドレスを確認できます。「 + 追加 」をクリックしてメンバーを追加します：

モーダルには組織の全メンバーが表示されます。名前で検索し、追加したいメンバーにチェックを入れて「 メンバーを追加.

請求

のみ スーパー管理者 (org_super_admin）、離れるときは 請求マネージャー (org_billing_admin) が請求管理を行えます。プランは個人アカウントではなく、組織に紐付けられます。

よくある質問

組織を複数作成できますか？

はい。必要な数だけ組織を作成でき、サイドバーの組織セレクターから簡単に切り替えられます。

セキュリティポリシーの設定方法は？

Super Adminは、APIキーのセキュリティ、2FAの強制、パスワードポリシーを セキュリティ タブから設定できます。詳細は組織のセキュリティをご覧ください。

特定のアプリやチャンネルだけにアクセス権を付与できますか？

はい — MembersページまたはアプリのAccessタブから、アプリスコープのロール（例： アプリ開発者 または アプリ閲覧者) Membersページ、またはアプリのAccessタブから行えます。また、{}を使用してチャンネルごとにアクセス権を詳細に設定することも可能です。チャンネルごとの権限の上書き設定。詳細はアクセス制御リファレンスにより、チャンネル単位でアクセス権を細かく調整できます。ロールの全リストについてはこちら。

AdminとApp Adminの違いは何ですか？

管理者 (org_admin) は組織全体（すべてのアプリ、すべてのチャネル、すべてのメンバー）に対して権限を持ちます。 アプリ管理者 (app_admin) も同等のコントロール権を持ちますが、対象は特定のアプリとそのチャネルのみに限定されます。組織内の他のリソースへのアクセス権を与えずに、特定のアプリの全権限を委譲したい場合は App Admin を使用してください。

Organizationから続行

使用している場合組織ダッシュボードと API の運用を計画するには、これを次と連携させます API の概要「API の概要」の実装の詳細については、はじめに「はじめに」における実装の詳細については、 API キー API Keys の実装の詳細については、デバイス Devices の実装詳細については、および Bundle Bundlesの実装詳細については