cvs: phpdoc /cs/functions openssl.xml

From: Date: Mon, 05 Feb 2001 12:43:38 +0000
Subject: cvs: phpdoc /cs/functions openssl.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969334172@lists.php.net to get a copy of this message
cynic Mon Feb 5 04:43:38 2001 EDT Added files: /phpdoc/cs/functions openssl.xml Log: should be completely translated

Index: phpdoc/cs/functions/openssl.xml +++ phpdoc/cs/functions/openssl.xml <reference id="ref.openssl"> <title>OpenSSL funkce</title> <titleabbrev>OpenSSL</titleabbrev> <partintro> <para> Tato extenze vyu¾ívá funkce <ulink url="&url.openssl;">OpenSSL</ulink> pro tvorbu a ovìøování podpisù a peèetìní (kódování) a otvírání (dekódování) dat. K práci s touto extenzí potøebujete OpenSSL >= 0.9.6. </para> <para> OpenSSL nabízí mnoho vlastností, které tato extenze v souèasnosti nepodporuje. Nìkteré z nich mohou být v budoucnu pøidány. </para> </partintro> <refentry id="function.openssl-free-key"> <refnamediv> <refname>openssl_free_key</refname> <refpurpose>Uvolnit prostøedky klíèe</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>openssl_free_key</function></funcdef> <paramdef>int <parameter>key_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>openssl_free_key</function> uvolní klíè asociovaný s pøedaným <parameter>key_identifier</parameter> z pamìti. </para> </refsect1> </refentry> <refentry id="function.openssl-get-privatekey"> <refnamediv> <refname>openssl_get_privatekey</refname> <refpurpose>Pøipravit soukromý PEM klíè k pou¾ití</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>openssl_get_privatekey</function></funcdef> <paramdef>string <parameter>key</parameter></paramdef> <paramdef>string <parameter><optional>passphrase</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para>Pri úspìchu vrací klíè, pøi chybì <literal>false</literal>. </para> <para> <function>openssl_get_privatekey</function> rozparsuje sourkomý PEM klíè <parameter>key</parameter> a pøipraví ho k pou¾ití v dal¹ích funkcích. Volitelný argument <parameter>passphrase</parameter> musí být pøedán, pokud je tento klíè zakódován (chránìn heslem). </para> </refsect1> </refentry> <refentry id="function.openssl-get-publickey"> <refnamediv> <refname>openssl_get_publickey</refname> <refpurpose> Získat z certifikátu veøejný klíè a pøipravit ho k pou¾ití </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>openssl_get_publickey</function></funcdef> <paramdef>string <parameter>certificate</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Pøi úspìchu vrací identifikátor klíèe, pøi chybì <literal>false</literal>. </para> <para> <function>openssl_get_publickey</function> z X.509 certifikátu <parameter>certificate</parameter> vyextrahuje veøejný klíè a pøipraví ho k pou¾ití v dal¹ích funkcích. </para> </refsect1> </refentry> <refentry id="function.openssl-open"> <refnamediv> <refname>openssl_open</refname> <refpurpose>Otevøít zapeèetìná data</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>openssl_open</function></funcdef> <paramdef>string <parameter>sealed_data</parameter></paramdef> <paramdef>string <parameter>open_data</parameter></paramdef> <paramdef>string <parameter>env_key</parameter></paramdef> <paramdef>int <parameter>priv_key_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Pøi úspìchu vrací <literal>true</literal>, pøi chybì <literal>false</literal>. Úspì¹nì otevøená data se umístí do argumentu <parameter>open_data</parameter>. </para> <para> <function>openssl_open</function> otevøe (dekóduje) <parameter>sealed_data</parameter> pomocí soukromého klíèe asociovaného s identifikátorem <parameter>priv_key_id</parameter> a obálkou <parameter>env_key</parameter>. Tato obálka se generuje pøi peèetìní dat a je pou¾itelná pouze s jedním utèitým soukromým klíèem. Více informací viz <function>openssl_seal</function>. </para> <para> <example> <title>Ukázka <function>openssl_open</function></title> <programlisting role="php"> // $sealed a $env_key obsahují zapeèetìná data a obálku // obojí nám bylo dáno tím, kdo data zapeèetil // získat ze souboru soukromý klíè a pøipravit ho $fp = fopen("/src/openssl-0.9.6/demos/sign/key.pem", "r"); $priv_key = fread($fp, 8192); fclose($fp); $pkeyid = openssl_get_privatekey($priv_key); // dekódovat data a ulo¾it je v $open if (openssl_open($sealed, $open, $env_key, $pkeyid)) echo "tady jsou otevøená data: ", $open; else echo "nepodaøilo se otevøít data"; // uvolnit klíè z pamìti openssl_free_key($pkeyid); </programlisting> </example> </para> <simpara> Viz také <function>openssl_seal</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-seal"> <refnamediv> <refname>openssl_seal</refname> <refpurpose>Zapeèetit (zakódovat) data</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>openssl_seal</function></funcdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>string <parameter>sealed_data</parameter></paramdef> <paramdef>array <parameter>env_keys</parameter></paramdef> <paramdef>array <parameter>pub_key_ids</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Pøi úspìchu vrací délku zapeèetìných dat, pøi chybì <literal>false</literal>. Úspì¹nì zapeèetìná data se umístí do argumentu <parameter>sealed_data</parameter>, a obálka do <parameter>env_keys</parameter>. </para> <para> <function>openssl_seal</function> zapeèetí (zakóduje) <parameter>data</parameter> pomocí RC4 s náhodnì generovaným tajným klíèem. Tento klíè se zakóduje v¹emi veøejnými klíèi asociovanými s identifikátory v <parameter>pub_key_ids</parameter> a zakódované klíèe se vrátí v <parameter>env_keys</parameter>. To znamená, ¾e lze poslat zapeèetìná data více pøíjemcùm (za pøedpokladu, ¾e máme jejích veøejné klíèe). Ka¾dý z pøíjemcù musí obdr¾et zapeèetìná data a obálku, která byla zakódována jeho veøejným klíèem. </para> <para> <example> <title>Ukázka <function>openssl_seal</function></title> <programlisting role="php"> // $data obsahuje data urèená k zapeèetìní // získat veøejné klíèe na¹ich pøíjemcù a pøipravit je $fp = fopen("/src/openssl-0.9.6/demos/maurice/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pk1 = openssl_get_publickey($cert); // opakovat prodruhého pøíjemce $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pk2 = openssl_get_publickey($cert); // zapeèetit zprávu, pouze majitelé $pk1 a $pk2 mohou dekódovat $sealed pomocí // $ekeys[0] a $ekeys[1]. openssl_seal($data, $sealed, $ekeys, array($pk1,$pk2)); // uvolnit klíèe z pamìti openssl_free_key($pk1); openssl_free_key($pk2); </programlisting> </example> </para> <simpara> Viz také <function>openssl_open</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-sign"> <refnamediv> <refname>openssl_sign</refname> <refpurpose>Generate signature</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>openssl_sign</function></funcdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>string <parameter>signature</parameter></paramdef> <paramdef>int <parameter>priv_key_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Pøi úspìchu vrací <literal>true</literal>, pøi chybì <literal>false</literal>. Úspì¹nì vytvoøený podpis se umístí v <parameter>signature</parameter>. </para> <para> <function>openssl_sign</function> vypoèítá podpis pro daná specified <parameter>data</parameter> pomocí SHA1 hashe a následnì jej zakóduje soukromým klíèem asociovaným s <parameter>priv_key_id</parameter>. Pozn.: samotná data nejsou kódována. </para> <para> <example> <title><function>openssl_sign</function> example</title> <programlisting role="php"> // $data obsahuje data urèená k podpisu // získat ze souboru soukromý klíè a pøipravit ho $fp = fopen("/src/openssl-0.9.6/demos/sign/key.pem", "r"); $priv_key = fread($fp, 8192); fclose($fp); $pkeyid = openssl_get_privatekey($priv_key); // vytvoøit podpis openssl_sign($data, $signature, $pkeyid); // uvolnit klíè z pamìti openssl_free_key($pkeyid); </programlisting> </example> </para> <simpara> Viz také <function>openssl_verify</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-verify"> <refnamediv> <refname>openssl_verify</refname> <refpurpose>Ovìøit podpis</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>openssl_verify</function></funcdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>string <parameter>signature</parameter></paramdef> <paramdef>int <parameter>pub_key_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Vrací 1, pokud je podpis správný, 0, pokud je nesprávný, a -1 pøi chybì. </para> <para> <function>openssl_verify</function> ovìøuje, zda je <parameter>signature</parameter> správný pro <parameter>data</parameter> pomocí veøejného klíèe asociovaného s <parameter>pub_key_id</parameter>. Musí to být veøejný klíè odpovídající soukromému klíèi pou¾itému k podpisu. </para> <para> <example> <title>Ukázka <function>openssl_verify</function></title> <programlisting role="php"> // $data a $signature obsahují data a podpis // získat z certifikátu veøejný klíè a pøipravit ho $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pubkeyid = openssl_get_publickey($cert); // zjistit, jestli je podpis v poøádku $ok = openssl_verify($data, $signature, $pubkeyid); if ($ok == 1) echo "dobøe"; elseif ($ok == 0) echo "¹patnì"; else echo "nejhùø, pøi kontrole podpisu do¹lo k chybì"; // uvolnit klíè z pamìti openssl_free_key($pubkeyid); </programlisting> </example> </para> <simpara> Viz také <function>openssl_sign</function>. </simpara> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->
« previous php.doc (#969334172) next »