> For the complete documentation index, see [llms.txt](https://studio-docs.japan-ai.co.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.japan-ai.co.jp/guan-li-yun-yong/understand-org-project-app-permissions.md).

# 組織・Project・Appの権限を理解する

JAPAN AI Studioでは、組織・Projectを管理する権限と、Appを利用・設定する条件は別です。変更前に、任せる操作範囲を整理します。

この記事は、管理者が組織・Project・Appの権限関係を判断するための説明です。招待・ロール変更・削除は[Project・Appのメンバーを管理する](/guan-li-yun-yong/manage-project-and-app-members.md)、初期設定は[Appの初期設定を完了する](/u/complete-app-setup.md)を参照してください。

## この記事の範囲

ここでは、次の3層を区別します。

1. **組織ロール**：組織のメンバーとしての基本ロールです。組織の設定、メンバー、組織全体のリソースに関わる操作の土台になります。
2. **Projectロール**：個別のProjectに参加した人へ付くロールです。Project内のリソースを閲覧・利用・作成・管理する範囲を決めます。
3. **App固有の条件**：インストール済みAppを開く・利用する・設定するための条件です。Projectへのアクセスに加え、利用者登録、利用人数、接続やSecretなどが影響する場合があります。

個別リソースの設定手順は扱いません。詳細なエラー切り分けは、[権限・認証エラー](/toraburushtingu/permission-and-auth-errors.md)を参照してください。

> **組織に所属していること、Projectに参加していること、Appを業務で使えることは同じ状態ではありません。** いずれか一つを満たしていても、別の条件が不足すれば対象の操作はできません。

## まず押さえる権限の全体像

| 層       | 主な管理対象                             | 代表的なロール・条件                      | 主に管理する人              | この層だけでは決まらないこと           |
| ------- | ---------------------------------- | ------------------------------- | -------------------- | ------------------------ |
| 組織      | 組織設定、組織メンバー、組織全体のリソース              | 「管理者」「編集者」「メンバー」、必要に応じてIAMロール   | 組織の管理者               | 個別Projectへの参加、Appごとの利用可否 |
| Project | Projectのメンバー、Agent・Workflow・Pageなど | 「管理者」「編集者」「メンバー」「閲覧者」           | Projectの管理者          | 利用人数、外部サービス側の権限、App固有の設定 |
| App     | インストール済みAppの利用者、設定、必要な接続・Secret    | Projectへのアクセス、利用者・利用人数、App固有の要件 | Appを管理するProject管理者など | 組織全体の管理権限、利用者本人の外部サービス権限 |

IAMは、基本ロールで足りない操作を補う仕組みです。「IAMロール設定」が表示される組織・Projectでは、システムロールと「カスタムロール」を確認できます。

> IAMロールを付けただけで、Projectへ未参加の人を利用者として扱わないでください。対象者のProject参加状況も確認します。

## 組織ロールで決まること

組織ロールは、組織に対する基本的な操作範囲です。基本ロールには「管理者」「編集者」「メンバー」があります。

| 組織ロール | 主にできること                         | 管理上の考え方                          |
| ----- | ------------------------------- | -------------------------------- |
| 管理者   | 組織と組織全体のリソースを広く管理します。           | 組織設定やメンバー管理を担当する人に限定します。         |
| 編集者   | IAM管理以外の組織全体のリソースを管理できる範囲があります。 | 管理者と同じ操作が常にできるわけではありません。         |
| メンバー  | 許可されたリソースを閲覧・実行する基本となります。       | すべてのProjectやAppへ自動参加するわけではありません。 |

Appの導入可否は、組織ロールだけでなく、IAMや提供条件にも左右されます。

## Projectロールで決まること

Projectロールは、対象Project内での役割です。「管理者」「編集者」「メンバー」「閲覧者」があり、画面で選べる候補は設定により異なる場合があります。

| Projectロール | Project内の主な範囲               | メンバー管理・Project管理      | 向いている担当    |
| ---------- | --------------------------- | --------------------- | ---------- |
| 管理者        | Projectリソースへのフルアクセスが基本です。   | 設定やメンバー管理を担います。       | Project責任者 |
| 編集者        | Projectリソースを作成・更新・削除します。    | 管理操作の一部は行えません。        | 構築担当       |
| メンバー       | 閲覧・実行が基本です。対象により作成・更新もできます。 | Project全体の管理者ではありません。 | 業務利用者      |
| 閲覧者        | 読み取り専用です。                   | 作成・更新・削除を前提にしません。     | 内容確認者      |

Projectの「管理者」は組織の「管理者」とは別です。組織設定や組織全体の導入まで任せることにはなりません。

最後の管理者を削除・降格・退出させる前に、後任を設定してください。

## App固有の条件を重ねて確認する

Appを開けるかは、まず対象Projectへのアクセス権を確認します。

Appで実際に業務を行えるかは、次の順で確認します。

1. **組織**：利用者が正しい組織に所属しているかを確認します。
2. **Project**：対象AppのProjectへ参加し、目的に合うProjectロールかを確認します。
3. **Appの利用条件**：利用者登録、利用人数、契約上の条件を確認します。
4. **共有範囲**：App内のAgent、Page、Workflow、Datasetなどが利用者に公開・共有されているかを確認します。
5. **設定と認証**：共有接続、Project Secret、本人の接続、外部サービス側のアクセスが必要かを確認します。

> **Projectに参加しても、Appのすべての操作が自動的に可能になるわけではありません。** 利用人数、設定、公開範囲、接続先サービス側の権限も確認します。

## 共有範囲とロールを混同しない

ロールは「その人が変更・実行できる操作の範囲」、共有範囲は「どの人が対象リソースを見つけて利用できるか」の条件です。両方を満たして初めて、期待した操作ができます。

| 状況                                     | 起こりうること                                     | 確認すること                         |
| -------------------------------------- | ------------------------------------------- | ------------------------------ |
| Projectに参加済みだが、対象AgentやWorkflowが見つからない | リソースの共有・公開範囲が対象者を含まない可能性があります。              | 対象リソースの公開状態、共有先、利用権限           |
| リソースは表示されるが、編集できない                     | ProjectロールまたはIAMの変更権限が不足している可能性があります。       | Projectロール、カスタムロール、対象リソースのポリシー |
| Appは開けるが、機能の実行に失敗する                    | 接続、Secret、外部サービス側の権限、利用人数条件などが未完了の可能性があります。 | 表示された案内、Appの設定状態、利用者本人の認証      |
| 共有リンクを受け取ったが開けない                       | リンク共有とアクセス権付与が別になっている可能性があります。              | 正しい組織、Project参加状態、共有範囲         |

組織全体やProject全体へ共有すると、閲覧できる人が広がります。共有範囲を広げて権限不足を回避せず、必要な利用者・操作・データを先に決めます。

## よくある誤解

* **組織管理者なら、すべてのAppをすぐに利用できる**とは限りません。Project参加、利用人数、接続を確認します。
* **Project管理者なら、組織メンバーや契約も管理できる**わけではありません。
* **編集者なら、必ずメンバーを管理できる**とは限りません。ロール、IAM、画面の操作可否を確認します。
* **閲覧できるなら、実行もできる**とは限りません。
* **共有リンクを送れば、権限設定は不要**ではありません。

## 確認できない場合

画面に「メンバー」「IAMロール設定」「設定」が表示されない、または期待した操作ができない場合は、次を確認します。

1. 正しい組織、Project、Appを開いているか確認します。
2. 対象者の組織・Projectへの参加状況を確認します。
3. 組織ロール、Projectロール、IAMのどこが不足しているかを分けます。
4. Appでは利用者登録、利用人数、設定、接続の案内を確認します。
5. 解消しなければ、画面と表示メッセージを添えて管理者へ相談します。Secretの値は共有しません。

## 管理前チェックリスト

* [ ] 組織管理とProject管理が必要な人を分けた
* [ ] 組織ロールとProjectロールを別々に確認した
* [ ] Appの利用条件を参加・利用人数・設定・共有範囲に分けた
* [ ] IAMは基本ロールで不足する操作だけに使った
* [ ] 最後のProject管理者を外さないことを確認した

## 次に読む記事

* [Project・Appのメンバーを管理する](/guan-li-yun-yong/manage-project-and-app-members.md)
* [Appの初期設定を完了する](/u/complete-app-setup.md)
* [権限・認証エラー](/toraburushtingu/permission-and-auth-errors.md)
