openssl-seal.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: nilgun Status: ready -->
<refentry xml:id="function.openssl-seal" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>openssl_seal</refname>
  <refpurpose>Veriyi mühürler (şifreler)</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>int</type><type>false</type></type><methodname>openssl_seal</methodname>
   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>veri</parameter></methodparam>
   <methodparam><type>string</type><parameter role="reference">mühürlü_veri</parameter></methodparam>
   <methodparam><type>array</type><parameter role="reference">zarf_anahtarları</parameter></methodparam>
   <methodparam><type>array</type><parameter>genel_anahtar</parameter></methodparam>
   <methodparam><type>string</type><parameter>algoritma</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter role="reference">ilklendirme_yöneyi</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Rasgele üretilmiş bir gizli anahtarla verilen
   <parameter>algoritma</parameter>'yı kullanarak <parameter>veri</parameter>yi
   mühürler (şifreler) ve <parameter>mühürlü_veri</parameter> bağımsız değişkeninde
   döndürür. Gizli anahtar, <parameter>genel_anahtar</parameter> içindeki
   tanımlayıcılarla ilişkili genel anahtarlarla şifrelenir ve
   <parameter>zarf_anahtarları</parameter> dizisinde döndürülür. Bu, bir
   kişinin birden fazla alıcıya mühürlü veri gönderebileceği anlamına gelir
   (genel anahtarlarının elinde olması şartıyla). Her alıcının, hem mühürlü
   veriyi hem de alıcının genel anahtarıyla şifrelenmiş zarf anahtarını alması
   gerekir.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>veri</parameter></term>
     <listitem>
      <para>
       Mühürlenecek veri.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>mühürlü_veri</parameter></term>
     <listitem>
      <para>
       Mühürlenen veri bu bağımsız değişkene konur.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>zarf_anahtarları</parameter></term>
     <listitem>
      <para>
       Genel anahtarlarla şirelenmiş gizli anahtarların döndürüldüğü dizi.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>genel_anahtar</parameter></term>
     <listitem>
      <para>
       Genel anahtarları içeren <classname>OpenSSLAsymmetricKey</classname>
       örnekleri dizisi.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>algoritma</parameter></term>
     <listitem>
      <para>
       Şifreleme yöntemi.
       <caution>
        <simpara>
         Öntanımlı değerin (<literal>'RC4'</literal>) günenilmez olduğu
         varsayılır. Güvenilir bir şifreleme yöntemi belirtilmesi şiddetle
         önerilir. method.
        </simpara>
       </caution>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>ilklendirme_yöneyi</parameter></term>
     <listitem>
      <para>
       İlklendirme yöneyi.
       </para>
      </listitem>
     </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   İşlem başarılı olursa mühürlü veri <parameter>mühürlü_veri</parameter>
   bağımsız değişkenine, zarf mühürleri <parameter>zarf_anahtarları</parameter>
   bağımsız değişkenine konup mühürlü verinin uzunluğu döndürülür. Hata oluşursa
   &false; döner.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <parameter>genel_anahtar</parameter> artık
       <classname>OpenSSLAsymmetricKey</classname> veya
       <classname>OpenSSLCertificate</classname> örneği kabul ediyor;
       evvelce, <literal>OpenSSL key</literal> veya <literal>OpenSSL
       X.509</literal> özkaynağı kabul edilirdi.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <parameter>algoritma</parameter> artık seçimlik değil.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <parameter>ilklendirme_yöneyi</parameter> artık &null; olabiliyor.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>openssl_seal</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
// $veri'nin mühürlenecek veriyi içerdiği varsayılıyor.

// alıcıların genel anahtarlarını alıp hazırlayalım
$dt = fopen("/src/openssl-0.9.6/demos/maurice/cert.pem", "r");
$sert = fread($dt, 8192);
fclose($dt);
$ga1 = openssl_get_publickey($sert);

// İşlemi ikinci alıcı için yineleyelim.
$dt = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r");
$sert = fread($dt, 8192);
fclose($dt);
$ga2 = openssl_get_publickey($sert);

// Veriyi mühürleyelim. $muhurlu_veri sadece $ga1 ve $ga2'nin sahipleri
// tarafından sırasıyla $muhurler[0] ve $muhurler[1] anahtarları ile
// çözülebilir.
openssl_seal($data, $muhurlu_veri, $muhurler, array($ga1, $ga2));

// anahtar belleklerini serbest bırakalım
openssl_free_key($ga1);
openssl_free_key($ga2);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>openssl_open</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->