認証済み公開鍵を追加する

# ssh2_publickey_add

(PECL ssh2 >= 0.10)

ssh2_publickey_add — 認証済み公開鍵を追加する

### 説明

function ssh2_publickey_add(
resource `$pkey`,
string `$algoname`,
string `$blob`,
bool `$overwrite` = `false`,
array `$attributes` = ?
): bool

> 注意: この公開鍵サブシステムは、クライアントが認証 済 の 公開鍵をサーバー上で管理するために使用されます。 公開鍵認証によりリモートシステムで認証を行うには、かわりに ssh2_auth_pubkey_file() 関数を使用してください。

### パラメータ

`pkey`
  ssh2_publickey_init() が作成した、 公開鍵サブシステムのリソース。
`algoname`
  公開鍵のアルゴリズム。例: ssh-dss、ssh-rsa
`blob`
  生のバイナリデータとしての blob 形式の公開鍵。
`overwrite`
  指定したキーがすでに存在する場合に、それを上書きしますか?
`attributes`
  この公開鍵に代入する属性の連想配列。サポートされる属性の一覧は、 ietf-secsh-publickey-subsystem を参照ください。 必須属性を設定するには、属性名の先頭にアスタリスクをつけてください。 サーバーが必須属性をサポートしていない場合、追加処理は異常終了します。

### 戻り値

成功した場合に `true` を、失敗した場合に `false` を返します。

### 例

例1 ssh2_publickey_add() で公開鍵を追加する

    <?php
    $ssh2 = ssh2_connect('shell.example.com', 22);
    ssh2_auth_password($ssh2, 'jdoe', 'password');
    $pkey = ssh2_publickey_init($ssh2);

    $keyblob = base64_decode('
    AAAAB3NzaC1yc2EAAAABIwAAAIEA5HVt6VqSGd5PTrLRdjNONxXH1tVFGn0
    Bd26BF0aCP9qyJRlvdJ3j4WBeX4ZmrveGrjMgkseSYc4xZ26sDHwfL351xj
    zaLpipu\BGRrw17mWVBhuCExo476ri5tQFzbTc54VEHYckxQ16CjSTibI5X
    69GmnYC9PNqEYq/1TP+HF10=');

    ssh2_publickey_add($pkey, 'ssh-rsa', $keyblob, false, array('comment'=>"John's Key"));
    ?>

### 参考

- ssh2_publickey_init() - 公開鍵サブシステムを初期化する
- ssh2_publickey_remove() - 認証済み公開鍵を取り除く
- ssh2_publickey_list() - 現在認証済みの公開鍵の一覧を表示する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open