Visa källa för openssl pkcs7 sign()

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

=== openssl_sign — Genererar en signatur ===

==== Beskrivning ====
<pre>
openssl_sign(
    string $data,
    string &$signature,
    OpenSSLAsymmetricKey|OpenSSLCertificate|array|string $private_key,
    string|int $algorithm = OPENSSL_ALGO_SHA1
): bool
</pre>
Funktionen <code>openssl_sign()</code> skapar en kryptografisk digital signatur för den angivna datan genom att använda privatnyckeln som är kopplad till <code>private_key</code>. Observera att själva datan inte krypteras.

==== Parametrar ====
* '''data''' — Strängen med data du vill signera.
* '''signature''' — Om anropet lyckades returneras signaturen här.
* '''private_key''' — Privat nyckel. Kan vara en OpenSSLAsymmetricKey från <code>openssl_get_privatekey()</code> eller en PEM-formatterad nyckelsträng.
* '''algorithm''' — Algoritm för signaturen. Kan vara ett heltal som motsvarar en av signaturalgoritmerna, eller en sträng som returneras av <code>openssl_get_md_methods()</code>, exempelvis <code>"sha256WithRSAEncryption"</code> eller <code>"sha384"</code>.

==== Returnerar ====
Returnerar <pre>true</pre> vid framgång eller <pre>false</pre> vid fel.

==== Changelog ====
{| class="wikitable"
|-
! Version !! Beskrivning
|-
| 8.0.0 || <code>private_key</code> accepterar nu en instans av <code>OpenSSLAsymmetricKey</code> eller <code>OpenSSLCertificate</code>; tidigare accepterades en resurs av typen <code>OpenSSL key</code> eller <code>OpenSSL X.509</code>.
|}

==== Exempel ====
Exempel #1 openssl_sign() exempel

<pre>
<?php
// $data antas innehålla datan som ska signeras

// hämta privat nyckel från fil och förbered den
$pkeyid = openssl_pkey_get_private("file://src/openssl-0.9.6/demos/sign/key.pem");

// skapa signatur
openssl_sign($data, $signature, $pkeyid);

// frigör nyckeln från minnet
openssl_free_key($pkeyid);
?>
</pre>

Exempel #2 openssl_sign() exempel

<pre>
<?php
// data du vill signera
$data = 'my data';

// skapa ett nytt privat och publikt nyckelpar
$new_key_pair = openssl_pkey_new(array(
    "private_key_bits" => 2048,
    "private_key_type" => OPENSSL_KEYTYPE_RSA,
));
openssl_pkey_export($new_key_pair, $private_key_pem);

$details = openssl_pkey_get_details($new_key_pair);
$public_key_pem = $details['key'];

// skapa signatur
openssl_sign($data, $signature, $private_key_pem, OPENSSL_ALGO_SHA256);

// spara för senare bruk
file_put_contents('private_key.pem', $private_key_pem);
file_put_contents('public_key.pem', $public_key_pem);
file_put_contents('signature.dat', $signature);

// verifiera signaturen
$r = openssl_verify($data, $signature, $public_key_pem, "sha256WithRSAEncryption");
var_dump($r);
?>
</pre>

==== Se även ====
* [[openssl_verify()]] — Verifierar signatur


== openssl_pkcs7_read ==
'''(PHP 7 >= 7.2.0, PHP 8)'''

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

==== Beskrivning ====
<pre>
openssl_pkcs7_read(string $data, array &$certificates): bool
</pre>
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 <pre>true</pre> vid framgång eller <pre>false</pre> vid fel.

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

<pre>
<?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);
?>
</pre>

==== 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-sign.php
[[PHP]]
[[Funktioner]]
[[Funktionsreferens]]
[[OpenSSL-funktioner]]
<HR>
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/
<BR><BR>Tack till [https://www.datorreparation.nu/ Datorreparation Stockholm] som har  sponsrat [https://www.linux.se Linux.se] med webserver.

[[Kategori:Php]]
[[Kategori:Kryptografi-extensioner]]