Dutch PHP Conference 2025 - Call For Papers

rnp_op_generate_key

(PECL rnp >= 0.1.1)

rnp_op_generate_keyGera 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().

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top