> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 権限テンプレートを設定する

> 新しいワークスペース向けの既定ロールテンプレートとリソース権限セットテンプレートを設定する方法を説明します。

# 権限テンプレートを設定する

Dify Enterprise では、組織管理者が新しいワークスペースの既定の権限構成を定義できるように、管理コンソール向けの RBAC テンプレートを提供しています。

管理コンソールのテンプレートは、既存ワークスペースの権限を直接変更しません。新しいワークスペースが作成されるときに継承される、初期ロールとリソース権限セットを定義します。

## 設定できる内容

管理コンソールで **Roles & Permissions** に移動すると、次の 2 種類のテンプレートを設定できます。

| テンプレート                               | 用途                                              |
| ------------------------------------ | ----------------------------------------------- |
| **Workspace Role Templates**         | 新しいワークスペースで既定で利用できるロールと、その権限範囲を定義します。           |
| **Resource Permission Set Template** | 新しいワークスペースで既定で利用できるアプリとナレッジベースのリソース権限セットを定義します。 |

## Workspace Role Templates

Workspace Role Templates は、メンバーがワークスペース内で実行できる操作を定義します。新しいワークスペースは、このテンプレートに設定されたロールを継承します。

ページを開くには、**Admin Console → Roles & Permissions → Workspace Role Templates** に移動します。

このページには、既定のワークスペースロールが一覧表示されます。

| 項目              | 説明                                      |
| --------------- | --------------------------------------- |
| **Role**        | ロール名です。                                 |
| **Type**        | システムプリセットロールか、Enterprise カスタムロールかを示します。 |
| **Description** | ロールの用途を簡単に説明します。                        |
| **Action**      | ロールの種類に応じて、詳細表示、編集、削除を実行できます。           |

### システムプリセットロール

システムプリセットロールは、Dify が標準で提供する組み込みロールです。アップグレード時の権限互換性を維持し、新しいワークスペースに安定した既定ロールモデルを提供するために使用されます。

主なシステムプリセットロールは次のとおりです。

| ロール                   | 説明                                   |
| --------------------- | ------------------------------------ |
| **Owner**             | メンバー、ロール、リソースを含むワークスペース全体を管理できます。    |
| **Admin**             | ほとんどのワークスペース設定、メンバー、ロール、リソースを管理できます。 |
| **Editor**            | アプリ、ナレッジベース、その他のコンテンツを作成・編集できます。     |
| **Normal**            | 割り当てられたリソースを表示・利用できますが、管理はできません。     |
| **Restricted Member** | 既定では機能やリソースへのアクセス権を持ちません。            |

システムプリセットロールは削除できません。アップグレード互換性を保護するため、一部の項目や権限範囲は読み取り専用になる場合があります。

### Enterprise カスタムロール

Enterprise カスタムロールは、企業管理者が作成するロールです。組織内の責任範囲や運用ルールに合わせた権限モデルを定義できます。

実行できる操作は次のとおりです。

* カスタムロールを作成する。
* ロール名、説明、権限を編集する。
* 不要になったロールを削除する。

### ロールを作成する

1. **Create Role** をクリックします。
2. ロール名を入力します。
3. ロールの説明を入力します。
4. このロールに付与する権限を選択します。
5. **Save** をクリックします。

権限は **Workspace** や **Application** など、製品領域ごとにグループ化されています。権限を検索したり、各グループを展開して個別の権限を選択したりできます。

### ロールを編集する

1. 編集したいロールの **Detail** をクリックします。
2. ロール名、説明、選択済みの権限を確認します。
3. 編集可能な項目を更新します。
4. **Save** をクリックします。

システムプリセットロールでは、編集できる項目が制限される場合があります。Enterprise カスタムロールでは、権限設計に合わせてロール設定を更新できます。

### カスタムロールを削除する

削除できるのは Enterprise カスタムロールのみです。

1. カスタムロールの横にある **Remove** をクリックします。
2. 確認ダイアログで削除を確認します。
3. 必要に応じて確認テキストを入力します。
4. **Remove** をクリックします。

