(PECL rnp >= 0.1.1)
rnp_op_generate_key — Genera una clave
$ffi,$userid,$key_alg,$sub_alg = ?,$options = ?
ffiEl objeto FFI retornado por rnp_ffi_create().
useridEl identificador del usuario PGP - texto que debe representar el nombre y la dirección de correo electrónico del titular de la clave.
key_algLa clave del algoritmo (es decir, 'RSA', 'DSA', etc).
sub_algEl algoritmo de subclave. Si no está definido, la subclave no será generada.
optionsUn array asociativo con opciones.
| Clave | Tipo de datos | Descripción |
|---|---|---|
"bits" |
integer | El tamaño de la clave principal en bits. Aplicable únicamente a las claves RSA, DSA y El-Gamal. |
"hash" |
string | Algoritmo de hash utilizado en la firma de la clave o la firma de ligadura de subclave. |
"dsa_qbits" |
integer | Define el tamaño de un parámetro q para la clave DSA.
Nota: se definirá un valor predeterminado adecuado, según el número de bits de la clave. Sin embargo, puede
ser reemplazado si es necesario. |
"curve" |
string | Define la curva utilizada para la clave ECC. Nota: esto se aplica únicamente a las claves ECDSA, ECDH y SM2. |
"request_password" |
boolean | Activa la solicitud de contraseña a través del proveedor de contraseñas. Esta contraseña
será utilizada para el cifrado de la clave. La función de retrollamada del proveedor de contraseñas debe ser definida previamente
llamando a rnp_ffi_set_pass_provider().
Nota: este parámetro será ignorado si la contraseña ha sido definida a través de "password" |
"password" |
string | Define la contraseña utilizada para cifrar los datos de la clave secreta. |
"expiration" |
integer | Define el tiempo de expiración de la clave principal y la subclave en segundos. |
"sub_bits" |
integer | El tamaño de la subclave en bits. Aplicable únicamente a las claves RSA, DSA y El-Gamal. |
"sub_hash" |
string | Algoritmo de hash utilizado en la firma de la subclave o la firma de ligadura de subclave. |
"sub_curve" |
string | Define la curva utilizada para la subclave ECC. Nota: esto se aplica únicamente a las claves ECDSA, ECDH y SM2. |
La huella de la clave principal generada o false si ocurre un error. Esta huella puede ser utilizada
más tarde para referenciar la clave en las operaciones de firma y cifrado. Los datos de la clave se almacenan en el contexto de memoria
FFI y pueden ser guardados utilizando
rnp_save_keys() o rnp_save_keys_to_path().