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

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License