array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.openssl-verify.php', 1 => 'openssl_verify', 2 => 'Verifica assinatura', ), 'up' => array ( 0 => 'ref.openssl.php', 1 => 'Funções de OpenSSL', ), 'prev' => array ( 0 => 'function.openssl-spki-verify.php', 1 => 'openssl_spki_verify', ), 'next' => array ( 0 => 'function.openssl-x509-check-private-key.php', 1 => 'openssl_x509_check_private_key', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/openssl/functions/openssl-verify.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

openssl_verify

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

openssl_verify — Verifica assinatura

Descrição

openssl_verify(
    string $data,
    string $signature,
    OpenSSLAsymmetricKey|OpenSSLCertificate|array|string $public_key,
    string|int $algorithm = OPENSSL_ALGO_SHA1,
    int $padding = 0
): int|false

openssl_verify() verifica que a assinatura em signature está correta para os dados especificados em data usans a chave pública public_key. Esta precisa ser a chave pública correspondente à chave privada utilizada para assinatura.

Parâmetros

data

A sequência de dados usada para gerar a assinatura anteriormente

signature

Uma string binária bruta, gerada por openssl_sign() ou meios similares

public_key

OpenSSLAsymmetricKey - uma chave, retornada por openssl_get_publickey()

string - uma chave no formato PEM (por exemplo -----BEGIN PUBLIC KEY----- MIIBCgK...)

algorithm

int - um destes Algoritmos de Assinatura.

string - uma string válida retornada por openssl_get_md_methods(), por exemplo, "sha1WithRSAEncryption" ou "sha512".

padding
Preenchimento PSS RSA a ser usado.

Valor Retornado

Retorna 1 se a assinatura estiver correta, 0 se estiver incorreta e -1 ou false em caso de erro.

Registro de Alterações

Versão Descrição
8.5.0 O parâmetro opcional padding foi adicionado.
8.0.0 public_key agora aceita uma instância de OpenSSLAsymmetricKey ou OpenSSLCertificate; anteriormente, um resource do tipo OpenSSL key ou OpenSSL X.509 era aceito.

Exemplos

Exemplo #1 Exemplo de openssl_verify()

<?php
// Presume-se que $data e $signature contenham os dados e a assinatura

// busca a chave pública do certificado e a prepara
$pubkeyid = openssl_pkey_get_public("file://src/openssl-0.9.6/demos/sign/cert.pem");

// afirma se a assinatura está correta ou não
$ok = openssl_verify($data, $signature, $pubkeyid);
if ($ok == 1) {
echo "boa";
} elseif ($ok == 0) {
echo "ruim";
} else {
echo "erro ao verificar assinatura";
}
// libera a chave da memória
openssl_free_key($pubkeyid);
?>

Exemplo #2 Exemplo de openssl_verify()

<?php
// dados a serem assinados
$data = 'my data';

// cria uma nova chave privada e pública
$private_key_res = openssl_pkey_new(array(
"private_key_bits" => 2048,
"private_key_type" => OPENSSL_KEYTYPE_RSA,
));
$details = openssl_pkey_get_details($private_key_res);
$public_key_res = openssl_pkey_get_public($details['key']);

// cira assinatura
openssl_sign($data, $signature, $private_key_res, "sha256WithRSAEncryption");

// verifica assinatura
$ok = openssl_verify($data, $signature, $public_key_res, OPENSSL_ALGO_SHA256);
if ($ok == 1) {
echo "válida";
} elseif ($ok == 0) {
echo "inválida";
} else {
echo "erro: ".openssl_error_string();
}
?>

Veja Também