From f1b3ac932f5ece3b2ae82e880f2d87bf45b0347d Mon Sep 17 00:00:00 2001
From: leonardolara <leonardo.lara.rodrigues@gmail.com>
Date: Sun, 3 Nov 2024 19:20:46 -0300
Subject: [PATCH] initial translation in openssl/functions

---
 .../openssl/functions/openssl-pkey-derive.xml | 140 ++++++++++
 .../functions/openssl-pkey-export-to-file.xml | 120 ++++++++
 .../openssl/functions/openssl-pkey-export.xml | 118 ++++++++
 .../openssl/functions/openssl-pkey-free.xml   |  97 +++++++
 .../functions/openssl-pkey-get-details.xml    | 258 ++++++++++++++++++
 .../functions/openssl-pkey-get-private.xml    | 119 ++++++++
 .../functions/openssl-pkey-get-public.xml     | 105 +++++++
 .../openssl/functions/openssl-pkey-new.xml    | 153 +++++++++++
 8 files changed, 1110 insertions(+)
 create mode 100644 reference/openssl/functions/openssl-pkey-derive.xml
 create mode 100644 reference/openssl/functions/openssl-pkey-export-to-file.xml
 create mode 100644 reference/openssl/functions/openssl-pkey-export.xml
 create mode 100644 reference/openssl/functions/openssl-pkey-free.xml
 create mode 100644 reference/openssl/functions/openssl-pkey-get-details.xml
 create mode 100644 reference/openssl/functions/openssl-pkey-get-private.xml
 create mode 100644 reference/openssl/functions/openssl-pkey-get-public.xml
 create mode 100644 reference/openssl/functions/openssl-pkey-new.xml

