# MongoDB\Driver\ClientEncryption::getKeyByAltName

(mongodb >=1.15.0)

MongoDB\Driver\ClientEncryption::getKeyByAltName — Renvoie un document clé par un nom alternatif

### Description

final public MongoDB\Driver\ClientEncryption::getKeyByAltName(string `$keyAltName`): ?object

Trouve un document clé unique dans la collection de coffre de clés avec le nom alternatif donné `keyAltName`.

### Liste de paramètres

`keyAltName`

  Le nom alternatif pour le document clé.

### Valeurs de retour

Renvoie le document clé, ou `null` si aucun document n'a été trouvé.

### Erreurs / Exceptions

- Lance une exception MongoDB\Driver\AuthenticationException si une identification est nécessaire mais qu'elle échoue
- Lance une exception MongoDB\Driver\ConnectionException si la connexion au serveur échoue pour une autre raison qu'en raison d'un problème d'identification
- Lance une MongoDB\Driver\Exception\RuntimeException sur d'autres erreurs.

### Voir aussi

- MongoDB\Driver\ClientEncryption::addKeyAltName() - Ajoute un nom alternatif à un document clé
- MongoDB\Driver\ClientEncryption::removeKeyAltName() - Enlève un nom alternatif d'un document clé