ロールの削除は元に戻せません。削除する前に、そのロールに依存しているワークスペース設定がないことを確認してください。

## Resource Permission Set Template

Resource Permission Set Template は、新しいワークスペース向けに再利用可能なリソース権限レベルを定義します。

このテンプレートは、誰がリソースにアクセスできるかを決定するものではありません。メンバーが特定のリソースで権限セットを割り当てられた後に、どの操作を実行できるかを定義します。

ページを開くには、**Admin Console → Roles & Permissions → Resource Permission Set Template** に移動します。

ページには 2 つのタブがあります。

| タブ                                 | 用途                    |
| ---------------------------------- | --------------------- |
| **App permission sets**            | アプリで使用できる権限セットです。     |
| **Knowledge base permission sets** | ナレッジベースで使用できる権限セットです。 |

新しいワークスペースは、これらの権限セットテンプレートを既定で継承します。ワークスペース管理者は、その後、自分のワークスペース内で権限セットを調整できます。

### 既定のアプリ権限セット

| 権限セット               | 説明                                   |
| ------------------- | ------------------------------------ |
| **Full Control**    | アクセス設定を含め、アプリを完全に管理できます。             |
| **Edit Content**    | アプリのコンテンツと設定を編集できますが、アクセス制御は管理できません。 |
| **View Monitoring** | アプリの実行履歴、ログ、モニタリングデータを表示できます。        |
| **Preview App**     | 一覧でアプリを確認できますが、詳細は開けません。             |

### 既定のナレッジベース権限セット

| 権限セット                      | 説明                                       |
| -------------------------- | ---------------------------------------- |
| **Full Control**           | アクセス設定を含め、ナレッジベースを完全に管理できます。             |
| **Edit Content**           | ナレッジベースのコンテンツと設定を編集できますが、アクセス制御は管理できません。 |
| **Preview Knowledge Base** | 一覧でナレッジベースを確認できますが、詳細は開けません。             |

### 権限セットを作成する

1. **App permission sets** または **Knowledge base permission sets** タブを開きます。
2. **Create app permission set** または **Create knowledge base permission set** をクリックします。
3. 権限セット名を入力します。
4. 説明を入力します。
5. この権限セットに含めるリソース権限を選択します。
6. **Confirm** をクリックします。

権限セットは、再利用可能なショートカットとして設計されています。たとえば、**Edit Content** というアプリ権限セットには、アプリコンテンツの編集やアプリ設定の更新などの権限を含めることができます。

### 権限セットを編集する

1. 権限セットの横にある **...** メニューをクリックします。
2. **Edit** を選択します。
3. 名前、説明、付与する権限を更新します。
4. **Confirm** をクリックします。

権限セットテンプレートを編集すると、新しいワークスペースが継承するテンプレート内容に影響します。既存ワークスペース内で既にカスタマイズされた権限設定は、自動的には上書きされません。

### 権限セットを削除する

1. 権限セットの横にある **...** メニューをクリックします。
2. **Delete** を選択します。
3. 確認ダイアログで削除を確定します。

権限セットの削除は元に戻せません。既定のワークスペース設定に必要な権限セットの場合は、削除しないでください。

## 注意事項

* 管理コンソールのテンプレートは新しいワークスペースに適用されます。
* 既存ワークスペースは、手動で更新しない限り現在のロールと権限設定を保持します。
* ワークスペースロールは、メンバーがワークスペースレベルで実行できる操作を定義します。
* リソース権限セットは、アプリとナレッジベースで再利用できる権限レベルを定義します。
* メンバー単位でリソースアクセスを制御する場合は、対象リソースのアクセス設定で個別に設定する必要があります。

## 推奨設定フロー

1. まず **Workspace Role Templates** を設定します。
2. 次に、アプリとナレッジベースの **Resource Permission Set Template** を設定します。
3. テスト用ワークスペースを作成します。
4. 新しいワークスペースに想定どおりのロールと権限セットが継承されているか確認します。
5. メンバーにロールを割り当て、リソースアクセスの動作を検証します。