diff --git a/reference/openssl/functions/openssl-pkey-derive.xml b/reference/openssl/functions/openssl-pkey-derive.xml
new file mode 100644
index 000000000..5734d296a
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-derive.xml
@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 7fd8e591b8b5a35eda6a0fa6cdecd2a83b195920 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-derive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>openssl_pkey_derive</refname>
+  <refpurpose>Calcula o segredo compartilhado para o valor público da chave DH ou ECDH remota e local</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>string</type><type>false</type></type><methodname>openssl_pkey_derive</methodname>
+   <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>public_key</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>
+   <methodparam choice="opt"><type>int</type><parameter>key_length</parameter><initializer>0</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>openssl_pkey_derive</function> pega um conjunto de <parameter>public_key</parameter>
+   e <parameter>private_key</parameter> e deriva um segredo compartilhado, para chaves DH ou EC.
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>public_key</parameter></term>
+    <listitem>
+     <para>
+      <parameter>public_key</parameter> é a chave pública para a derivação.
+      Consulte <link linkend="openssl.certparams">Parâmetros de chave pública/privada</link> para obter uma lista de valores válidos.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>private_key</parameter></term>
+    <listitem>
+     <para>
+      <parameter>private_key</parameter> é a chave privada para a derivação.
+      Consulte <link linkend="openssl.certparams">Parâmetros de chave pública/privada</link> para obter uma lista de valores válidos.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>key_length</parameter></term>
+    <listitem>
+     <para>
+      Se não for zero, tentará definir o comprimento desejado do segredo derivado.
+     </para>
+     <caution>
+      <simpara>
+       Este parâmetro não deve ser utilizado, pois não funciona conforme o esperado. Ele nunca retorna um segredo
+       maior que o tamanho do primo. Se o comprimento desejado for menor que o tamanho do
+       primo, ele truncará o comprimento apenas para chaves ECDH, mas falhará para chaves DH.
+      </simpara>
+     </caution>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   O segredo derivado em caso de sucesso&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example xml:id="openssl-pkey-derive.example.basic">
+    <title>Exemplo de <function>openssl_pkey_derive</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Carrega a chave privada
+$priv = openssl_pkey_get_private("-----BEGIN PRIVATE KEY-----
+MIICJgIBADCCARcGCSqGSIb3DQEDATCCAQgCggEBAJLxRCaZ933uW+AXmabHFDDy
+upojBIRlbmQLJZfigDaSA1f9YOTsIv+WwVFTX/J1mtCyx9uBcz0Nt2kmVwxWuc2f
+VtCEMPsmLsVXX7xRUFLpyX1Y1IYGBVXQOoOvLWYQjpZgnx47Pkh1Ok1+smffztfC
+0DCNt4KorWrbsPcmqBejXHN79KvWFjZmXOksRiNu/Bn76RiqvofC4z8Ri3kHXQG2
+197JGZzzFXHadGC3xbkg8UxsNbYhVMKbm0iANfafUH7/hoS9UjAVQYtvwe7YNiW/
+HnyfVCrKwcc7sadd8Iphh+3lf5P1AhaQEAMytanrzq9RDXKBxuvpSJifRYasZYsC
+AQIEggEEAoIBAGwAYC2E81Y1U2Aox0U7u1+vBcbht/OO87tutMvc4NTLf6NLPHsW
+cPqBixs+3rSn4fADzAIvdLBmogjtiIZoB6qyHrllF/2xwTVGEeYaZIupQH3bMK2b
+6eUvnpuu4Ytksiz6VpXBBRMrIsj3frM+zUtnq8vKUr+TbjV2qyKR8l3eNDwzqz30
+dlbKh9kIhZafclHfRVfyp+fVSKPfgrRAcLUgAbsVjOjPeJ90xQ4DTMZ6vjiv6tHM
+hkSjJIcGhRtSBzVF/cT38GyCeTmiIA/dRz2d70lWrqDQCdp9ArijgnpjNKAAulSY
+CirnMsGZTDGmLOHg4xOZ5FEAzZI2sFNLlcw=
+-----END PRIVATE KEY-----
+");
+
+// Carrega a chave pública
+$pub = openssl_pkey_get_public("-----BEGIN PUBLIC KEY-----
+MIICJDCCARcGCSqGSIb3DQEDATCCAQgCggEBAJLxRCaZ933uW+AXmabHFDDyupoj
+BIRlbmQLJZfigDaSA1f9YOTsIv+WwVFTX/J1mtCyx9uBcz0Nt2kmVwxWuc2fVtCE
+MPsmLsVXX7xRUFLpyX1Y1IYGBVXQOoOvLWYQjpZgnx47Pkh1Ok1+smffztfC0DCN
+t4KorWrbsPcmqBejXHN79KvWFjZmXOksRiNu/Bn76RiqvofC4z8Ri3kHXQG2197J
+GZzzFXHadGC3xbkg8UxsNbYhVMKbm0iANfafUH7/hoS9UjAVQYtvwe7YNiW/Hnyf
+VCrKwcc7sadd8Iphh+3lf5P1AhaQEAMytanrzq9RDXKBxuvpSJifRYasZYsCAQID
+ggEFAAKCAQAiCSBpxvGgsTorxAWtcAlSmzAJnJxFgSPef0g7OjhESytnc8G2QYmx
+ovMt5KVergcitztWh08hZQUdAYm4rI+zMlAFDdN8LWwBT/mGKSzRkWeprd8E7mvy
+ucqC1YXCMqmIwPySvLQUB/Dl8kgau7BLAnIJm8VP+MVrn8g9gghD0qRCgPgtEaDV
+vocfgnOU43rhKnIgO0cHOKtw2qybSFB8QuZrYugq4j8Bwkrzh6rdMMeyMl/ej5Aj
+c0wamOzuBDtXt0T9+Fx3khHaowjCc7xJZRgZCxg43SbqMWJ9lUg94I7+LTX61Gyv
+dtlkbGbtoDOnxeNnN93gwQZngGYZYciu
+-----END PUBLIC KEY-----
+");
+
+// Produz a versão hexadecimal da chave derivada
+echo bin2hex(openssl_pkey_derive($pub,$priv));
+]]>
+    </programlisting>
+   </example>
+  </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
+-->
diff --git a/reference/openssl/functions/openssl-pkey-export-to-file.xml b/reference/openssl/functions/openssl-pkey-export-to-file.xml
new file mode 100644
index 000000000..c067efbd9
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-export-to-file.xml
@@ -0,0 +1,120 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-export-to-file" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_pkey_export_to_file</refname>
+  <refpurpose>Obtém uma representação exportável de uma chave em um arquivo</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>openssl_pkey_export_to_file</methodname>
+   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>key</parameter></methodparam>
+   <methodparam><type>string</type><parameter>output_filename</parameter></methodparam>
+   <methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>passphrase</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>openssl_pkey_export_to_file</function> salva uma versão ASCII blindada
+   (codificada em <acronym>PEM</acronym>) de <parameter>key</parameter> no arquivo nomeado por
+   <parameter>output_filename</parameter>.
+  </para>
+  &note.openssl.cnf;
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>output_filename</parameter></term>
+     <listitem>
+      <para>
+       Caminho para o arquivo de saída.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>passphrase</parameter></term>
+     <listitem>
+      <para>
+       A chave pode ser opcionalmente protegida por uma senha definida no parâmetro
+       <parameter>passphrase</parameter>.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>options</parameter></term>
+     <listitem>
+      <para>
+       <parameter>options</parameter> pode ser usado para fazer ajuste fino do processo
+       de exportação especificando e/ou substituindo opções para o arquivo de
+       configuração do openssl. Consulte <function>openssl_csr_new</function> para obter
+       mais informações sobre <parameter>options</parameter>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </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>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
+-->
diff --git a/reference/openssl/functions/openssl-pkey-export.xml b/reference/openssl/functions/openssl-pkey-export.xml
new file mode 100644
index 000000000..8624a8be5
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-export.xml
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-export" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_pkey_export</refname>
+  <refpurpose>Obtém uma representação exportável de uma chave em uma string</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>openssl_pkey_export</methodname>
+   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>key</parameter></methodparam>
+   <methodparam><type>string</type><parameter role="reference">output</parameter></methodparam>
+   <methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>passphrase</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>openssl_pkey_export</function> exporta a chave
+   <parameter>key</parameter> como uma string codificada em <acronym>PEM</acronym> e a armazena na
+   string <parameter>output</parameter> (que é passada por referência).
+  </para>
+  &note.openssl.cnf;
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>output</parameter></term>
+     <listitem>
+      <para>
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>passphrase</parameter></term>
+     <listitem>
+      <para>
+       A chave é opcionalmente protegida por uma senha informada em <parameter>passphrase</parameter>.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>options</parameter></term>
+     <listitem>
+      <para>
+       <parameter>options</parameter> pode ser usado para fazer ajuste fino do processo
+       de exportação especificando e/ou substituindo opções para o arquivo de
+       configuração do openssl. Consulte <function>openssl_csr_new</function> para obter
+       mais informações sobre <parameter>options</parameter>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </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>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
+-->
diff --git a/reference/openssl/functions/openssl-pkey-free.xml b/reference/openssl/functions/openssl-pkey-free.xml
new file mode 100644
index 000000000..e91f4ffdd
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-free.xml
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 52dc204a77076e1404257cf39f179882b90b5780 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-free" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_pkey_free</refname>
+  <refpurpose>Libera uma chave privada</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-0-0;
+ </refsynopsisdiv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>void</type><methodname>openssl_pkey_free</methodname>
+   <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
+  </methodsynopsis>
+  &note.resource-migration-8.0-dead-function;
+  <para>
+   Esta função libera uma chave privada criada por
+   <function>openssl_pkey_new</function>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+       Recurso que contém a chave.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </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>
+       Esta função agora está descontinuada e não tem mais efeito.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>key</parameter> agora aceita uma instância de <classname>OpenSSLAsymmetricKey</classname>;
+       anteriormente, um &resource; do tipo <literal>OpenSSL key</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
+-->
diff --git a/reference/openssl/functions/openssl-pkey-get-details.xml b/reference/openssl/functions/openssl-pkey-get-details.xml
new file mode 100644
index 000000000..72ddc3524
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-get-details.xml
@@ -0,0 +1,258 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 0e80601cabf499c7db372149916b5cb3e2740f1b Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-get-details" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_pkey_get_details</refname>
+  <refpurpose>Retorna um array com os detalhes da chave</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>array</type><type>false</type></type><methodname>openssl_pkey_get_details</methodname>
+   <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Esta função retorna os detalhes da chave (bits, chave, tipo).
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+       Recurso que contém a chave.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna um array com os principais detalhes em caso de sucesso ou &false; em caso de falha.
+   O array retornado tem os índices <literal>bits</literal> (número de bits),
+   <literal>key</literal> (representação em string da chave pública) e
+   <literal>type</literal> (tipo da chave que é uma das constantes
+   <constant>OPENSSL_KEYTYPE_RSA</constant>,
+   <constant>OPENSSL_KEYTYPE_DSA</constant>,
+   <constant>OPENSSL_KEYTYPE_DH</constant>,
+   <constant>OPENSSL_KEYTYPE_EC</constant> ou -1 que significa desconhecido).
+  </para>
+  <para>
+   Dependendo do tipo de chave utilizado, detalhes adicionais poderão ser retornados. Observe que
+   alguns elementos podem nem sempre estar disponíveis.
+  </para>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <constant>OPENSSL_KEYTYPE_RSA</constant>, uma chave de array adicional chamada <literal>"rsa"</literal>,
+     contendo os dados da chave, é retornada.
+    </simpara>
+     <informaltable>
+      <tgroup cols="2">
+       <thead>
+        <row>
+         <entry>Chave</entry>
+         <entry>&Description;</entry>
+        </row>
+       </thead>
+       <tbody>
+        <row>
+         <entry><literal>"n"</literal></entry>
+         <entry>módulo</entry>
+        </row>
+        <row>
+         <entry><literal>"e"</literal></entry>
+         <entry>expoente público</entry>
+        </row>
+        <row>
+         <entry><literal>"d"</literal></entry>
+         <entry>expoente privado</entry>
+        </row>
+        <row>
+         <entry><literal>"p"</literal></entry>
+         <entry>primo número 1</entry>
+        </row>
+        <row>
+         <entry><literal>"q"</literal></entry>
+         <entry>primo número 2</entry>
+        </row>
+        <row>
+         <entry><literal>"dmp1"</literal></entry>
+         <entry>expoente 1, d mod (p-1)</entry>
+        </row>
+        <row>
+         <entry><literal>"dmq1"</literal></entry>
+         <entry>expoente 2, d mod (q-1)</entry>
+        </row>
+        <row>
+         <entry><literal>"iqmp"</literal></entry>
+         <entry>coeficiente, (inverso de q) mod p</entry>
+        </row>
+       </tbody>
+      </tgroup>
+     </informaltable>
+   </listitem>
+   <listitem>
+    <simpara>
+     <constant>OPENSSL_KEYTYPE_DSA</constant>, uma chave de array adicional chamada <literal>"dsa"</literal>,
+     contendo os dados da chave, é retornada.
+    </simpara>
+     <informaltable>
+      <tgroup cols="2">
+       <thead>
+        <row>
+         <entry>Chave</entry>
+         <entry>&Description;</entry>
+        </row>
+       </thead>
+       <tbody>
+        <row>
+         <entry><literal>"p"</literal></entry>
+         <entry>número primo (público)</entry>
+        </row>
+        <row>
+         <entry><literal>"q"</literal></entry>
+         <entry>sub-primo de 160 bits, q | p-1 (público)</entry>
+        </row>
+        <row>
+         <entry><literal>"g"</literal></entry>
+         <entry>gerador de subgrupo (público)</entry>
+        </row>
+        <row>
+         <entry><literal>"priv_key"</literal></entry>
+         <entry>chave privada x</entry>
+        </row>
+        <row>
+         <entry><literal>"pub_key"</literal></entry>
+         <entry>chave pública y = g^x</entry>
+        </row>
+       </tbody>
+      </tgroup>
+     </informaltable>
+   </listitem>
+   <listitem>
+    <simpara>
+     <constant>OPENSSL_KEYTYPE_DH</constant>, uma chave de array adicional chamada <literal>"dh"</literal>,
+     contendo os dados da chave, é retornada.
+    </simpara>
+     <informaltable>
+      <tgroup cols="2">
+       <thead>
+        <row>
+         <entry>Chave</entry>
+         <entry>&Description;</entry>
+        </row>
+       </thead>
+       <tbody>
+        <row>
+         <entry><literal>"p"</literal></entry>
+         <entry>número primo (compartilhado)</entry>
+        </row>
+        <row>
+         <entry><literal>"g"</literal></entry>
+         <entry>gerador de Z_p (compartilhado)</entry>
+        </row>
+        <row>
+         <entry><literal>"priv_key"</literal></entry>
+         <entry>valor DH privado x</entry>
+        </row>
+        <row>
+         <entry><literal>"pub_key"</literal></entry>
+         <entry>valor DH público g^x</entry>
+        </row>
+       </tbody>
+      </tgroup>
+     </informaltable>
+   </listitem>
+   <listitem>
+    <simpara>
+     <constant>OPENSSL_KEYTYPE_EC</constant>, uma chave de array adicional chamada <literal>"ec"</literal>,
+     contendo os dados da chave, é retornada.
+    </simpara>
+     <informaltable>
+      <tgroup cols="2">
+       <thead>
+        <row>
+         <entry>Chave</entry>
+         <entry>&Description;</entry>
+        </row>
+       </thead>
+       <tbody>
+        <row>
+         <entry><literal>"curve_name"</literal></entry>
+         <entry>nome da curva, consulte <function>openssl_get_curve_names</function></entry>
+        </row>
+        <row>
+         <entry><literal>"curve_oid"</literal></entry>
+         <entry>identificador de objeto ASN1 (OID) para a curva EC.</entry>
+        </row>
+        <row>
+         <entry><literal>"x"</literal></entry>
+         <entry>coordenada x (pública)</entry>
+        </row>
+        <row>
+         <entry><literal>"y"</literal></entry>
+         <entry>coordenada y (pública)</entry>
+        </row>
+        <row>
+         <entry><literal>"d"</literal></entry>
+         <entry>chave privada</entry>
+        </row>
+       </tbody>
+      </tgroup>
+     </informaltable>
+   </listitem>
+  </itemizedlist>
+ </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>key</parameter> agora aceita uma instância de <classname>OpenSSLAsymmetricKey</classname>;
+       anteriormente, um &resource; do tipo <literal>OpenSSL key</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
+-->
diff --git a/reference/openssl/functions/openssl-pkey-get-private.xml b/reference/openssl/functions/openssl-pkey-get-private.xml
new file mode 100644
index 000000000..bb64a6888
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-get-private.xml
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-get-private" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_pkey_get_private</refname>
+  <refpurpose>Obtém uma chave privada</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>OpenSSLAsymmetricKey</type><type>false</type></type><methodname>openssl_pkey_get_private</methodname>
+   <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>
+   <methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>passphrase</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>openssl_pkey_get_private</function> analisa a chave privada
+   <parameter>private_key</parameter> e prepara-a para uso por outras funções.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>private_key</parameter></term>
+     <listitem>
+      <para>
+       <parameter>private_key</parameter> pode ser uma das seguintes opções:
+       <orderedlist>
+        <listitem><simpara>uma string no formato
+          <filename>file://caminho/para/arquivo.pem</filename>. O arquivo precisa
+          conter uma chave privada ou certificado (pode conter ambos) codificados em <acronym>PEM</acronym>.
+         </simpara>
+        </listitem>
+        <listitem><simpara>Uma chave privada no formato <acronym>PEM</acronym>.</simpara></listitem>
+       </orderedlist>
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>passphrase</parameter></term>
+     <listitem>
+      <para>
+       O parâmetro opcional <parameter>passphrase</parameter> contém uma senha que precisa ser usada
+       se a chave especificada for criptografada (protegida por uma senha).
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna uma instância de <classname>OpenSSLAsymmetricKey</classname> em caso de sucesso ou &false; 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>
+       Em caso de sucesso, esta função retorna uma instância <classname>OpenSSLAsymmetricKey</classname> agora;
+       anteriormente, retornava um &resource; do tipo <literal>OpenSSL key</literal>.
+      </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>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>passphrase</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
+-->
diff --git a/reference/openssl/functions/openssl-pkey-get-public.xml b/reference/openssl/functions/openssl-pkey-get-public.xml
new file mode 100644
index 000000000..aab1aa191
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-get-public.xml
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 497c40ac164d5873fd87f622dfdeb5206392b446 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-get-public" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_pkey_get_public</refname>
+  <refpurpose>Extrai a chave pública do certificado e prepara-a para uso</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>OpenSSLAsymmetricKey</type><type>false</type></type><methodname>openssl_pkey_get_public</methodname>
+   <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>public_key</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>openssl_pkey_get_public</function> extrai a chave pública de
+   <parameter>public_key</parameter> e prepara-a para uso por outras
+   funções.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>public_key</parameter></term>
+     <listitem>
+      <para>
+       <parameter>public_key</parameter> pode ser uma das seguintes opções:
+       <orderedlist>
+        <listitem><simpara>uma instância de <classname>OpenSSLAsymmetricKey</classname></simpara></listitem>
+        <listitem><simpara>uma string no formato
+          <filename>file://caminho/para/arquivo.pem</filename>. O arquivo precisa
+          conter uma chave pública ou certificado (pode conter ambos) codificados em <acronym>PEM</acronym>.
+         </simpara>
+        </listitem>
+        <listitem><simpara>Uma chave pública no formato <acronym>PEM</acronym>.</simpara></listitem>
+       </orderedlist>
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna uma instância de <classname>OpenSSLAsymmetricKey</classname> em caso de sucesso ou &false; 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>
+       Em caso de sucesso, esta função retorna uma instância <classname>OpenSSLAsymmetricKey</classname> agora;
+       anteriormente, retornava um &resource; do tipo <literal>OpenSSL key</literal>.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>public_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
+-->
diff --git a/reference/openssl/functions/openssl-pkey-new.xml b/reference/openssl/functions/openssl-pkey-new.xml
new file mode 100644
index 000000000..dc4a794e2
--- /dev/null
+++ b/reference/openssl/functions/openssl-pkey-new.xml
@@ -0,0 +1,153 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 2e08eac2b22e4cfa97635d5d38b0984b5016a2f3 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.openssl-pkey-new" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>openssl_pkey_new</refname>
+  <refpurpose>Gera uma nova chave privada</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>OpenSSLAsymmetricKey</type><type>false</type></type><methodname>openssl_pkey_new</methodname>
+   <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>openssl_pkey_new</function> gera uma nova chave
+   privada.
+   Como obter o componente público da chave é mostrado no exemplo abaixo.
+  </para>
+  &note.openssl.cnf;
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>options</parameter></term>
+     <listitem>
+      <para>
+       Pode ser feito ajuste fino na geração de chaves (como especificar o número de
+       bits) usando <parameter>options</parameter>. Consulte
+       <function>openssl_csr_new</function> para obter mais informações sobre
+       <parameter>options</parameter>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna uma instância de <classname>OpenSSLAsymmetricKey</classname> para
+   a chave privada em caso de sucesso ou &false; 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>
+       Em caso de sucesso, esta função retorna uma instância <classname>OpenSSLAsymmetricKey</classname> agora;
+       anteriormente, retornava um &resource; do tipo <literal>OpenSSL key</literal>.
+      </entry>
+     </row>
+     <row>
+      <entry>7.1.0</entry>
+      <entry>
+       A chave <literal>curve_name</literal> do parâmetro <parameter>options</parameter> foi
+       adicionada para tornar possível a criação de chaves EC com base nos algoritmos de Curva Elíptica.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.openssl-pkey-new.example.public-key">
+   <title>Obtendo a chave pública de uma chave privada</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$private_key = openssl_pkey_new();
+
+$public_key_pem = openssl_pkey_get_details($private_key)['key'];
+echo $public_key_pem, PHP_EOL;
+
+$public_key = openssl_pkey_get_public($public_key_pem);
+var_dump($public_key);
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+// Saída anterior ao PHP 8.0.0; observe que a função retorna um recurso
+-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwknBFEherZe74BiRjTFA
+hqwZ1SK7brwq7C/afnLXKhRR7jnrpfM0ypC46q8xz5UZswenZakJ7kd5fls+r4Bv
+3P8XsKYLTh2m1GiWQhV1g77cNIN4qNWh70PiDO3fB2446o1LBgToQYuRZS5YQRfJ
+rVD0ysgtVcCU9tjaey28HlgApOpYFTaaKPj2MBmEYpMC+kG2HhL12GfpHUi2eiXI
+dXT2WskWHWvUrmQ7fJIfI92JlDokV62DH/q1oiedLs9OPNb0rL1aAmYdzaVN6XNH
+x/o4Lh125v2vAPV9E3fZCDc/HDEUaahpjanMiCQEgEDp5Hr+CRkvERT5/ydN+p08
+5wIDAQAB
+-----END PUBLIC KEY-----
+
+resource(6) of type (OpenSSL key)
+
+// Saída a partir do PHP 8.0.0; observe que a função retorna um objeto
+-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwknBFEherZe74BiRjTFA
+hqwZ1SK7brwq7C/afnLXKhRR7jnrpfM0ypC46q8xz5UZswenZakJ7kd5fls+r4Bv
+3P8XsKYLTh2m1GiWQhV1g77cNIN4qNWh70PiDO3fB2446o1LBgToQYuRZS5YQRfJ
+rVD0ysgtVcCU9tjaey28HlgApOpYFTaaKPj2MBmEYpMC+kG2HhL12GfpHUi2eiXI
+dXT2WskWHWvUrmQ7fJIfI92JlDokV62DH/q1oiedLs9OPNb0rL1aAmYdzaVN6XNH
+x/o4Lh125v2vAPV9E3fZCDc/HDEUaahpjanMiCQEgEDp5Hr+CRkvERT5/ydN+p08
+5wIDAQAB
+-----END PUBLIC KEY-----
+
+object(OpenSSLAsymmetricKey)#2 (0) {
+}
+]]>
+   </screen>
+  </example>
+ </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
+-->