openssl_verify

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

openssl_verifyVerifica assinatura

Descrição

openssl_verify(
    string $data,
    string $signature,
    OpenSSLAsymmetricKey|OpenSSLCertificate|array|string $public_key,
    string|int $algorithm = OPENSSL_ALGO_SHA1
): 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".

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.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 que você deseja assinar
$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