p4 protect

ユーザによるファイル、ディレクトリ、コマンドへのアクセスを管理します。

構文規則

p4 [g-opts] protect
p4 [g-opts] protect -o
p4 [g-opts] protect -i
p4 [g-opts] protect --convert-p4admin-comments -o | -i

サブプロテクションの場合:

p4 protect path
p4 protect -o path
p4 protect -i path

説明

p4 [g-opts] protectコマンドを実行すると、superアクセス権限を持つユーザが、プロテクションテーブルをテキスト形式で編集できるようになります。

以下のいずれかの方法でHelixサーバの権限を設定する場合は、 p4 protectコマンドを使用します。

• 特定のユーザがアクセスできるコマンドを制御する
• 特定のユーザが実行できるコマンドを制御する
• p4 groupコマンドを使用して定義されたユーザグループに対して権限を付与する
• ユーザまたはグループの特定のパスについて、p4 protectコマンドへのアクセス権限を付与する
• =read、=open、=write、=branchを 除外マッピングと組み合わせて使用する
• 特定のIPアドレスのみにアクセスを制限する

通常は、list、read、write、 owner、superのいずれかのアクセス権を指定します。 openとreviewアクセスレベルは あまり使用されません。

通常は、以下のような運用方法になります。

1. 以下のいずれかに対して、特定のアクセスレベルを付与します。
   • グループ(ベストプラクティスとしてお勧めします)
   • 個別のユーザ(複数のユーザを1つのグループにまとめることができない場合)
2. アクセスレベルを詳細に制御する必要がある場合は、1つ以上のアクセス権限を 個別に除外します。

権限レベルとアクセス権

権限レベル名に「=」というプレフィックスが付いている場合、その権限が拒否されるということを表しています。

サブプロテクション

superアクセス権を持つユーザはサブプロテクションを使用して、super権限を持っていないユーザやグループに対して、プロテクションテーブルの一部の管理を委任することができます。これを行うには、ownerを使用して、エントリをモードとして作成します。これらのエントリでは、ワイルドカードを使用せずに一意のパスを指定する必要があります。ただし、末尾に「...」を指定することができます。

super権限を持っているユーザや、パスに対するowner権限が付与されているユーザは、許可されているパスを引数として指定してp4 protectコマンドを実行することにより、そのパスのサブプロテクションテーブルにアクセスすることができます。

サブプロテクションテーブル内のすべてのエントリが、ownerエントリ直下の対応するプロテクションテーブルに追加されます。

• ownerエントリを削除すると、そのエントリのパスに対するサブプロテクションテーブル内のエントリがすべて削除されます。

• owner権限を持っているユーザは、指定されたパスのサブプロテクションテーブルにのみアクセスすることができます。そのパスのユーザやグループにアクセスすることはできません。

• owner権限を持つユーザは、指定したパス上で、自分自身に対してadmin権限を設定することができます。

• ownerエントリやsuperエントリをサブプロテクションテーブルに追加することはできません。その他のエントリのパスは、サブプロテクションテーブルのパスの範囲内にある必要があります。

「フォームフィールド」のサブパスを参照してください。

ストリーム仕様の権限

フォームフィールド

p4 protectを実行すると、Helixサーバは Protections:フィールドのみのフォームを表示します。 各権限は、 Protections:に見出しの下でインデントされた専用の行に指定され、 次の5つの値を使用してプロテクションを定義します。

コメント

プロテクションテーブルは解釈やデバッグが難しくなる場合があります。そのような場合にコメントを付け加えることで、 分かりやすくすることができます。

• ##記号を使用することで、行の最後にコメントを追加することができます。

  write user *   10.1.1.1   //depot/test/...  ## my comment

• または、行の先頭に##記号を付けることで、 コメント行を作成できます。

  ## my comment
  write user *   10.1.1.1   //depot/test/...

$ p4 protect --convert-p4admin-comments -o

オプション

使用上の注意点

各権限のレベルはその下にあるすべてのアクセスレベルを含みます。

特殊な権限である=read、=open、 =write、=branchを使用して、下位のアクセスレベルを自動的に 包含しないようにオーバーライドできます。これにより、後で下位の権限を 再設定することなく、権限を個別に無効にすることができます。

例えば、管理者に管理コマンドの実行権限を与えつつ、 ディポの特定の部分に対する変更権限を拒否したいという場合、 権限テーブルを次のように設定することができます。

Protections:
    admin       user      joe       *       //...
    =write      user      joe       *       -//depot/build/...
    =open       user      joe       *       -//depot/build/...

この例では、ユーザjoeは管理機能を実行でき、 この権限はシステム内のすべてのディポに適用されます。 admin権限レベルでは暗黙的にそれより下位にある すべてのアクセスレベルが認められるため、joeは //depot/build/を含むシステム内のどのファイルにも、開く操作、 書き込み、読み取り、一覧表示が可能です。buildの階層をプロテクトするには、 =writeおよび=openの排他行を テーブルに追加します。

• 「=open」排他行により、ユーザjoeは、//depot/build/ディレクトリ内のファイルを 編集用として開くことができなくなります:
• 「=write」排他行により、ユーザjoeは、//depot/build/ディレクトリ内で行った 変更内容をサブミットできなくなります:

あるサーバ上のファイルを別のサーバからのリモートディポとして 使用する(p4 depotで定義)のを制限したり排除するには、 remoteユーザ(または別のサーバが認証に用いるサービスユーザ)に対する プロテクションを作成してください。 リモートディポは、ユーザのPerforceサービスに関連付けられたサービスユーザか、 remoteという名前の仮想ユーザによってアクセスされます。

使用できるコマンドは、アクセスレベルによって決まります。例えば、p4 addは少なくともopenのアクセス権を必要とするため、 write、open、admin、またはsuperのアクセス権があれば p4 addを実行できます。

いくつかのコマンド(例えば、p4 changeで、以前サブミットされたチェンジリストを 編集するとき)は、管理者権限またはスーパーアクセス権限が必要な -fオプションを使用します。

各コマンドの詳細については、『Helix Coreサーバ管理者ガイド』の「Helixサーバコマンドが必要とするアクセスレベル」を参照してください。

関連コマンド