ssh2_auth_pubkey_file

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#
Notas#
Véase también#

Identificación utilizando una clave pública

Descripción#

ssh2_auth_pubkey_file(resource $session, string $username, string $pubkeyfile, string $privkeyfile, [string $passphrase]): bool
```php

Identificación utilizando una clave pública, leída desde un fichero.

## Parámetros

`session`  
Un identificador de conexión SSH, obtenido desde la función `ssh2_connect`.

`username`  
Nombre del usuario para autenticarse en el servidor remoto.

`pubkeyfile`  
El fichero que contiene la clave pública debe estar en formato OpenSSH. Debe parecerse a esto:

ssh-rsa AAAAB3NzaC1yc2EAAA....NX6sqSnHA8= rsa-key-20121110

`privkeyfile`  

`passphrase`  
Si `privkeyfile` está cifrado (y debe estarlo), la frase de paso debe ser proporcionada.

## Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

## Ejemplos

Identificación utilizando una clave pública

'ssh-rsa')); if (ssh2_auth_pubkey_file($connection, 'username', '/home/username/.ssh/id_rsa.pub', '/home/username/.ssh/id_rsa', 'secret')) { echo "Identificación exitosa utilizando una clave pública\n"; } else { die('Fallo en la identificación utilizando una clave pública'); } ?>

```php

Notas#

[!NOTE] La biblioteca libssh subyacente no soporta muy limpiamente las autenticaciones parciales. Es decir, que si debe proporcionar a la vez una clave pública y una contraseña, entonces parecerá como si la función estuviera en error. En este caso particular, un error en esta llamada puede simplemente significar que la autenticación no está aún terminada. Debe ignorar este error y continuar con la llamada ssh2_auth_password para terminar la autenticación.

Véase también#

ssh2_auth_pubkey