openssl_pkey_new
Descripción
Sintaxis de llamada
resource openssl_pkey_new([array $ParámetrosConfiguración])
Parámetros de entrada
- ParámetrosConfiguración: Opcionalmente puede facilitarse una matriz con parámetros de configuración que modifiquen el comportamiento de la función. Todos esos parámetros tienen unos valores por defecto que se recuperan del archivo de configuración de OpenSSL, localizado normalmente en /etc/ssl/openssl.cnf. Este vector asociativo puede contener, entre otros, los elementos indicados en la tabla siguiente:
Clave | Contenido |
---|---|
private_key_type | Establece el tipo de clave a crear. Puede ser OPENSSL_KEYTYPE_RSA, OPENSSL_KEYTYPE_DSA u OPENSSL_KEYTYPE_DH. El valor por defecto es OPENSSL_KEYTYPE_RSA, de forma que se generará, si no se indica lo contrario, una clave de tipo RSA |
private_key_bits | Fija la longitud que tendrá la clave a generar. Debe ser un entero: 512, 1024, 2048, etc. El valor por defecto es 1024 |
digest_alg | Cadena indicando el algoritmo de hashing a utilizar. Por defecto se usa SHA1. |
Valor de retorno
- resource: Devuelve el recurso que representa a la nueva clave o, en caso de que se produzca un fallo, devuelve el valor FALSE.
Finalidad de la función
Esta función genera un nuevo par de claves privada/pública, usando para ello la información alojada en el archivo de configuración openssl.cnf y, opcionalmente, los parámetros que se entreguen como argumento en el momento de invocarla.
El valor devuelto es un recurso en el que se encuentran almacenadas la clave privada y la clave pública. Pueden utilizarse funciones como openssl_pkey_export y openssl_pkey_get_details para extraer individualmente cada clave.
Véase también
page revision: 9, last edited: 10 May 2008 13:05