Skip to main content

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

Dify Enterprise では、組織管理者が新しいワークスペースの既定の権限構成を定義できるように、管理コンソール向けの RBAC テンプレートを提供しています。 管理コンソールのテンプレートは、既存ワークスペースの権限を直接変更しません。新しいワークスペースが作成されるときに継承される、初期ロールとリソース権限セットを定義します。

設定できる内容

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

Workspace Role Templates

Workspace Role Templates は、メンバーがワークスペース内で実行できる操作を定義します。新しいワークスペースは、このテンプレートに設定されたロールを継承します。 ページを開くには、Admin Console → Roles & Permissions → Workspace Role Templates に移動します。 このページには、既定のワークスペースロールが一覧表示されます。

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

システムプリセットロールは、Dify が標準で提供する組み込みロールです。アップグレード時の権限互換性を維持し、新しいワークスペースに安定した既定ロールモデルを提供するために使用されます。 主なシステムプリセットロールは次のとおりです。 システムプリセットロールは削除できません。アップグレード互換性を保護するため、一部の項目や権限範囲は読み取り専用になる場合があります。

Enterprise カスタムロール

Enterprise カスタムロールは、企業管理者が作成するロールです。組織内の責任範囲や運用ルールに合わせた権限モデルを定義できます。 実行できる操作は次のとおりです。
  • カスタムロールを作成する。
  • ロール名、説明、権限を編集する。
  • 不要になったロールを削除する。

ロールを作成する

  1. Create Role をクリックします。
  2. ロール名を入力します。
  3. ロールの説明を入力します。
  4. このロールに付与する権限を選択します。
  5. Save をクリックします。
権限は WorkspaceApplication など、製品領域ごとにグループ化されています。権限を検索したり、各グループを展開して個別の権限を選択したりできます。

ロールを編集する

  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 つのタブがあります。 新しいワークスペースは、これらの権限セットテンプレートを既定で継承します。ワークスペース管理者は、その後、自分のワークスペース内で権限セットを調整できます。

既定のアプリ権限セット

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

権限セットを作成する

  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. メンバーにロールを割り当て、リソースアクセスの動作を検証します。