rnp_ffi_set_pass_provider

(PECL rnp >= 0.1.1)

rnp_ffi_set_pass_provider — Definir função de retorno do provedor de senha

Descrição

rnp_ffi_set_pass_provider(RnpFFI $ffi, callable $password_callback): bool

Define a função do provedor de senha. Esta função pode solicitar a senha em uma entrada padrão (se o script PHP for executado em um ambiente de linha de comando), exibir a caixa de diálogo da interface gráfica ou fornecer a senha de qualquer outra maneira possível. As senhas solicitadas são usadas para criptografar ou descriptografar chaves secretas ou realizar operações simétricas de criptografia/descriptografia.

Parâmetros

ffi

O objeto FFI retornado por rnp_ffi_create.

password_callback

A função que deve ser chamada para cada solicitação de senha. Possui a seguinte assinatura:

password_callback(string $key_fp, string $pgp_context, string &$password): bool
  • $key_fp - A impressão digital da chave, se houver. Pode ser vazio.
  • $pgp_context - String que descreve por que a chave está sendo solicitada.
  • $password - Variável de referência onde a senha fornecida deve ser armazenada como string.
A função de retorno deve retornar true se a senha foi definida com sucesso ou false em caso de falha.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Example #1 exemplo de função de retorno simples

<?php
function password_callback(string $key_fp, string $pgp_context, string &$password)
{
    $password = "password";

    return true;
}

$ffi = rnp_ffi_create('GPG', 'GPG');

rnp_ffi_set_pass_provider($ffi, 'password_callback');