詳細な権限

詳細な権限を使うと、リポジトリ内の特定のファイルおよびフォルダーに対して、きめ細かなアクセス制御を設定できます。ユーザーにリポジトリ全体へのアクセスを与える代わりに、パスレベルで読み取り、書き込み、マージ、管理を制限できます。

詳細な権限を使うべき場合

詳細な権限は、以下のような場合に便利です:

機密性の高いパスを保護: セキュリティ上重要なコード、設定ファイル、本番アセットをチームメンバーが変更するのを防ぐ
役割で制限: デザイナーはアセットのみを変更し、開発者はコードで作業できるようにする
コンポーネントを分離: チームがリポジトリの特定の部分で作業でき、他の部分にはアクセスできないようにする

アクセスレベル

Diversion は 4 つの階層型アクセスレベルを使用します:

レベル	説明
Admin	完全な制御
Write	ファイルを変更可能
Merge	マージ操作に参加可能
Read	ファイル閲覧のみ可能

アクセスレベルは階層型です: Admin は Write のすべての権限を含み、それは Merge を、それは Read を含みます。各レベルで何ができるかの詳細については、アクセスレベルを参照してください。

権限タイプ

各ルールは、アクセスがどのように付与または拒否されるかを制御する 4 つの権限タイプのいずれかを使用します:

タイプ	挙動
Allow (Hierarchical)	指定されたレベルとすべての下位レベルを付与します。例: Allow (Hierarchical) + Write は Write と Read アクセスを付与します。
Allow (Exact)	指定された正確なレベルのみを付与します。例: Allow (Exact) + Write は Write を付与しますが Read は付与しません。
Deny (All Above)	ルール評価を停止し、すべてのアクセスレベルを拒否します (レベルフィールドは無視されます)。より優先度の高いルール (テーブルで下位) によってすでに付与された権限は保持されます。
Deny (Exact)	指定された正確なレベルのみを拒否します。例: Deny (Exact) + Write は Write を拒否しますが Read を許可します。

ほとんどの場合、自然な権限継承を付与する Allow (Hierarchical) を使用してください。他のレベルに影響を与えずに特定のレベルを付与または拒否する必要がある場合 (例: Write を拒否するが Read は維持) は、Exact タイプを使用します。

パスパターン

パスパターンは、ルールが適用されるファイルを指定します。パターンは常に / で始まり、リポジトリルートを表します。

ワイルドカード	挙動
`*`	単一のディレクトリ内でのみ一致
`...`	すべてのサブディレクトリを再帰的に一致

以下は一般的なパターンです:

パターン	一致対象
`/path/to/file.txt`	正確なファイル一致
`/path/...`	`/path/` 配下のすべてのファイル (再帰)
`/path/....py`	`/path/` 配下のすべての `.py` ファイル (再帰)
`/path/*`	`/path/` 直下のすべてのファイル (サブディレクトリを除く)
`/path/prefix*`	`/path/` 内の「prefix」で始まるファイル

ルールの優先順位

ルールは テーブルの下から上へ 評価されます。複数のルールが一致する場合、最高の権限が優先 されます — Deny ルールが評価を停止しない限り。

テーブルで下位のルールほど 優先度が高い です。Deny ルールはその上の Allow ルールを上書きできます。

例: 複数の Allow ルール

#	ユーザー	パス	レベル	タイプ
1	alice	/src/…	Write	Allow (Hierarchical)
2	alice	/src/secret/…	Read	Allow (Hierarchical)

Alice が /src/secret/config.json にアクセスするとき:

両方のルールが一致
最高の権限 (Write) が付与される
結果: Alice は /src/secret/ 内のファイルに Write 可能

例: Deny を使ってアクセスを制限

#	ユーザー	パス	レベル	タイプ
1	alice	/src/…	Write	Allow (Hierarchical)
2	alice	/src/secret/…	Write	Deny (All Above)

Alice が /src/secret/config.json にアクセスしようとしたとき:

ルール 2 が最初に一致 (下位、最高優先度) — 評価を停止し、すべてのアクセスを拒否する
ルール 1 は決して評価されない
結果: Alice は /src/secret/ 内のファイルにアクセス不可

Deny (All Above) は終端ルールです。一致すると評価は直ちに停止し、その上のルールは一切チェックされません。より優先度の高いルール (テーブルで下位) によってすでに付与された権限は保持されます。

UI ではルールをドラッグして並び替え、優先度を変更できます。

権限の割り当て

権限は以下に割り当てることができます:

個々のユーザー - 特定のチームメンバーにルールを適用します
グループ - グループのすべてのメンバーにルールを適用します (組織が必要)。個々のユーザーよりもグループを優先してください — チームが成長したときに権限の管理が楽になります。

各ルールは、ユーザーまたはグループのいずれか一方をターゲットにする必要があり、両方はできません。同じパターンを両方に適用する必要がある場合は、別々のルールを作成してください。