# ssh2_publickey_list

(PECL ssh2 >= 0.10)

ssh2_publickey_list — Liste les clés publiques actuellement autorisées

### Description

ssh2_publickey_list(resource `$pkey`): array

Liste les clés publiques actuellement autorisées.

### Liste de paramètres

`pkey`

  Ressource Publickey Subsystem.

### Valeurs de retour

Retourne un tableau de clés indexées numériquement, chacune d'elle est un tableau associatif contenant : nom, blob et éléments attrs.

Élément de clé publique
Clé Tableau | Signification
--- | ---
name | Nom de l'algorithme utilisé par cette clé publique, par exemple : `ssh-dss` ou `ssh-rsa`.
blob | Blob de clé publique comme données binaires brutes.
attrs | Attributs assignés à cette clé publique. L'attribut le plus commun et seulement celui supporté par la clé publique version 1 des serveurs est `comment`, qui peut être n'importe quelle forme de chaîne de caractères.

### Exemples

Exemple #1 Liste des clés autorisées avec ssh2_publickey_list()

`<?php
$ssh2 = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($ssh2, 'jdoe', 'secret');
$pkey = ssh2_publickey_init($ssh2);
$list = ssh2_publickey_list($pkey);
foreach($list as $key) {
echo "Clé : {$key['name']}\n";
echo "Blob : " . chunk_split(base64_encode($key['blob']), 40, "\n") . "\n";
echo "Commentaire : {$key['attrs']['comment']}\n\n";
}
?>`

L'exemple ci-dessus va afficher :

    Clé : ssh-rsa
    Blob : AAAAB3NzaC1yc2EAAAABIwAAAIEA5HVt6VqSGd5P
    TrLRdjNONxXH1tVFGn0Bd26BF0aCP9qyJRlvdJ3j
    4WBeX4ZmrveGrjMgkseSYc4xZ26sDHwfL351xjza
    Lpipu\BGRrw17mWVBhuCExo476ri5tQFzbTc54VE
    HYckxQ16CjSTibI5X69GmnYC9PNqEYq/1TP+HF10
    Commentaire : Clé de John

    Clé : ssh-rsa
    Blob : AAAAB3NzaHVt6VqSGd5C1yc2EAAAABIwA232dnJA
    AIEA5HVt6VqSGd5PTrLRdjNONxX/1TP+HF1HVt6V
    qSGd50H1tVFGn0BB3NzaC1yc2EAd26BF0aCP9qyJ
    RlvdJ3j4WBeX4ZmrveGrjMgkseSYc4xZ26HVt6Vq
    SGd5sDHwfL351xjzaLpipu\BGB3NzaC1yc2EA/1T
    Commentaire : Clé d'Alice

### Notes

> Note: Le publickey subsystem est utilisé pour gérer les clés publiques sur un serveur sur lequel le client est déjà identifié. Pour s'identifier à un system distant en utilisant l'identification par clé publique, utilisez la fonction ssh2_auth_pubkey_file() à la place.

### Voir aussi

- ssh2_publickey_init() - Initialise un Publickey Subsystem (sous-système de clé publique)
- ssh2_publickey_add() - Ajoute une clé publique autorisée
- ssh2_publickey_remove() - Supprime un clé publique autorisée