array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.rnp-op-generate-key.php', 1 => 'rnp_op_generate_key', 2 => 'Gera chave', ), 'up' => array ( 0 => 'ref.rnp.php', 1 => 'Funções de Rnp', ), 'prev' => array ( 0 => 'function.rnp-op-encrypt.php', 1 => 'rnp_op_encrypt', ), 'next' => array ( 0 => 'function.rnp-op-sign.php', 1 => 'rnp_op_sign', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/rnp/functions/rnp-op-generate-key.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

rnp_op_generate_key

(PECL rnp >= 0.1.1)

rnp_op_generate_key — Gera chave

Descrição

rnp_op_generate_key(
    RnpFFI $ffi,
    string $userid,
    string $key_alg,
    string $sub_alg = ?,
    array $options = ?
): string|false

Parâmetros

ffi
O objeto FFI retornado por rnp_ffi_create().
userid
ID de usuário PGP - texto cuja intenção é representar o nome e endereço de e-mail do titular da chave.
key_alg
Algoritmo de chave primária (ou seja, 'RSA', 'DSA', etc).
sub_alg
Algoritmo de subchave. Se não for definido, a subchave não será gerada.
options
Um array associativo com opções.
Chave Tipo de dado Descrição
"bits" inteiro Tamanho da chave primária em bits. Aplicável apenas às chaves RSA, DSA e El-Gamal.
"hash" string Algoritmo hash usado em autoassinatura ou assinatura de ligação de subchave.
"dsa_qbits" inteiro Define o tamanho de um parâmetro q para a chave DSA. Nota: o valor padrão apropriado será definido, dependendo dos bits da chave. No entanto, ele pode ser substituído, se necessário.
"curve" string Define a curva usada para a chave ECC. Nota: isto só é aplicável para chaves ECDSA, ECDH e SM2.
"request_password" booleano Habilita a solicitação de senha por meio do provedor de senha. Esta senha será usada para criptografia de chave. A função de retorno do provedor de senha deve ser definida antecipadamente chamando rnp_ffi_set_pass_provider(). Nota: esta configuração será ignorada se a senha for definida via"password"
"password" string Define a senha usada para criptografar os dados da chave secreta.
"expiration" inteiro Define o tempo de expiração da chave e da subchave em segundos.
"sub_bits" inteiro Tamanho da subchave em bits. Aplicável apenas às chaves RSA, DSA e El-Gamal.
"sub_hash" string Algoritmo hash usado na autoassinatura de subchave ou assinatura de ligação de subchave.
"sub_curve" string Define a curva usada para a subchave ECC. Nota: isto só é aplicável para chaves ECDSA, ECDH e SM2.

Valor Retornado

Impressão digital da chave primária gerada ou false em caso de falha. Esta impressão digital pode ser usada posteriormente para fazer referência à chave em operações de assinatura e criptografia. Os dados da chave são armazenados no contexto da memória FFI e podem ser salvos usando rnp_save_keys() ou rnp_save_keys_to_path().