cvs: phpdoc /fr/functions openssl.xml
| From: | Damien Seguy | Date: | Wed, 27 Dec 2000 08:54:16 +0000 |
| Subject: | cvs: phpdoc /fr/functions openssl.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333396@lists.php.net to get a copy of this message | ||
dams Wed Dec 27 00:54:16 2000 EDT
Added files:
/phpdoc/fr/functions openssl.xml
Log:
Translation
Index: phpdoc/fr/functions/openssl.xml +++ phpdoc/fr/functions/openssl.xml <reference id="ref.openssl"> <title>OpenSSL</title> <titleabbrev>OpenSSL</titleabbrev> <partintro> <para> Cette extension utilise les fonctions de <ulink url="&url.openssl;">OpenSSL</ulink> pour générer et vérifier les signatures, ainsi que pour sceller (crypter) et ouvrir (décrypter) les données. Vous avez besoin de OpenSSL >= 0.9.6 pour utiliser ce module. </para> <para> OpenSSL offre de nombreuses fonctionnalités qui ne sont pas encore supportées par ce module. Elle seront ajoutées ultérieurement. </para> </partintro> <refentry id="function.openssl-free-key"> <refnamediv> <refname>openssl_free_key</refname> <refpurpose>Libère les ressources</refpurpose> </refnamediv> <refsect1> <title>Description</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> libère les ressources associées à <parameter>key_identifier</parameter>. </para> </refsect1> </refentry> <refentry id="function.openssl-get-privatekey"> <refnamediv> <refname>openssl_get_privatekey</refname> <refpurpose>Prépare une clé privée au format PEM</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_get_privatekey</function> retourne un identifiant de clé positif, ou FALSE en cas d'erreur. </para> <para> <function>openssl_get_privatekey</function> analyse la clé privée <parameter>key</parameter>, au format PEM, et la prépare pour à être utilisée par d'autres fonctions. Le paramètre optionnel <parameter>passphrase</parameter> doit être utilisé si la clé est cryptée (protégée par un mot de passe). </para> </refsect1> </refentry> <refentry id="function.openssl-get-publickey"> <refnamediv> <refname>openssl_get_publickey</refname> <refpurpose>Extrait une clé publique d'un certificat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>openssl_get_publickey</function></funcdef> <paramdef>string <parameter>certificate</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>openssl_get_publickey</function> retourne un identifiant de clé positif, ou FALSE en cas d'erreur. </para> <para> <function>openssl_get_publickey</function> extrait la clé publique du certificat <parameter>certificate</parameter> (format X.509), et la prépare à être utilisée ultérieurement. </para> </refsect1> </refentry> <refentry id="function.openssl-open"> <refnamediv> <refname>openssl_open</refname> <refpurpose>Ouvre des données scellées</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_open</function> TRUE en cas de succès, et FALSE sinon. En cas de succès, les données décryptées sont placées dans <parameter>open_data</parameter>. </para> <para> <function>openssl_open</function> ouvre (décrypte) les données <parameter>sealed_data</parameter> en utilisant la clé prviée <parameter>priv_key_id</parameter> et la clé d'enveloppe <parameter>env_key</parameter>. La clé d'enveloppe est générée lorsque les données sont scellées, et ne peut être utilisée qu'avec la clé privée spécifique. Reportez vous à <function>openssl_seal</function> pour plus d'informations. </para> <para> <example> <title>Exemple avec <function>openssl_open</function></title> <programlisting role="php"> <?php // On suppose que $sealed et $env_key contiennent les données scellées // et la clé d'enveloppe, fournies par l'expéditeur // lecture de la clé privée dans un fichier $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); // décryptage des données : elles sont placées dans $open if (openssl_open($sealed, $open, $env_key, $pkeyid)) echo "Voici les données décryptées : ", $open; else echo "Impossible de décrypter les données"; // libération des ressources openssl_free_key($pkeyid); ?> </programlisting> </example> </para> <simpara> Voir aussi <function>openssl_seal</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-seal"> <refnamediv> <refname>openssl_seal</refname> <refpurpose>Scelle des données</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_seal</function> retourne la longueur des données scellées en cas de succès, et FALSE sinon. En cas de succès, les données scellées sont placées dans le paramètre <parameter>sealed_data</parameter>, et les clés d'enveloppe dans <parameter>env_keys</parameter>. </para> <para> <function>openssl_seal</function> scelle (encrypte) les données <parameter>data</parameter> en utilisant l'algorithme RC4 avec une clé secrètre générée aléatoirement. La clé est encryptée avec chaque clé publique associée à <parameter>pub_key_ids</parameter> et chaque clé ainsi encryptée est retournée dans <parameter>env_keys</parameter>. Cela signifique que vous pouvez envoyez des données scellées à plusieurs destinataires (en supposant que chacun ait recu la clé publique). Chaque destinataire doit recevoir les données encryptées et la clé d'enveloppe, qui a été encryptée avec la clé publique du destinataire. </para> <para> <example> <title>Exemple avec <function>openssl_seal</function></title> <programlisting role="php"> <?php // On suppose que $data contient les données à sceller // lecture de la clé publique pour chaque destinataire $fp = fopen("/src/openssl-0.9.6/demos/maurice/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pk1 = openssl_get_publickey($cert); // pour le deuxième destinataire $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pk2 = openssl_get_publickey($cert); // scelle le message : seuls, les possessuers de $pk1 et $pk2 peuvent décrypter // le message $sealed avec les clés $ekeys[0] et $ekeys[1] (respectivement). openssl_seal($data, $sealed, $ekeys, array($pk1,$pk2)); // libère les clés de la mémoire openssl_free_key($pk1); openssl_free_key($pk2); ?> </programlisting> </example> </para> <simpara> Voir aussi <function>openssl_open</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-sign"> <refnamediv> <refname>openssl_sign</refname> <refpurpose>Signe les données</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_sign</function> retourne TRUE en cas de succès, et FALSE sinon. En cas de succès, la signature est placée dans <parameter>signature</parameter>. </para> <para> <function>openssl_sign</function> calcule la signature des données <parameter>data</parameter> en utilisant l'algorithme SHA1 (hashing) suivi du cryptage avec la clé privée <parameter>priv_key_id</parameter>. Notez que les données elles-mêmes ne sont pas encryptées. </para> <para> <example> <title>Exemple avec <function>openssl_sign</function></title> <programlisting role="php"> <?php // On suppose que $data contient les données à signer // lecture de la clé publique pour chaque destinataire $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); // calcule de la signature openssl_sign($data, $signature, $pkeyid); // libère les clés de la mémoire openssl_free_key($pkeyid); ?> </programlisting> </example> </para> <simpara> Voir aussi <function>openssl_verify</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-verify"> <refnamediv> <refname>openssl_verify</refname> <refpurpose>Vérifie une signature</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_verify</function> retourne 1 si la signature est correcte, 0 si la signature est incorrecte, et -1 en cas d'erreur. </para> <para> <function>openssl_verify</function> vérifie que la signature <parameter>signature</parameter> est correcte pour les données <parameter>data</parameter>, et avecd la clé publique <parameter>pub_key_id</parameter>. Cette clé doit être la clé publique correspondant à la clé privée utilisée lors de la signature. </para> <para> <example> <title>Exemple avec <function>openssl_verify</function></title> <programlisting role="php"> <?php // On suppose que $data et $signature contiennent les données à signer et // la signature // lecture de la clé publique depuis le certificat $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pubkeyid = openssl_get_publickey($cert); // indique si la signature est correcte $ok = openssl_verify($data, $signature, $pubkeyid); if ($ok == 1) echo "Signature valide"; elseif ($ok == 0) echo "Signature erronnée"; else echo "Erreur de vérification de la signature"; // libère les clés de la mémoire openssl_free_key($pubkeyid); ?> </programlisting> </example> </para> <simpara> Voir aussi <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: -->
Index: phpdoc/fr/functions/openssl.xml +++ phpdoc/fr/functions/openssl.xml <reference id="ref.openssl"> <title>OpenSSL</title> <titleabbrev>OpenSSL</titleabbrev> <partintro> <para> Cette extension utilise les fonctions de <ulink url="&url.openssl;">OpenSSL</ulink> pour générer et vérifier les signatures, ainsi que pour sceller (crypter) et ouvrir (décrypter) les données. Vous avez besoin de OpenSSL >= 0.9.6 pour utiliser ce module. </para> <para> OpenSSL offre de nombreuses fonctionnalités qui ne sont pas encore supportées par ce module. Elle seront ajoutées ultérieurement. </para> </partintro> <refentry id="function.openssl-free-key"> <refnamediv> <refname>openssl_free_key</refname> <refpurpose>Libère les ressources</refpurpose> </refnamediv> <refsect1> <title>Description</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> libère les ressources associées à <parameter>key_identifier</parameter>. </para> </refsect1> </refentry> <refentry id="function.openssl-get-privatekey"> <refnamediv> <refname>openssl_get_privatekey</refname> <refpurpose>Prépare une clé privée au format PEM</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_get_privatekey</function> retourne un identifiant de clé positif, ou FALSE en cas d'erreur. </para> <para> <function>openssl_get_privatekey</function> analyse la clé privée <parameter>key</parameter>, au format PEM, et la prépare pour à être utilisée par d'autres fonctions. Le paramètre optionnel <parameter>passphrase</parameter> doit être utilisé si la clé est cryptée (protégée par un mot de passe). </para> </refsect1> </refentry> <refentry id="function.openssl-get-publickey"> <refnamediv> <refname>openssl_get_publickey</refname> <refpurpose>Extrait une clé publique d'un certificat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>openssl_get_publickey</function></funcdef> <paramdef>string <parameter>certificate</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>openssl_get_publickey</function> retourne un identifiant de clé positif, ou FALSE en cas d'erreur. </para> <para> <function>openssl_get_publickey</function> extrait la clé publique du certificat <parameter>certificate</parameter> (format X.509), et la prépare à être utilisée ultérieurement. </para> </refsect1> </refentry> <refentry id="function.openssl-open"> <refnamediv> <refname>openssl_open</refname> <refpurpose>Ouvre des données scellées</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_open</function> TRUE en cas de succès, et FALSE sinon. En cas de succès, les données décryptées sont placées dans <parameter>open_data</parameter>. </para> <para> <function>openssl_open</function> ouvre (décrypte) les données <parameter>sealed_data</parameter> en utilisant la clé prviée <parameter>priv_key_id</parameter> et la clé d'enveloppe <parameter>env_key</parameter>. La clé d'enveloppe est générée lorsque les données sont scellées, et ne peut être utilisée qu'avec la clé privée spécifique. Reportez vous à <function>openssl_seal</function> pour plus d'informations. </para> <para> <example> <title>Exemple avec <function>openssl_open</function></title> <programlisting role="php"> <?php // On suppose que $sealed et $env_key contiennent les données scellées // et la clé d'enveloppe, fournies par l'expéditeur // lecture de la clé privée dans un fichier $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); // décryptage des données : elles sont placées dans $open if (openssl_open($sealed, $open, $env_key, $pkeyid)) echo "Voici les données décryptées : ", $open; else echo "Impossible de décrypter les données"; // libération des ressources openssl_free_key($pkeyid); ?> </programlisting> </example> </para> <simpara> Voir aussi <function>openssl_seal</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-seal"> <refnamediv> <refname>openssl_seal</refname> <refpurpose>Scelle des données</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_seal</function> retourne la longueur des données scellées en cas de succès, et FALSE sinon. En cas de succès, les données scellées sont placées dans le paramètre <parameter>sealed_data</parameter>, et les clés d'enveloppe dans <parameter>env_keys</parameter>. </para> <para> <function>openssl_seal</function> scelle (encrypte) les données <parameter>data</parameter> en utilisant l'algorithme RC4 avec une clé secrètre générée aléatoirement. La clé est encryptée avec chaque clé publique associée à <parameter>pub_key_ids</parameter> et chaque clé ainsi encryptée est retournée dans <parameter>env_keys</parameter>. Cela signifique que vous pouvez envoyez des données scellées à plusieurs destinataires (en supposant que chacun ait recu la clé publique). Chaque destinataire doit recevoir les données encryptées et la clé d'enveloppe, qui a été encryptée avec la clé publique du destinataire. </para> <para> <example> <title>Exemple avec <function>openssl_seal</function></title> <programlisting role="php"> <?php // On suppose que $data contient les données à sceller // lecture de la clé publique pour chaque destinataire $fp = fopen("/src/openssl-0.9.6/demos/maurice/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pk1 = openssl_get_publickey($cert); // pour le deuxième destinataire $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pk2 = openssl_get_publickey($cert); // scelle le message : seuls, les possessuers de $pk1 et $pk2 peuvent décrypter // le message $sealed avec les clés $ekeys[0] et $ekeys[1] (respectivement). openssl_seal($data, $sealed, $ekeys, array($pk1,$pk2)); // libère les clés de la mémoire openssl_free_key($pk1); openssl_free_key($pk2); ?> </programlisting> </example> </para> <simpara> Voir aussi <function>openssl_open</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-sign"> <refnamediv> <refname>openssl_sign</refname> <refpurpose>Signe les données</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_sign</function> retourne TRUE en cas de succès, et FALSE sinon. En cas de succès, la signature est placée dans <parameter>signature</parameter>. </para> <para> <function>openssl_sign</function> calcule la signature des données <parameter>data</parameter> en utilisant l'algorithme SHA1 (hashing) suivi du cryptage avec la clé privée <parameter>priv_key_id</parameter>. Notez que les données elles-mêmes ne sont pas encryptées. </para> <para> <example> <title>Exemple avec <function>openssl_sign</function></title> <programlisting role="php"> <?php // On suppose que $data contient les données à signer // lecture de la clé publique pour chaque destinataire $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); // calcule de la signature openssl_sign($data, $signature, $pkeyid); // libère les clés de la mémoire openssl_free_key($pkeyid); ?> </programlisting> </example> </para> <simpara> Voir aussi <function>openssl_verify</function>. </simpara> </refsect1> </refentry> <refentry id="function.openssl-verify"> <refnamediv> <refname>openssl_verify</refname> <refpurpose>Vérifie une signature</refpurpose> </refnamediv> <refsect1> <title>Description</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> <function>openssl_verify</function> retourne 1 si la signature est correcte, 0 si la signature est incorrecte, et -1 en cas d'erreur. </para> <para> <function>openssl_verify</function> vérifie que la signature <parameter>signature</parameter> est correcte pour les données <parameter>data</parameter>, et avecd la clé publique <parameter>pub_key_id</parameter>. Cette clé doit être la clé publique correspondant à la clé privée utilisée lors de la signature. </para> <para> <example> <title>Exemple avec <function>openssl_verify</function></title> <programlisting role="php"> <?php // On suppose que $data et $signature contiennent les données à signer et // la signature // lecture de la clé publique depuis le certificat $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); $pubkeyid = openssl_get_publickey($cert); // indique si la signature est correcte $ok = openssl_verify($data, $signature, $pubkeyid); if ($ok == 1) echo "Signature valide"; elseif ($ok == 0) echo "Signature erronnée"; else echo "Erreur de vérification de la signature"; // libère les clés de la mémoire openssl_free_key($pubkeyid); ?> </programlisting> </example> </para> <simpara> Voir aussi <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: -->