1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-26 08:22:08 +01:00
Files
archived-doc-es/reference/openssl/constants.xml
Pedro Antonio Gil Rodríguez 13db31ec4e Actualización a la última versión
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@329013 c90b9560-bf6c-de11-be94-00142212c4b1
2013-01-08 09:59:24 +00:00

606 lines
16 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1cd5fc7fae3bc1fbbe141d63fb7c5fbaa4a74aad Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="openssl.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<section xml:id="openssl.purpose-check">
<title>Banderas de comprobación de propósito</title>
<variablelist>
<varlistentry xml:id="constant.x509-purpose-ssl-client">
<term>
<constant>X509_PURPOSE_SSL_CLIENT</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.x509-purpose-ssl-server">
<term>
<constant>X509_PURPOSE_SSL_SERVER</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.x509-purpose-ns-ssl-server">
<term>
<constant>X509_PURPOSE_NS_SSL_SERVER</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.x509-purpose-smime-sign">
<term>
<constant>X509_PURPOSE_SMIME_SIGN</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.x509-purpose-smime-encrypt">
<term>
<constant>X509_PURPOSE_SMIME_ENCRYPT</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.x509-purpose-crl-sign">
<term>
<constant>X509_PURPOSE_CRL_SIGN</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.x509-purpose-any">
<term>
<constant>X509_PURPOSE_ANY</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<section xml:id="openssl.padding">
<title>Banderas de relleno para encriptación asimétrica</title>
<variablelist>
<varlistentry xml:id="constant.openssl-pkcs1-padding">
<term>
<constant>OPENSSL_PKCS1_PADDING</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-sslv23-padding">
<term>
<constant>OPENSSL_SSLV23_PADDING</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-no-padding">
<term>
<constant>OPENSSL_NO_PADDING</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-pkcs1-oaep-padding">
<term>
<constant>OPENSSL_PKCS1_OAEP_PADDING</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<section xml:id="openssl.key-types">
<title>Tipos de claves</title>
<variablelist>
<varlistentry xml:id="constant.openssl-keytype-rsa">
<term>
<constant>OPENSSL_KEYTYPE_RSA</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-dsa">
<term>
<constant>OPENSSL_KEYTYPE_DSA</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-dh">
<term>
<constant>OPENSSL_KEYTYPE_DH</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-keytype-ec">
<term>
<constant>OPENSSL_KEYTYPE_EC</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Esta constante únicamente está disponible cuando PHP está compilado con OpenSSL 0.9.8+.
</simpara>
</listitem>
</varlistentry>
</variablelist>
<note>
<para>Esta constante fue añadida en la versión 5.2.0.</para>
<para>
<constant>OPENSSL_KEYTYPE_EC</constant>
</para>
</note>
</section>
<section xml:id="openssl.pkcs7.flags">
<title>Banderas/Constantes <acronym>PKCS7</acronym></title>
<para>
Las funciones S/MIME hacen uso de banderas que están especificadas utilizando un
campo de bit que puede incluir uno o más de los siguientes valores:
<table>
<title>CONSTANTES <acronym>PKCS7</acronym></title>
<tgroup cols="2">
<thead>
<row>
<entry>Constante</entry>
<entry>Descripción</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.pkcs7-text">
<entry><constant>PKCS7_TEXT</constant></entry>
<entry>Añade cabeceras de tipo de contenido texto/plano al mensaje
encriptado/firmado. Si se desencripta o verifica, se desmontan esas cabeceras de
la salida - si el mensaje desencriptado o verificado no es del tipo MIME
texto/plano ocurrirá un error.</entry>
</row>
<row xml:id="constant.pkcs7-binary">
<entry><constant>PKCS7_BINARY</constant></entry>
<entry>Normalmente el mensaje de entrada es convertido a formato "canónico"
en el que de hecho se usa <literal>CR</literal> y <literal>LF</literal>
como final de línea: como se require por la especificación S/MIME. Cuando esta
opción está presente, no se realiza ninguna traducción. Ésto es útil cuando
se maneja información binaria que puede no estar en formato MIME.</entry>
</row>
<row xml:id="constant.pkcs7-nointern">
<entry><constant>PKCS7_NOINTERN</constant></entry>
<entry>Cuando se verifica un mensaje, los certificados (si
hay alguno) incluidos en el mensaje son buscados normalmente por el
certificado de firma. Con esta opción sólo los
certificados especificados el el parámetro <parameter>extracerts</parameter>
de <function>openssl_pkcs7_verify</function> se usan.
Sin embargo, los certificados proporcionados pueden aún ser
usados como AC que no son de confianza.
</entry>
</row>
<row xml:id="constant.pkcs7-noverify">
<entry><constant>PKCS7_NOVERIFY</constant></entry>
<entry>No verificar los certificados de firmas de un mensaje
firmado.</entry>
</row>
<row xml:id="constant.pkcs7-nochain">
<entry><constant>PKCS7_NOCHAIN</constant></entry>
<entry>No encadenar la verificación de certificados de firmas: es decir,
no usar los certificados en el mensaje firmado como AC que no es de confianza.
</entry>
</row>
<row xml:id="constant.pkcs7-nocerts">
<entry><constant>PKCS7_NOCERTS</constant></entry>
<entry>Cuando se firma un mensaje, el certificado del firmante normalmente está
incluido - con esta opción se excluye. Esto reducirá el
tamaño del mensaje firmado pero el verificador debe tener una copia del
certificado del firmante que esté disponible localmente (usando al pasar
<parameter>extracerts</parameter> a
<function>openssl_pkcs7_verify</function> por ejemplo).
</entry>
</row>
<row xml:id="constant.pkcs7-noattr">
<entry><constant>PKCS7_NOATTR</constant></entry>
<entry>Normalmente cuando un mensaje está firmado se incluyen un conjunto
de atributos como el momento de la firma y los algoritmos simétricos
soportados. Con esta opción todos éstos no se incluyen.
</entry>
</row>
<row xml:id="constant.pkcs7-detached">
<entry><constant>PKCS7_DETACHED</constant></entry>
<entry>Cuando se firma un mensaje, se usa la firma de texto claro con el tipo
MIME <literal>"multiparte/firmado"</literal>. Esto es lo predeterminado
si no se especifican algunos <parameter>flags</parameter> a
<function>openssl_pkcs7_sign</function>.
Si se desactiva esta opción, el mensaje será firmado usando
la firma opaca, que es más resistente a traducciones por transmisiones de correo,
pero no puede ser leída por agentes de correo que no soporten S/MIME.</entry>
</row>
<row xml:id="constant.pkcs7-nosigs">
<entry><constant>PKCS7_NOSIGS</constant></entry>
<entry>No poner a prueba y verificar las firmas de un mensaje</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<note>
<para>Estas constantes fueron añadidas en la versión 4.0.6.</para>
</note>
</section>
<section xml:id="openssl.signature-algos">
<title>Algoritmos de Firma</title>
<variablelist>
<varlistentry xml:id="constant.openssl-algo-dss1">
<term>
<constant>OPENSSL_ALGO_DSS1</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-sha1">
<term>
<constant>OPENSSL_ALGO_SHA1</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Usado como algoritmo predeterminado por <function>openssl_sign</function> y
<function>openssl_verify</function>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-sha224">
<term>
<constant>OPENSSL_ALGO_SHA224</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-sha256">
<term>
<constant>OPENSSL_ALGO_SHA256</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-sha384">
<term>
<constant>OPENSSL_ALGO_SHA384</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-sha512">
<term>
<constant>OPENSSL_ALGO_SHA512</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-rmd160">
<term>
<constant>OPENSSL_ALGO_RMD160</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-md5">
<term>
<constant>OPENSSL_ALGO_MD5</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-md4">
<term>
<constant>OPENSSL_ALGO_MD4</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-algo-md2">
<term>
<constant>OPENSSL_ALGO_MD2</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
A partir de PHP 5.2.13 y PHP 5.3.2, esta constante únicamete está disponible
si PHP está compilado con soporte para MD2. Esto requiere pasar
-DHAVE_OPENSSL_MD2_H CFLAG al compilar PHP, y enable-md2 al
compilar OpenSSL 1.0.0+.
</simpara>
</listitem>
</varlistentry>
</variablelist>
<note>
<para>Estas constantes fueron añadidas en la versión 5.0.0.</para>
<para>
<constant>OPENSSL_ALGO_MD2</constant>, <constant>OPENSSL_ALGO_MD4</constant>,
<constant>OPENSSL_ALGO_MD5</constant>, <constant>OPENSSL_ALGO_SHA1</constant>,
<constant>OPENSSL_ALGO_DSS1</constant>
</para>
</note>
<note>
<para>Estas constantes fueron añadidas en la versión 5.4.8.</para>
<para>
<constant>OPENSSL_ALGO_RMD160</constant>, <constant>OPENSSL_ALGO_SHA224</constant>,
<constant>OPENSSL_ALGO_SHA256</constant>, <constant>OPENSSL_ALGO_SHA384</constant>,
<constant>OPENSSL_ALGO_SHA512</constant>
</para>
</note>
</section>
<section xml:id="openssl.ciphers">
<title>Cifrados</title>
<variablelist>
<varlistentry xml:id="constant.openssl-cipher-rc2-40">
<term>
<constant>OPENSSL_CIPHER_RC2_40</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-cipher-rc2-128">
<term>
<constant>OPENSSL_CIPHER_RC2_128</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-cipher-rc2-64">
<term>
<constant>OPENSSL_CIPHER_RC2_64</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-cipher-des">
<term>
<constant>OPENSSL_CIPHER_DES</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-cipher-3des">
<term>
<constant>OPENSSL_CIPHER_3DES</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
<note>
<para>Estas constantes fueron añadidas en la versión 4.3.0.</para>
</note>
<variablelist>
<varlistentry xml:id="constant.openssl-cipher-aes-128-cbc">
<term>
<constant>OPENSSL_CIPHER_AES_128_CBC</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-cipher-aes-192-cbc">
<term>
<constant>OPENSSL_CIPHER_AES_192_CBC</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-cipher-aes-256-cbc">
<term>
<constant>OPENSSL_CIPHER_AES_256_CBC</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
<note>
<para>Estas constantes fueron añadadidas en la versión 5.4.0.</para>
</note>
</section>
<section xml:id="openssl.constversion">
<title>Constantes de Versión</title>
<variablelist>
<varlistentry xml:id="constant.openssl-version-text">
<term>
<constant>OPENSSL_VERSION_TEXT</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.openssl-version-number">
<term>
<constant>OPENSSL_VERSION_NUMBER</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
<note>
<para>Estas constantes fueron añadidas en la versión 5.2.0.</para>
</note>
</section>
<section xml:id="openssl.constsni">
<title>Constantes de Indicación del Nombre del Servidor</title>
<variablelist>
<varlistentry xml:id="constant.openssl-tlsext-server-name">
<term>
<constant>OPENSSL_TLSEXT_SERVER_NAME</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Si el sopore para SNI está disponible o no.
</simpara>
</listitem>
</varlistentry>
</variablelist>
<note>
<para>
Estas constantes fueron añadidas en la versión 5.3.2 y requieren que PHP se
construya con OpenSSL 0.9.8j o posterior.
</para>
</note>
</section>
</appendix>
<!-- 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
-->