openssl pkcs7 verify()

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök

openssl_pkcs7_verify

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

openssl_pkcs7_verify — Verifierar signaturen för ett S/MIME-signerat meddelande

Beskrivning

openssl_pkcs7_verify(
    string $input_filename,
    int $flags,
    ?string $signers_certificates_filename = null,
    array $ca_info = [],
    ?string $untrusted_certificates_filename = null,
    ?string $content = null,
    ?string $output_filename = null
): bool|int

openssl_pkcs7_verify() läser S/MIME-meddelandet i den angivna filen och granskar den digitala signaturen.

Parametrar

  • input_filename — Sökväg till meddelandet.
  • flags — Flaggor för att påverka hur signaturen verifieras - se PKCS7-konstanter för mer information.
  • signers_certificates_filename — Om angiven, namnet på en fil där signatörernas certifikat lagras i PEM-format.
  • ca_info — Om angiven, information om betrodda CA-certifikat som ska användas i verifieringsprocessen.
  • untrusted_certificates_filename — Om angiven, filnamn med certifikat för icke-betrodda CAs.
  • content — Filnamn som innehåller de verifierade data med signaturinformationen borttagen.
  • output_filename — Filnamn för verifierat innehåll.

Returnerar

Returnerar

true

om signaturen är verifierad,

false

om den är felaktig (t.ex. om meddelandet manipulerats eller signeringscertifikatet är ogiltigt), eller

-1

vid fel.

Changelog

Version Beskrivning
8.0.0 signers_certificates_filename, untrusted_certificates_filename, content och output_filename är nu nullable.
7.2.0 output_filename-parametern lades till.

Noter

Observera: Enligt RFC 2045 får linjer inte vara längre än 76 tecken i parametern input_filename.

Exempel

<?php
// Läs och verifiera en S/MIME-fil
$input = 'signed_message.pem';
$signers_cert = 'signers_cert.pem';
$ca_certificates = ['trusted_ca_cert.pem'];

if (openssl_pkcs7_verify($input, PKCS7_NOVERIFY, $signers_cert, $ca_certificates)) {
    echo "Signaturen är giltig.";
} else {
    echo "Signaturen är ogiltig eller ett fel uppstod.";
}
?>

Se även

openssl_pkcs7_read

(PHP 7 >= 7.2.0, PHP 8)

openssl_pkcs7_read — Exporterar PKCS7-filen till en array av PEM-certifikat

Beskrivning

openssl_pkcs7_read(string $data, array &$certificates): bool

Denna funktion analyserar PKCS7-certifikatfilen (p7b-format) och returnerar en array med PEM-kodade certifikat.

Parametrar

  • data — Strängen med data i p7b-format som ska analyseras.
  • certificates — Array som innehåller PEM-certifikat från p7b-inmatningsdata.

Returnerar

Returnerar

true

vid framgång eller

false

vid fel.

Exempel

Exempel #1 Hämta en PEM-array från en P7B-fil

<?php

$file = 'certs.p7b';

$f = file_get_contents($file);
$p7 = array();
$r = openssl_pkcs7_read($f, $p7);

if ($r === false) {
    printf("ERROR: %s är inte en giltig p7b-fil".PHP_EOL, $file);
        for($e = openssl_error_string(), $i = 0; $e; $e = openssl_error_string(), $i++)
            printf("SSL l%d: %s".PHP_EOL, $i, $e);
    exit(1);
}

print_r($p7);
?>

Se även

  • openssl_csr_sign() — Signera en CSR med ett annat certifikat (eller sig själv) och generera ett certifikat

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/function.openssl-pkcs7-verify.php PHP Funktioner Funktionsreferens OpenSSL-funktioner


Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorreparation Stockholm som har sponsrat Linux.se med webserver.