p4 pubkey (グラフ)
HelixサーバのSSHパブリックキーの追加、更新、削除を行います。
graph
タイプのディポのみになります。
構文規則
p4 [g-opts] pubkey -i [-u user] [-s scope] [-f]
p4 [g-opts] pubkey -d -u user | -s scope
説明
ユーザや管理者はこのコマンドを次のように使用します。
- サーバ上にユーザのSSHパブリックキーをアップロード
- ユーザの古いキーを上書きして強制的に更新
- ユーザのキーを削除する
範囲
サーバ上にユーザのSSHパブリックキーをアップロードする際に、明示的な指定がなければ、
キーは暗黙的な範囲名としてdefault
になります。
ユーザが1つ以上のコンピュータを持っている、従って1つ以上SSHキーがある場合、
キーごとに明示的なscope
の名前を割り当てることが推奨されます。
macintosh_laptop
やWindows_desktop
のような物理的な場所か、
home
、office
やserver1
のようなコンピュータ名が
典型的な範囲名です。
明示的に範囲を指定していない場合に、ユーザに関連付けられているキーを削除すると、
このコマンドにより、暗黙的なdefault
の範囲を持つキーが削除されます。
範囲を更新することはできませんが、キーを削除し、任意の範囲で新しいキーを 生成することができます。
すべてのキーと、特定のユーザのスコープの一覧を取得するには、
p4 pubkeys
トピックの「例」を参照してください。
キーのアップロードに必要なユーザ要件
list
にSSHパブリックキーをアップロードするための要件として、少なくとも、
プロテクションテーブル内のファイル名へのHelixサーバアクセス権が必要です。
Helixサーバ管理者が、プロテクションテーブルから、この最小限のアクセスのみの
賦与を望んでいると仮定しましょう。
スーパーユーザとして、管理者は、Protections
フォームを開き
p4 protect
コマンドを発行します。
管理者は、repoUsers
という名前のグループのメンバーが特定のファイルに
list
のアクセス権限を持っていることをProtections
フォームに定義します。
list group repoUsers * //depot/no-file.txt
なお、no-file.txt
は実際のファイルでなくても構いません。
管理者は、repoUsers
のグループ名でp4 group
コマンドを発行します。
$ p4 group repoUsers
管理者は、グループ定義のフォームに、repoUsers
グループに所属する
ユーザ名を追加します。
オプション
|
指定したユーザのキーを削除します。範囲を指定しない場合、
指定の |
|
|
|
標準入力のリダイレクトの指定された場所からSSHのパブリックキーをアップロードします。 |
|
範囲をパブリックキー割り当てます。ユーザが複数のキーを持っている場合に便利です。
範囲指定にこのオプションを使用しない場合、
範囲は |
-u username |
管理者は、特定のユーザにキーを関連付けることができます。 注意
指定したユーザが実際に存在するかどうかの検証チェックはありません。 |
|
「グローバルオプション」を参照してください。 |
使用上の注意点
ファイル引数でリビジョン指定子を使用できるか? | ファイル引数でリビジョン範囲を使用できるか? | 最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
super |
例
範囲指定アップロード
ユーザは、標準入力リダイレクトとキーの場所を示します。
どのコンピュータにキーが属するかを特定する、
明示的な範囲を指定することをお勧めします。明示的なスコープによって、
ユーザが誤ってdefault
を持つ暗黙のスコープを上書きするのを防ぎます。
p4 pubkey -i < path/to/your/.ssh/id_rsa.pub -s mac-laptop
管理者は、-u
usernameオプションを追加することで、
そのユーザのキーをアップロードできます。
p4 pubkey -i < path/to/your/.ssh/id_rsa.pub -u bruno -s mac-laptop
既存のキーの強制的な更新
次のようなメッセージが表示される場合:
Public Key for 'bruno/mac-laptop' already exists, use '-f' to replace.
既存キーの上書きを強制するには、-f
強制オプションを追加します。
p4 pubkey -f -u bruno -s mac-laptop -i < path/to/your/.ssh/id_rsa.pub
キーの削除
SSHパブリックキーとdefault
範囲を暗黙的に指定したユーザから削除する。
p4 pubkey -d -u bruno
SSHパブリックキーと範囲を指定したユーザから削除する。
p4 pubkey -d -u bruno -s windows-laptop
使用上の注意点
ファイル引数でリビジョン指定子を使用できるか? | ファイル引数でリビジョン範囲を使用できるか? | 最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
force-push create-ref: リファレンスが存在しない場合 |
関連コマンド
SSHパブリックキーを一覧表示する |