rnp_op_verify
PHP function
Edit on GitHub ✎
(PECL rnp >= 0.1.1)
Verify embedded or cleartext signatures
Description
rnp_op_verify(RnpFFI $ffi, string $data): array|false
Parameters
ffiFfi-description
dataSigned data.
Return Values
An associative array with information about verification resultsFalseforfailure.
| Key | Data type | Description |
|---|---|---|
"verification_status" | string | Overall verification result, either "Success" string or appropriate error message. "Success" result is set when at least one signature is valid and successfully verified. Individual verification results for each signature can be checked in the "signatures" array. |
"file_name" | string | File name. |
"file_mtime" | integer | File modification time. |
"mode" | string | Data protection (encryption) mode used in processed message. Currently defined values are "none", "cfb", "cfb-mdc", "aead-ocb", "aead-eax". |
"cipher" | string | Symmetric cipher used for data encryption. |
"valid_integrity" | boolean | true if message integrity protection was used (i.e. MDC or AEAD) and it was validated successfully. |
"signatures" | array | An associative array describing each signature found. See description below. |
"signatures" sub-array.
| Key | Data type | Description |
|---|---|---|
| "verification_status" | string | Signature verification status, either "Success" string or appropriate error message. |
| "creation_time" | integer | Signature creation time in seconds since Jan, 1 1970 UTC. |
| "expiration_time" | integer | Signature expiration time in seconds since the creation time or 0 if signature never expires. |
| "hash" | string | Hash function algorithm used to calculate the signature. |
| "signing_key" | string | Fingerprint of the key used for signing. Could be "Not found" if corresponding public key is not loaded to the FFI object. |
| "signature_type" | string | Signature type. Currently defined values are: 'binary', 'text', 'standalone', 'certification (generic)', 'certification (persona)', 'certification (casual)', 'certification (positive)', 'subkey binding', 'primary key binding', 'direct', 'key revocation', 'subkey revocation', 'certification revocation', 'timestamp', 'uknown: 0..255'. |