<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.openssl.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.openssl-pkey-get-details.php',
    1 => 'openssl_pkey_get_details',
    2 => 'Devuelve un array que contiene los detalles de la clave',
  ),
  'up' => 
  array (
    0 => 'ref.openssl.php',
    1 => 'Funciones de OpenSSL',
  ),
  'prev' => 
  array (
    0 => 'function.openssl-pkey-free.php',
    1 => 'openssl_pkey_free',
  ),
  'next' => 
  array (
    0 => 'function.openssl-pkey-get-private.php',
    1 => 'openssl_pkey_get_private',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/openssl/functions/openssl-pkey-get-details.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.openssl-pkey-get-details" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">openssl_pkey_get_details</h1>
  <p class="verinfo">(PHP 5 &gt;= 5.2.0, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">openssl_pkey_get_details</span> &mdash; <span class="dc-title">Devuelve un array que contiene los detalles de la clave</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.openssl-pkey-get-details-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>openssl_pkey_get_details</strong></span>(<span class="methodparam"><span class="type"><a href="class.opensslasymmetrickey.php" class="type OpenSSLAsymmetricKey">OpenSSLAsymmetricKey</a></span> <code class="parameter">$key</code></span>): <span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   Esta función devuelve los detalles de la clave (bits, key, type).
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.openssl-pkey-get-details-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">key</code></dt>
     <dd>
      <p class="para">
       Recurso que contiene la clave.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.openssl-pkey-get-details-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Devuelve un array con los detalles de la clave en caso de éxito,
   o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> en caso de fallo.
   El array devuelto contiene los índices <code class="literal">bits</code> (número de bits),
   <code class="literal">key</code> (representación en forma de <span class="type"><a href="language.types.string.php" class="type string">string</a></span> de la clave pública)
   y <code class="literal">type</code> (tipo de clave que es uno de
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-rsa">OPENSSL_KEYTYPE_RSA</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dsa">OPENSSL_KEYTYPE_DSA</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dh">OPENSSL_KEYTYPE_DH</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ec">OPENSSL_KEYTYPE_EC</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x25519">OPENSSL_KEYTYPE_X25519</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed25519">OPENSSL_KEYTYPE_ED25519</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x448">OPENSSL_KEYTYPE_X448</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed448">OPENSSL_KEYTYPE_ED448</a></code></strong>,
   o <code class="literal">-1</code> significando desconocido).
  </p>
  <p class="para">
   Dependiendo del tipo de claves utilizadas, pueden devolverse detalles adicionales.
   Tenga en cuenta que algunos elementos pueden no estar siempre disponibles.
  </p>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-rsa">OPENSSL_KEYTYPE_RSA</a></code></strong>, se devuelve una clave de array adicional llamada <code class="literal">&quot;rsa&quot;</code>,
     que contiene los datos de la clave.
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Descripción</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;n&quot;</code></td>
         <td>módulo</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;e&quot;</code></td>
         <td>exponente público</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;d&quot;</code></td>
         <td>exponente privado</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;p&quot;</code></td>
         <td>número primo 1</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;q&quot;</code></td>
         <td>número primo 2</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;dmp1&quot;</code></td>
         <td>exponent1, d mod (p-1)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;dmq1&quot;</code></td>
         <td>exponent2, d mod (q-1)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;iqmp&quot;</code></td>
         <td>coeficiente, (inverso de q) mod p</td>
        </tr>

       </tbody>
      
     </table>

   </li>
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dsa">OPENSSL_KEYTYPE_DSA</a></code></strong>, se devuelve una clave de array adicional llamada <code class="literal">&quot;dsa&quot;</code>,
     que contiene los datos de la clave.
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Descripción</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;p&quot;</code></td>
         <td>número primo (público)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;q&quot;</code></td>
         <td>160-bit número sub-prime, q | p-1 (público)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;g&quot;</code></td>
         <td>generador del subgrupo (público)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;priv_key&quot;</code></td>
         <td>clave privada x</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;pub_key&quot;</code></td>
         <td>clave pública y = g^x</td>
        </tr>

       </tbody>
      
     </table>

   </li>
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dh">OPENSSL_KEYTYPE_DH</a></code></strong>, se devuelve una clave de array adicional llamada <code class="literal">&quot;dh&quot;</code>,
     que contiene los datos de la clave.
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Descripción</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;p&quot;</code></td>
         <td>número primo (compartido)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;g&quot;</code></td>
         <td>generador de Z_p (compartido)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;priv_key&quot;</code></td>
         <td>valor privado DH x</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;pub_key&quot;</code></td>
         <td>valor público DH g^x</td>
        </tr>

       </tbody>
      
     </table>

   </li>
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x25519">OPENSSL_KEYTYPE_X25519</a></code></strong>,
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed25519">OPENSSL_KEYTYPE_ED25519</a></code></strong>,
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x448">OPENSSL_KEYTYPE_X448</a></code></strong>,
     o <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed448">OPENSSL_KEYTYPE_ED448</a></code></strong>,
     se devuelve una clave adicional en el array llamada
     <code class="literal">&quot;x25519&quot;</code>,
     <code class="literal">&quot;ed25519&quot;</code>,
     <code class="literal">&quot;x448&quot;</code>,
     o <code class="literal">&quot;ed448&quot;</code> respectivamente,
     que contiene los datos de la clave.
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Descripción</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;priv_key&quot;</code></td>
         <td>clave privada</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;pub_key&quot;</code></td>
         <td>clave pública</td>
        </tr>

       </tbody>
      
     </table>

   </li>
  </ul>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.openssl-pkey-get-details-changelog">
  <h3 class="title">Historial de cambios</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versión</th>
      <th>Descripción</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.4.0</td>
      <td>
       Se añadió el soporte para claves basadas en Curve25519 y Curve448.
       Más específicamente, se introdujeron los campos <code class="literal">x25519</code>, <code class="literal">ed25519</code>,
       <code class="literal">x448</code> y <code class="literal">ed448</code>.
      </td>
     </tr>

     <tr>
      <td>8.0.0</td>
      <td>
       <code class="parameter">key</code> ahora acepta una instancia de
       <span class="classname"><a href="class.opensslasymmetrickey.php" class="classname">OpenSSLAsymmetricKey</a></span>;
       anteriormente, se aceptaba un <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> de tipo <code class="literal">OpenSSL key</code>.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>

</div><?php manual_footer($setup); ?>