initial translation in openssl/functions

reference/openssl/functions/openssl-x509-check-private-key.xml

@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-x509-check-private-key" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_x509_check_private_key</refname>
+  <refpurpose>Verifica se uma chave privada corresponde a um certificado</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>openssl_x509_check_private_key</methodname>
+   <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam>
+   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Verifica se a chave privada informada em <parameter>private_key</parameter> é a
+   que corresponde ao certificado fornecidor em <parameter>certificate</parameter>.
+  </para>
+  <warning>
+    <para>
+     A função não verifica se <parameter>private_key</parameter> é de fato uma chave privada ou não.
+     Ela apenas compara os materiais públicos (por exemplo, expoente e módulo de uma chave RSA)
+     e/ou parâmetros da chave (por exemplo, parâmetros EC de uma chave EC) de um par de chaves.
+    </para>
+    <para>
+     Isto significa, por exemplo, que uma chave pública poderia ser informada em <parameter>private_key</parameter>
+     e a função poderia retornar &true;.
+    </para>
+  </warning>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>certificate</parameter></term>
+     <listitem>
+      <para>
+       O certificado.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>private_key</parameter></term>
+     <listitem>
+      <para>
+       A chave privada.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna &true; se <parameter>private_key</parameter> for a chave privada que
+   corresponde ao certificado do parâmetro <parameter>certificate</parameter>, ou &false; caso contrário.
+  </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>certificate</parameter> agora aceita uma instância de <classname>OpenSSLCertificate</classname>;
+       anteriormente, um &resource; do tipo <literal>OpenSSL X.509</literal> era aceito.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>private_key</parameter> agora aceita uma instância de <classname>OpenSSLAsymmetricKey</classname>
+       ou <classname>OpenSSLCertificate</classname>;
+       anteriormente, um &resource; do tipo <literal>OpenSSL key</literal> ou <literal>OpenSSL X.509</literal>
+       era aceito.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </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
+-->

reference/openssl/functions/openssl-x509-checkpurpose.xml

@@ -0,0 +1,168 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 497c40ac164d5873fd87f622dfdeb5206392b446 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-x509-checkpurpose" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_x509_checkpurpose</refname>
+  <refpurpose>Verifica se um certificado pode ser usado para uma finalidade específica</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>bool</type><type>int</type></type><methodname>openssl_x509_checkpurpose</methodname>
+   <methodparam><type class="union"><type>OpenSSLCertificate</type><type>string</type></type><parameter>certificate</parameter></methodparam>
+   <methodparam><type>int</type><parameter>purpose</parameter></methodparam>
+   <methodparam choice="opt"><type>array</type><parameter>ca_info</parameter><initializer>[]</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>untrusted_certificates_file</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>openssl_x509_checkpurpose</function> examina um certificado para
+   ver se pode ser usado para o a finalidade especificada em <parameter>purpose</parameter>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>certificate</parameter></term>
+     <listitem>
+      <para>
+       O certificado examinado.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>purpose</parameter></term>
+     <listitem>
+      <para>
+       <table>
+        <title><function>openssl_x509_checkpurpose</function> purposes</title>
+        <tgroup cols="2">
+         <thead>
+          <row>
+           <entry>Constante</entry>
+           <entry>Descrição</entry>
+          </row>
+         </thead>
+         <tbody>
+          <row>
+           <entry>X509_PURPOSE_SSL_CLIENT</entry>
+           <entry>O certificado pode ser usado no lado do cliente de uma
+           conexão SSL?</entry>
+          </row>
+          <row>
+           <entry>X509_PURPOSE_SSL_SERVER</entry>
+           <entry>O certificado pode ser usado no lado do servidor de uma
+           conexão SSL?</entry>
+          </row>
+          <row>
+           <entry>X509_PURPOSE_NS_SSL_SERVER</entry>
+           <entry>O certificado pode ser usado para o servidor Netscape SSL?</entry>
+          </row>
+          <row>
+           <entry>X509_PURPOSE_SMIME_SIGN</entry>
+           <entry>O certificado pode ser usado para assinar e-mail S/MIME?</entry>
+          </row>
+          <row>
+           <entry>X509_PURPOSE_SMIME_ENCRYPT</entry>
+           <entry>O certificado pode ser usado para criptografar e-mails S/MIME?</entry>
+          </row>
+          <row>
+           <entry>X509_PURPOSE_CRL_SIGN</entry>
+           <entry>O certificado pode ser usado para assinar uma lista de certificados
+           revogados (CRL)?</entry>
+          </row>
+          <row>
+           <entry>X509_PURPOSE_ANY</entry>
+           <entry>O certificado pode ser usado para qualquer/todos os fins?</entry>
+          </row>
+         </tbody>
+        </tgroup>
+       </table>
+       Estas opções não são campos de bits - somente uma pode ser especificada!
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>ca_info</parameter></term>
+     <listitem>
+      <para>
+       <parameter>ca_info</parameter> deve ser um array de arquivos/diretórios CA confiáveis
+       como descrito em <link linkend="openssl.cert.verification">Verificação de
+       Certificados</link>.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>untrusted_certificates_file</parameter></term>
+     <listitem>
+      <para>
+       Se especificado, este deve ser o nome de um arquivo codificado em <acronym>PEM</acronym> contendo
+       certificados que podem ser usados ​​para ajudar a verificar o certificado, embora
+       nenhuma confiança seja colocada nos certificados provenientes desse arquivo.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna &true; se o certificado puder ser usado para a finalidade pretendida,
+   &false; se não puder, ou -1 em caso de erro.
+  </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>certificate</parameter> agora aceita uma instância de <classname>OpenSSLCertificate</classname>;
+       anteriormente, um &resource; do tipo <literal>OpenSSL X.509</literal> era aceito.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>untrusted_certificates_file</parameter> agora pode ser nulo.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </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
+-->