cvs: phpdoc-de /reference/openssl constants.xml /reference/openssl/functions openssl-csr-export-to-file.xml openssl-csr-export.xml
openssl-csr-new.xml openssl-csr-sign.xml openssl-error-string.xml openssl-free-key.xml openssl-get-privatekey.xml openssl-get-publickey.xml
openssl-open.xml openssl-pkcs7-decrypt.xml openssl-pkcs7-encrypt.xml openssl-pkcs7-sign.xml openssl-pkcs7-verify.xml openssl-pkey-export-to-file.xml
openssl-pkey-export.xml openssl-pkey-new.xml openssl-private-decrypt.xml openssl-private-encrypt.xml openssl-public-decrypt.xml
openssl-public-encrypt.xml openssl-seal.xml openssl-sign.xml openssl-verify.xml openssl-x509-check-private-key.xml openssl-x509-checkpurpose.xml
openssl-x509-export-to-file.xml openssl-x509-export.xml openssl-x509-free.xml openssl-x509-parse.xml openssl-x509-read.xml
| From: | Friedhelm Betz | Date: | Sun, 18 Jan 2004 23:57:54 +0000 |
| Subject: | cvs: phpdoc-de /reference/openssl constants.xml /reference/openssl/functions openssl-csr-export-to-file.xml openssl-csr-export.xml openssl-csr-new.xml openssl-csr-sign.xml openssl-error-string.xml openssl-free-key.xml openssl-get-privatekey.xml openssl-get-publickey.xml openssl-open.xml openssl-pkcs7-decrypt.xml openssl-pkcs7-encrypt.xml openssl-pkcs7-sign.xml openssl-pkcs7-verify.xml openssl-pkey-export-to-file.xml openssl-pkey-export.xml openssl-pkey-new.xml openssl-private-decrypt.xml openssl-private-encrypt.xml openssl-public-decrypt.xml openssl-public-encrypt.xml openssl-seal.xml openssl-sign.xml openssl-verify.xml openssl-x509-check-private-key.xml openssl-x509-checkpurpose.xml openssl-x509-export-to-file.xml openssl-x509-export.xml openssl-x509-free.xml openssl-x509-parse.xml openssl-x509-read.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-1062@lists.php.net to get a copy of this message | ||
betz Sun Jan 18 18:57:54 2004 EDT
Modified files:
/phpdoc-de/reference/openssl constants.xml
/phpdoc-de/reference/openssl/functions
openssl-csr-export-to-file.xml
openssl-csr-export.xml
openssl-csr-new.xml
openssl-csr-sign.xml
openssl-error-string.xml
openssl-free-key.xml
openssl-get-privatekey.xml
openssl-get-publickey.xml
openssl-open.xml
openssl-pkcs7-decrypt.xml
openssl-pkcs7-encrypt.xml
openssl-pkcs7-sign.xml
openssl-pkcs7-verify.xml
openssl-pkey-export-to-file.xml
openssl-pkey-export.xml
openssl-pkey-new.xml
openssl-private-decrypt.xml
openssl-private-encrypt.xml
openssl-public-decrypt.xml
openssl-public-encrypt.xml
openssl-seal.xml
openssl-sign.xml
openssl-verify.xml
openssl-x509-check-private-key.xml
openssl-x509-checkpurpose.xml
openssl-x509-export-to-file.xml
openssl-x509-export.xml
openssl-x509-free.xml
openssl-x509-parse.xml
openssl-x509-read.xml
Log:
sync to en
Index: phpdoc-de/reference/openssl/constants.xml diff -u phpdoc-de/reference/openssl/constants.xml:1.1 phpdoc-de/reference/openssl/constants.xml:1.2 --- phpdoc-de/reference/openssl/constants.xml:1.1 Tue Sep 3 13:59:07 2002 +++ phpdoc-de/reference/openssl/constants.xml Sun Jan 18 18:57:52 2004 @@ -1,13 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.1 Maintainer: betz Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <section id="openssl.constants"> &reftitle.constants; &extension.constants; + <section id="openssl.purpose-check"> + <title>Zweckprüfende Flags</title> <variablelist> <varlistentry> <term> <constant>X509_PURPOSE_SSL_CLIENT</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -18,7 +20,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_SSL_SERVER</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -29,7 +31,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_NS_SSL_SERVER</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -40,7 +42,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_SMIME_SIGN</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -51,7 +53,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_SMIME_ENCRYPT</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -62,7 +64,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_CRL_SIGN</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -73,7 +75,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_ANY</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -81,10 +83,16 @@ </simpara> </listitem> </varlistentry> + </variablelist> + </section> + + <section id="openssl.padding"> + <title>Padding Flags</title> + <variablelist> <varlistentry> <term> <constant>OPENSSL_PKCS1_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -95,7 +103,7 @@ <varlistentry> <term> <constant>OPENSSL_SSLV23_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -106,7 +114,7 @@ <varlistentry> <term> <constant>OPENSSL_NO_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -117,7 +125,7 @@ <varlistentry> <term> <constant>OPENSSL_PKCS1_OAEP_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -125,10 +133,16 @@ </simpara> </listitem> </varlistentry> + </variablelist> + </section> + + <section id="openssl.key-types"> + <title>Key types</title> + <variablelist> <varlistentry> <term> <constant>OPENSSL_KEYTYPE_RSA</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -139,7 +153,7 @@ <varlistentry> <term> <constant>OPENSSL_KEYTYPE_DSA</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -150,7 +164,7 @@ <varlistentry> <term> <constant>OPENSSL_KEYTYPE_DH</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -159,14 +173,14 @@ </listitem> </varlistentry> </variablelist> + </section> <section id="openssl.pkcs7.flags"> - <title>PKCS7 Kennzeichen/Konstanten</title> + <title>PKCS7 Flags/Konstanten</title> <para> - Die S/MIME Funktionen nutzen Kennzeichen die sich dadurch auszeichnen, dass + Die S/MIME Funktionen nutzen Flags die sich dadurch auszeichnen, dass sie ein Bitfeld benutzen, das einen oder mehrere der folgenden Werte enthalten kann: - <table> <title>PKCS7 KONSTANTEN</title> <tgroup cols="2"> @@ -179,85 +193,94 @@ <tbody> <row> <entry>PKCS7_TEXT</entry> - <entry>Fügt den text/plain Inhaltstyp Header einer - verschlüsselten/signierten Nachricht hinzu. - Wenn Sie entschlüsseln oder überprüfen, werden diese Header - von der Ausgabe entfernt - wenn die entschlüsselte oder - geprüfte Nachricht nicht dem MIME Typ text/plain entspricht, - tritt ein Fehler auf.</entry> + <entry> + Fügt den Inhaltstyp Header text/plain einer + verschlüsselten/signierten Nachricht hinzu. Wenn Sie entschlüsseln + oder überprüfen, werden diese Header von der Ausgabe entfernt. + Entspricht die entschlüsselte oder geprüfte Nachricht nicht dem MIME + Typ text/plain, tritt ein Fehler auf. + </entry> </row> <row> <entry>PKCS7_BINARY</entry> - <entry>Normalerweise wird die Nachricht in ein "kanonisches" - Format konvertiert, das effektiv CR und LF als Zeilende benutzt: - wie von der S/MIME Spezifikation gefordert. - Wird diese Option angegeben, findet keine Konvertierung statt. - Das kann sich als nützlich erweisen, wenn Sie mit binären Daten - umgehen, die nicht dem MIME Format entprechen. + <entry> + Normalerweise wird die Nachricht in ein "kanonisches" Format + konvertiert, das effektiv CR und LF als Zeilende benutzt, wie von + der S/MIME Spezifikation gefordert. Wird diese Option angegeben, + findet keine Konvertierung statt. Das kann sich als nützlich + erweisen, wenn Sie es mit binären Daten zu tun haben, die nicht dem + MIME Format entprechen. </entry> </row> <row> <entry>PKCS7_NOINTERN</entry> - <entry>Wenn Sie eine Nachricht überprüfen, werden in der Nachricht - enthaltene Zertifikate (falls es welche gibt) nach dem - unterzeichnenden Zertifikat durchsucht. Mit dieser Option werden - nur Zertifikate benutzt, die mit dem Parameter - <parameter>extracerts</parameter> in der Funktion - <function>openssl_pkcs7_verify</function> angegeben wurden. - Die mitgelieferten Zertifikate können aber dennoch als nicht - vertrauenswürdige CAs benutzt werden. + <entry> + Wenn Sie eine Nachricht überprüfen, werden in der Nachricht + enthaltene Zertifikate (falls es welche gibt) nach dem + unterzeichnenden Zertifikat durchsucht. Mit dieser Option werden nur + Zertifikate benutzt, die mit dem Parameter + <parameter>extracerts</parameter> in der Funktion + <function>openssl_pkcs7_verify</function> angegeben wurden. Die + mitgelieferten Zertifikate können aber dennoch als nicht + vertrauenswürdige CAs benutzt werden. </entry> </row> <row> <entry>PKCS7_NOVERIFY</entry> - <entry>Keine Überprüfung des signierenden Zertifikats - einer signierten Nachricht.</entry> + <entry> + Keine Überprüfung des signierenden Zertifikats einer signierten + Nachricht. + </entry> </row> <row> <entry>PKCS7_NOCHAIN</entry> - <entry>Keine Verknüpfung der Überprüfung des Zertifikats mit den - Zertifikaten des Unterzeichners: das bedeutet, die Zertifikate in - der signierten Nachricht werden nicht als unvertrauenswürdige CAs - benutzt. + <entry> + Keine Verknüpfung der Überprüfung des Zertifikats mit den + Zertifikaten des Unterzeichners: das bedeutet, die Zertifikate in + der signierten Nachricht werden nicht als nicht vertrauenswürdige + CAs benutzt. </entry> </row> <row> <entry>PKCS7_NOCERTS</entry> - <entry>Beim Signieren einer Nachricht wird normalerweise das - Zertifikat des Unterzeichnenden mit in die Nachricht - aufgenommen - mit dieser Option wird das Zertifikat nicht - mit aufgenommen. Diese Option verringert die Größe der signierten - Nachricht, aber der Überprüfende muss eine lokale Kopie des - Zertifikats vom Unterzeichnenden besitzen (zum Beispiel durch Angabe - des Parameters <parameter>extracerts</parameter> in der Funktion - <function>openssl_pkcs7_verify</function>). + <entry> + Beim Signieren einer Nachricht wird normalerweise das Zertifikat des + Unterzeichnenden mit in die Nachricht aufgenommen - mit dieser + Option wird das Zertifikat nicht mit aufgenommen. Diese Option + verringert die Größe der signierten Nachricht, aber der Überprüfende + muss eine lokale Kopie des Zertifikats vom Unterzeichnenden besitzen + (zum Beispiel durch Angabe des Parameters + <parameter>extracerts</parameter> in der Funktion + <function>openssl_pkcs7_verify</function>). </entry> </row> <row> <entry>PKCS7_NOATTR</entry> - <entry>Beim Signieren einer Nachricht wird normalerweise eine Reihe - von Attributen mit angehängt. Diese enthalten die Zeit der Signierung - und die unterstützen symmetrischen Algorithmen. Mit dieser Option werden - diese Attribute nicht mit aufgenommen. + <entry> + Beim Signieren einer Nachricht wird normalerweise eine Reihe von + Attributen mit angehängt. Diese enthalten die Zeit der Signierung + und die unterstützen symmetrischen Algorithmen. Mit dieser Option + werden diese Attribute nicht mit aufgenommen. </entry> </row> <row> <entry>PKCS7_DETACHED</entry> - <entry>Beim Signieren einer Nachricht wird Klartext-Signierung - verwendet mit MIME Typ multipart/signed. Das ist der Standard, - wenn Sie keinen optionalen Parameter <parameter>flags</parameter> - an die Funktion <function>openssl_pkcs7_sign</function> übergeben. - Wenn Sie diese Option ausschalten wird die Nachricht mit einer - undurchsichtigen Signatur unterzeichnet. Dieses Verhalten ist robuster - gegenüber der Übersetzung durch Mail-Relays, kann aber nicht mit - Mailprogrammen gelesen werden, die nicht den S/Mime Standard - unterstützen. + <entry> + Beim Signieren einer Nachricht wird Klartext-Signierung verwendet + mit dem MIME Typ multipart/signed. Das ist der Standard, wenn Sie + keinen optionalen Parameter <parameter>flags</parameter> + an die Funktion <function>openssl_pkcs7_sign</function> übergeben. + Wenn Sie diese Option ausschalten wird die Nachricht mit einer + undurchsichtigen Signatur unterzeichnet. Dieses Verhalten ist robuster + gegenüber der Übersetzung durch Mail-Relays, kann aber nicht mit + Mailprogrammen gelesen werden, die nicht den S/Mime Standard + unterstützen. </entry> </row> <row> <entry>PKCS7_NOSIGS</entry> - <entry>Kein Versuch und keine Überprüfung der Signaturen einer - Nachricht. + <entry> + Kein Versuch und keine Überprüfung der Signaturen einer Nachricht. </entry> </row> </tbody> @@ -268,6 +291,70 @@ <para>Diese Konstanten wurden in 4.0.6 hinzugefügt.</para> </note> </section> + +<!-- + <section id="openssl.ciphers"> + <title>Ciphers</title> + <variablelist> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_RC2_40</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_RC2_128</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_RC2_64</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_DES</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_3DES</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + </variablelist> + </section> +--> + </section> <!-- Keep this comment at the end of the file @@ -290,5 +377,3 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> - - \ No newline at end of file Index: phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml:1.4 phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml:1.5 --- phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml:1.4 Tue Sep 3 13:59:07 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml Sun Jan 18 18:57:53 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-export-to-file"> <refnamediv> <refname>openssl_csr_export_to_file</refname> @@ -14,15 +14,21 @@ <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - <function>openssl_csr_export_to_file</function> exportiert einen CSR, - angegeben mit <parameter>csr</parameter> und speichert diesen in eine - Datei mit dem Namen <parameter>outfilename</parameter>. Der optionale - Parameter <parameter>notext</parameter> beeinflusst den Umfang der - Ausgabe; ist dieser auf &false; gesetzt werden zusätzliche, für Menschen - lesbare, Informationen in der Datei mit ausgegeben. + <function>openssl_csr_export_to_file</function> exportiert die mit dem + Parameter <parameter>csr</parameter> angegebene + Zertifikatssignierungsanfrage und speichert diese als ASCII-armierten + Text in die Datei mit dem Namen <parameter>outfilename</parameter>. </para> + &reference.openssl.parameter-notext; + <para> + &return.success; + </para> + <simpara> + Siehe auch <function>openssl_csr_export</function>, + <function>openssl_csr_new</function> und + <function>openssl_csr_sign</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-csr-export.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-export.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-csr-export.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-csr-export.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-export.xml Sun Jan 18 18:57:53 2004 @@ -1,26 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-csr-export' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-export"> <refnamediv> <refname>openssl_csr_export</refname> - <refpurpose>Exportiert ein CSR in eine Datei oder eine Variable </refpurpose> + <refpurpose>Exportiert einen CSR als Zeichenkette</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>openssl_csr_export</methodname> <methodparam><type>resource</type><parameter>csr</parameter></methodparam> - <methodparam><type>string</type><parameter>out</parameter></methodparam> + <methodparam><type>string</type><parameter>&out</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_csr_export</function> exportiert die mit dem Parameter + <parameter>csr</parameter> angegebene Zertifikatssignierungsanfrage und + speichert diese als ASCII-armierten Text in <parameter>out</parameter>, + der per Referenz übergeben wird. </para> + &reference.openssl.parameter-notext; + <para> + &return.success; + </para> + <simpara> + Siehe auch <function>openssl_csr_export_to_file</function>, + <function>openssl_csr_new</function> und + <function>openssl_csr_sign</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-csr-new.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-new.xml:1.4 phpdoc-de/reference/openssl/functions/openssl-csr-new.xml:1.5 --- phpdoc-de/reference/openssl/functions/openssl-csr-new.xml:1.4 Tue Sep 3 13:59:07 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-new.xml Sun Jan 18 18:57:53 2004 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.11 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-new"> <refnamediv> <refname>openssl_csr_new</refname> - <refpurpose>Erzeugt einen privaten Schlüssesl und ein CSR </refpurpose> + <refpurpose>Erzeugt einen CSR </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -13,16 +13,178 @@ <type>bool</type><methodname>openssl_csr_new</methodname> <methodparam><type>array</type><parameter>dn</parameter></methodparam> <methodparam><type>resource</type><parameter>privkey</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>extraattribs</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>extraattribs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>openssl_csr_new</function> erzeugt einen neuen CSR - (Certificate Signing Request) basierend auf den Informationen, die mit + (Zertifikatssignierungsanfrage) basierend auf den Informationen, die mit dem Parameter <parameter>dn</parameter> angegeben werden. Dieser bestimmt den Distinguished Name, der im Zertifikat benutzt werden soll. </para> + <para> + <parameter>privkey</parameter> sollte auf einen privaten Schlüssel + zeigen, der vorher mit <function>openssl_pkey_new</function> erzeugt + wurde (oder den Sie auf andere Weise von der Familie der openssl_pkey + Funktionen erhalten haben). Der entsprechende öffentliche Teil des + Schlüssels wird benutzt um den CSR zu signieren. + </para> + <para> + <parameter>extraattribs</parameter> können Sie benutzen um zusätzliche + Konfigurationsoptionen für den CSR anzugeben. Sowohl + <parameter>dn</parameter> als auch <parameter>extraattribs</parameter> + sind assoziative Arrays, deren Schlüssel zu OIDs konvertiert und auf den + relevanten Teil der Anfrage angewendet werden. + </para> + &reference.openssl.note-openssl-cnf; + <para> + Im Standard werden die Informationen für die Anfrage aus der + <literal>openssl.conf</literal> ihres Systems benutzt. Sie können einen + Konfigurationsabsschnitt mit dem Schlüssel + <literal>config_section_section</literal> des Arrays + <parameter>configargs</parameter>setzen. Außerdem haben Sie die + Möglichkeit eine alternative openssl Konfigurationsdatei anzugeben, indem + Sie den Wert des Schlüssels <literal>config</literal> auf den Pfad zu der + Datei setzen, die Sie benutzen möchten. Die unten in der Tabelle + aufgeführten Schlüssel in <parameter>configargs</parameter>, falls Sie + diese definiert haben, verhalten sich genau gleich wie die entsprechenden + Werte in der <literal>openssl.conf</literal> + <table> + <title>Überschreiben der Konfiguration</title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>configargs</parameter> Schlüssel</entry> + <entry>Typ</entry> + <entry><literal>openssl.conf</literal> Entsprechung</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry>digest_alg</entry> + <entry><type>string</type></entry> + <entry>default_md</entry> + <entry>Bestimmt welche digest Methode benutzt wird</entry> + </row> + <row> + <entry>x509_extensions</entry> + <entry><type>string</type></entry> + <entry>x509_extensions</entry> + <entry> + Bestimmt welche Erweiterung benutzt werden soll, wenn ein x509 + Zertifikat erzeugt werden soll. + </entry> + </row> + <row> + <entry>req_extensions</entry> + <entry><type>string</type></entry> + <entry>req_extensions</entry> + <entry> + Bestimmt welche Erweiterung benutzt werden soll, wenn eine + Zertifikatssignierungsanfrage (CSR) erzeugt werden soll. + </entry> + </row> + <row> + <entry>private_key_bits</entry> + <entry><type>string</type></entry> + <entry>default_bits</entry> + <entry> + Bestimmt wieviele Bits verwendet werden, um einen privaten Schlüssel + zu erzeugen. + </entry> + </row> + <row> + <entry>private_key_type</entry> + <entry><type>integer</type></entry> + <entry>none</entry> + <entry> + Bestimmt den Typ des privaten Schlüssels der erzeugt werden soll. + Der Typ kann einer der folgenden sein: + <constant>OPENSSL_KEYTYPE_DSA</constant>, + <constant>OPENSSL_KEYTYPE_DH</constant> oder + <constant>OPENSSL_KEYTYPE_RSA</constant>. Der Standardwert ist + <constant>OPENSSL_KEYTYPE_RSA</constant>, momentan ist das der + einzige Schlüsseltyp, der unterstützt wird. + </entry> + </row> + <row> + <entry>encrypt_key</entry> + <entry><type>boolean</type></entry> + <entry>encrypt_key</entry> + <entry> + Soll ein exportiertet Schlüssel (mit Passphrase) verschlüsselt + werden? + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <simpara> + &return.success; + </simpara> + <para> + <example> + <title> + <function>openssl_csr_new</function> Beispiel - erzeugen eines + selbstsignierten Zertifikats + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// Angabe der Daten für den distinguished name, der in dem Zertifikat benutzt +// wird. Sie müssen die Werte dieser Schlüssel so anpassen, dass diese ihrem +// Namen und Firma entsprechen, oder um präziser zu sein, den Namen und die +// Firma der Person/Seite angeben, für die Sie das Zertifikat erzeugen. +// Für SSL Zertifikate entspricht der commonName gewöhnlich dem Domainnamen, +// für den das Zertifikat benutzt werden soll, aber bei S/MIME Zertifikaten +// entspricht der commonName dem Namen der Person, die das Zertifikat nutzen +// möchte. +$dn = array( + "countryName" => "UK", + "stateOrProvinceName" => "Somerset", + "localityName" => "Glastonbury", + "organizationName" => "The Brain Room Limited", + "organizationalUnitName" => "PHP Documentation Team", + "commonName" => "Wez Furlong", + "emailAddress" => "wez@example.com" +); + +// Erzeugen eines neuen privaten (und öffentlichen) Schlüsselpaars +$privkey = openssl_pkey_new(); + +// Erzeugen einer Zertifikatssignierungsanfrage +$csr = openssl_csr_new($dn, $privkey); + +// Gewöhnlicherweise möchten Sie zu diesem Zeitpunkt ein selbstsigniertes +// Zertifikat erzeugen, das Sie benutzten können, bis ihre CA ihre Anfrage +// im positiven Sinne bearbeitet hat. +// Erzeugen eines selbstsignierten Zertifikts, das für die Dauer von 365 Tagen +// gültig ist. +$sscert = openssl_csr_sign($csr, null, $privkey, 365); + +// Jetzt möchten Sie ihren privaten Schlüssel, ihren CSR und das +// selbstsignierte Zertifikat sichern, damit Sie dieses, abhängig vom +// beabsichtigten Verwendungszweck, auf ihrem Web-, Mailserver oder +// in ihrem Mailprogramm installieren können. +// Dieses Beispiel zeigt ihnen, wie Sie diese Dinge in Variablen abspeichern, +// aber genauso können Sie die Informationen direkt in Dateien speichern. +// Typischerweise schicken Sie den CSR an Ihre CA, die daraufhin diese Anfrage +// bearbeitet und Sie mit einem "richtigen" Zertifikat ausstattet. +openssl_csr_export($csr, $csrout) and var_dump($csrout);; +openssl_x509_export($sscert, $certout) and var_dump($certout); +openssl_pkey_export($privkey, $pkeyout, "mypassword") and var_dump($pkeyout); + +// Anzeigen der möglichen aufgetretenen Fehler +while (($e = openssl_error_string()) !== false) { + echo $e . "\n"; +} +?> +]]> + </programlisting> + </example> + </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml Sun Jan 18 18:57:53 2004 @@ -1,26 +1,92 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-csr-sign' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.9 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-sign"> <refnamediv> <refname>openssl_csr_sign</refname> - <refpurpose>Signiert ein Zertifikat mit einem andern CERT </refpurpose> + <refpurpose>Signiert einen CSR mit einem anderen Zertifikat + (oder sich selbst) und generiert ein Zertifikat</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>resource</type><methodname>openssl_csr_sign</methodname> <methodparam><type>mixed</type><parameter>csr</parameter></methodparam> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> + <methodparam><type>mixed</type><parameter>cacert</parameter></methodparam> <methodparam><type>mixed</type><parameter>priv_key</parameter></methodparam> - <methodparam><type>long</type><parameter>days</parameter></methodparam> + <methodparam><type>int</type><parameter>days</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>serial</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_csr_sign</function> erzeugt eine x509 + Zertifikatressource von <parameter>csr</parameter>, der vorher mit + <function>openssl_csr_new</function> erzeugt wurde. Sie können mit + <parameter>csr</parameter> aber auch einen Pfad zu einer PEM kodierten + CSR Datei angeben: <filename>file://path/to/csr</filename>, oder einer + mit Hilfe von <function>openssl_csr_export</function>exportierten + Zeichenkette. Das generierte Zertifikat wird mit + <parameter>cacert</parameter> signiert. Falls Sie für + <parameter>cacert</parameter> &null; angeben, wird das generierte + Zertifikat ein selbstsigniertes Zertifikat sein. + <parameter>priv_key</parameter> ist der private Schlüssel, der zu + <parameter>cacert</parameter> gehört. Mit <parameter>days</parameter> + legen Sie die Gültigkeitsdauer des generierten Zertifikats in Tagen fest. + Mit <parameter>configargs</parameter> können Sie die Signierung des CSR + feiner abstimmen. Für weterführende Informationen über die Verwendung von + <parameter>configargs</parameter> lesen Sie bitte bei der Dokumentation + zu <function>openssl_csr_new</function> nach. Seit PHP 4.3.3 können Sie + die Seriennummer des ausgestellten Zertifikats mit + <parameter>serial</parameter> angeben. In früheren Versionen war dieser + Wert immer 0. + </para> + <para> + Gibt bei Erfolg eine x509 Zertifikatressource zurück, &false; bei einem + Fehler. + </para> + &reference.openssl.note-openssl-cnf; + <para> + <example> + <title><function>openssl_csr_sign</function> Beispiel - signieren eines + CSR (wie Sie ihre eigene CA implementieren)</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Annahme: dieses Skript erhält einen CSR, der auf einer anderen Seite in +// eine Textarea eingegeben wurde. +$csrdata = $_POST["CSR"]; + +// Wir werden die Anfrage mit unserem eigenen ""certificate authority" +// Zertifikat signieren. Sie können jedes beliebige Zertifikat verwenden, um +// ein anderes zu signieren. Aber das Ganze ist ziemlich nutzlos, solange die +// Software/Benutzer, die dieses neu signierte Zertifikat nutzen werden, dem +// signierenden Zertifikat + +// We will sign the request using our own "certificate authority" +// certificate. You can use any certificate to sign another, but +// the process is worthless unless the signing certificate is trusted +// by the software/users that will deal with the newly signed certificate + +// Wir brauchen unser CA Zertifikat und dessen privaten Schlüssel +$cacert = "file://path/to/ca.crt"; +$privkey = array("file://path/to/ca.key", "your_ca_key_passphrase"); + +$userscert = openssl_csr_sign($csrdata, $cacert, $privkey, 365); + +// Jetzt zeigem wir das generierte Zertifikat an, damit die Benutzer es +// kopieren und in ihre lokale Konfiguration einfügen können (wie z.B. eine +// Datei, die das Zertifikat für ihren SSL Server enthalten soll. +openssl_x509_export($usercert, $certout); +echo $certout; + +// Anzeigen der möglichen aufgetretenen Fehler +while (($e = openssl_error_string()) !== false) { + echo $e . "\n"; +} +?> +]]> + </programlisting> + </example> </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-error-string.xml diff -u phpdoc-de/reference/openssl/functions/openssl-error-string.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-error-string.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-error-string.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-error-string.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-error-string' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-error-string"> <refnamediv> <refname>openssl_error_string</refname> @@ -15,11 +12,9 @@ <type>mixed</type><methodname>openssl_error_string</methodname> <void/> </methodsynopsis> - &warn.experimental.func; <para> Liefert einen Fehlertext, oder &false;, wenn es keine weiteren Fehler gibt. - </para> <para> Die Funktion <function>openssl_error_string</function> liefert den letzten @@ -28,28 +23,20 @@ Informationen zu erhalten. </para> <para> - <emphasis>Die Parameter/Rückgabewerte dieser Funktion können sich - ändern, bevor diese in einer Release Version von PHP zur Verfügung stehen. - </emphasis> - </para> - <para> <example> <title><function>openssl_error_string</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: Sie haben eine openssl-Funktion aufgerufen, die einen Fehler // verursacht hat. -while($msg = openssl_error_string()) +while ($msg = openssl_error_string()) echo $msg . "<br />\n"; +?> ]]> </programlisting> </example> </para> - <note> - <para> - Diese Funktion wurde in 4.0.6 hinzugefügt. - </para> - </note> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-free-key.xml diff -u phpdoc-de/reference/openssl/functions/openssl-free-key.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-free-key.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-free-key.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-free-key.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-free-key' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-free-key"> <refnamediv> <refname>openssl_free_key</refname> @@ -15,10 +12,9 @@ <type>void</type><methodname>openssl_free_key</methodname> <methodparam><type>resource</type><parameter>key_identifier</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_free_key</function> löscht den Schlüssel mit dem - angegebenen Parameter <parameter>key_identifier</parameter> aus + Die Funktion <function>openssl_free_key</function> löscht den Schlüssel + mit dem angegebenen Parameter <parameter>key_identifier</parameter> aus dem Speicher. </para> </refsect1> Index: phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml diff -u phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml Sun Jan 18 18:57:53 2004 @@ -1,14 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-get-privatekey' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-get-privatekey"> <refnamediv> <refname>openssl_get_privatekey</refname> - <refpurpose>Bereitet einen PEM formatierten privaten Schlüssel zum - Gebrauch vor</refpurpose> + <refpurpose>Liefert einen privaten Schlüssel</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -17,19 +13,8 @@ <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: im Erfolgsfall eine positive Schlüssel-Resource-Kennung, - &false; im Fehlerfall. - </para> - <para> - Die Funktion <function>openssl_get_privatekey</function> analysiert - den PEM formatierten privaten Schlüssel der mit dem Parameter - <parameter>key</parameter> angegeben wurde und bereitet ihn - für den Gebrauch durch andere Funktionen vor. - Der optionale Parameter <parameter>passphrase</parameter> muss - angegeben werden, falls der Schlüssel selbst verschlüsselt ist - (geschützt durch eine Passphrase). + Das ist ein Alias für <function>openssl_pkey_get_private</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml diff -u phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-get-publickey' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-get-publickey"> <refnamediv> <refname>openssl_get_publickey</refname> @@ -16,16 +13,8 @@ <type>resource</type><methodname>openssl_get_publickey</methodname> <methodparam><type>mixed</type><parameter>certificate</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: im Erfolgsfall eine positive Schlüssel-Resource-Kennung, - &false; im Fehlerfall. - </para> - <para> - Die Funktion <function>openssl_get_publickey</function> extrahiert den - öffentlichen Schlüssel aus einem X.509 Zertifikat, angegeben - durch den Parameter <parameter>certificate</parameter>, und bereitet - ihn für den Gebrauch durch andere Funktionen vor. + Das ist ein Alias für <function>openssl_pkey_get_public</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-open.xml diff -u phpdoc-de/reference/openssl/functions/openssl-open.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-open.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-open.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-open.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-open' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-open"> <refnamediv> <refname>openssl_open</refname> @@ -14,35 +11,34 @@ <methodsynopsis> <type>bool</type><methodname>openssl_open</methodname> <methodparam><type>string</type><parameter>sealed_data</parameter></methodparam> - <methodparam><type>string</type><parameter>open_data</parameter></methodparam> + <methodparam><type>string</type><parameter>&open_data</parameter></methodparam> <methodparam><type>string</type><parameter>env_key</parameter></methodparam> <methodparam><type>mixed</type><parameter>priv_key_id</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: &return.success; Im - Erfolgsfall werden die geöffneten Daten im Parameter <parameter> - open_data</parameter> zurückgegeben. + &return.success; Im Erfolgsfall werden die geöffneten Daten im Parameter + <parameter>open_data</parameter> zurückgegeben. </para> <para> Die Funktion <function>openssl_open</function> öffnet (entschlüsselt) <parameter>sealed_data</parameter> unter Verwendung des privaten - Schlüsssels, der mit der Schlüsselkennung - <parameter>priv_key_id</parameter> und dem Umschlag Schlüssel + Schlüssels, der mit der Schlüsselkennung + <parameter>priv_key_id</parameter> und dem Umschlagschlüssel <parameter>env_key</parameter> verknüpft ist und füllt <parameter> - open_data</parameter> mit den entschlüsselten Daten. - Der Umschlag Schlüssel wird bei der Versiegelung erzeugt und kann + open_data</parameter> mit den entschlüsselten Daten. Der + Umschlagschlüssel wird bei der Versiegelung erzeugt und kann ausschlieslich für einen bestimmten privaten Schlüssel verwendet werden. - Mehr Informationen erhalten Sie unter der <function>openssl_seal</function> Funktion. + Mehr Informationen erhalten Sie bei der Dokumentation zu + <function>openssl_seal</function>. </para> <para> <example> <title><function>openssl_open</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -// Annahme: $sealed und $env_key enthalten versiegelte Daten -// und unseren Umschlag Schlüssel; beide haben wir von dem sie -// Versiegelnden erhalten +<?php +// Annahme: $sealed und $env_key enthalten versiegelte Daten und unseren +// Umschlagschlüssel; beide haben wir von dem Versiegelnden erhalten // privaten Schlüssel aus einer Datei holen und vorbereiten $fp = fopen("/src/openssl-0.9.6/demos/sign/key.pem", "r"); @@ -51,13 +47,15 @@ $pkeyid = openssl_get_privatekey($priv_key); // entschlüsseln der Daten und speichern in $open -if (openssl_open($sealed, $open, $env_key, $pkeyid)) +if (openssl_open($sealed, $open, $env_key, $pkeyid)) { echo "Das sind die geöffneten Daten: ", $open; -else +} else { echo "Öffnen der Daten nicht möglich!"; +} // löschen des privaten Schlüssels aus dem Speicher openssl_free_key($pkeyid); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-pkcs7-decrypt' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-decrypt"> <refnamediv> <refname>openssl_pkcs7_decrypt</refname> @@ -17,18 +14,18 @@ <methodparam><type>string</type><parameter>infilename</parameter></methodparam> <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam><type>mixed</type><parameter>recipcert</parameter></methodparam> - <methodparam><type>mixed</type><parameter>recipkey</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>recipkey</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Die Funktion <function>openssl_pkcs7_decrypt</function> entschlüsselt - die mit S/MIME verschlüsselte Nachricht, die sich in der - Datei befindet, die mit dem Paramter <parameter>infilename</parameter> - angegeben wurde. Benutzt wird dafür das Zertifikat, angegeben durch - <parameter>recipcert</parameter>, und der damit verknüpfte - private Schlüssel, angegeben durch <parameter>recipkey</parameter>. + die mit S/MIME verschlüsselte Nachricht, die sich in der Datei befindet, + die mit dem Paramter <parameter>infilename</parameter> angegeben wurde. + Benutzt wird dafür das Zertifikat, angegeben durch + <parameter>recipcert</parameter>, und der damit verknüpfte private + Schlüssel, angegeben durch <parameter>recipkey</parameter>. </para> - <para>Die entschlüsselte Nachricht wird in die Datei geschrieben, die mit + <para> + Die entschlüsselte Nachricht wird in die Datei geschrieben, die mit dem Parameter <parameter>outfilename</parameter> angegeben wurde. </para> <para> @@ -36,24 +33,23 @@ <title><function>openssl_pkcs7_decrypt</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $cert enthält Ihr persönliches Zertifikat und // $key Ihr privates Schlüsselpaar. Sie erhalten eine S/MIME Nachricht. $infilename = "encrypted.msg"; // diese Datei enthält ihre verschlüsselte Nachricht $outfilename = "decrypted.msg"; // stellen Sie sicher, dass Sie Schreibrechte haben! -if (openssl_pkcs7_decrypt($infilename, $outfilename, $cert, $key)) +if (openssl_pkcs7_decrypt($infilename, $outfilename, $cert, $key)) { echo "entschlüsselt!"; -else +} else { echo "entschlüsseln fehlgeschlagen!"; +} +?> ]]> </programlisting> </example> </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml:1.6 phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml:1.7 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml:1.6 Sat Jul 20 06:07:15 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-encrypt"> <refnamediv> <refname>openssl_pkcs7_encrypt</refname> @@ -14,26 +14,25 @@ <methodparam><type>string</type><parameter>outfile</parameter></methodparam> <methodparam><type>mixed</type><parameter>recipcerts</parameter></methodparam> <methodparam><type>array</type><parameter>headers</parameter></methodparam> - <methodparam choice="opt"><type>long</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Die Funktion <function>openssl_pkcs7_encrypt</function> verschlüsselt die Inhalte der Datei, angegeben durch den Pararmeter - <parameter>infile</parameter>. Die Verschlüsselung benutzt - eine RC2 40 Bit Chiffre, so dass diese Inhalte nur von den - beabsichtigten Empfängern gelesen werden können, die mit dem Parameter + <parameter>infile</parameter>. Die Verschlüsselung benutzt eine RC2 40 + Bit Chiffre, so dass diese Inhalte nur von den beabsichtigten Empfängern + gelesen werden können, die mit dem Parameter <parameter>recipcerts</parameter> angegeben wurden. Der Parameter <parameter>recipcerts</parameter> kann ein einzelnes X.509 Zertifikat oder ein Array von X.509 Zertifikaten enthalten. Der Parameter <parameter>headers</parameter> ist ein Array aus Headern die den Daten vorangestellt wird, nachdem diese verschlüsselt wurden. - Das Array <parameter>headers</parameter> kann entweder ein assoziatives - Array sein, mit Indizes aus den Headernamen, oder ein indiziertes Array, - wobei jedes Element eine einzelne Header-Zeile enthält. Um den Verschlüsselungsprozess zu beeinflussen, können Sie den Paramter <parameter>flags</parameter> benutzen - siehe <link linkend="openssl.pkcs7.flags"> PKCS7 Konstanten</link>. + <parameter>headers</parameter> kann entweder ein assoziatives Array sein, + mit Indizes aus den Headernamen, oder ein indiziertes Array, wobei jedes + Element eine einzelne Header-Zeile enthält. </para> <para> <example> @@ -41,6 +40,7 @@ Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Die Nachricht die Sie verschlüsselt an Ihren Geheimagenten, // bekannt als Nachtfalke, schicken wollen. // Sein Zertifikat liegt Ihnen in der Datei nighthawk.pem vor. @@ -56,7 +56,7 @@ EOD; // Schlüssel laden -$key = implode("", file("nighthawk.pem")); +$key = file_get_contents("nighthawk.pem"); // speichern der Nachricht in einer Datei $fp = fopen("msg.txt", "w"); @@ -66,17 +66,17 @@ // verschlüsseln if (openssl_pkcs7_encrypt("msg.txt", "enc.txt", $key, array("To" => "nighthawk@example.com", // keyed syntax - "From: HQ <hq@example.com>", // indexed syntax - "Subject" => "Eyes only"))) -{ + "From: HQ <hq@example.com>", // indexed syntax + "Subject" => "Eyes only"))) { + // Nachricht verschlüsselt - ab damit! exec(ini_get("sendmail_path") . " < enc.txt"); } +?> ]]> </programlisting> </example> </para> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml Sun Jan 18 18:57:53 2004 @@ -1,13 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-pkcs7-sign' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.11 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-sign"> <refnamediv> <refname>openssl_pkcs7_sign</refname> - <refpurpose>Unterzeichnen einer S/MIME Nachricht</refpurpose> + <refpurpose>Signieren einer S/MIME Nachricht</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -18,20 +15,19 @@ <methodparam><type>mixed</type><parameter>signcert</parameter></methodparam> <methodparam><type>mixed</type><parameter>privkey</parameter></methodparam> <methodparam><type>array</type><parameter>headers</parameter></methodparam> - <methodparam choice="opt"><type>long</type><parameter>flags</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>extracertsfilename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>extracerts</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_pkcs7_sign</function> unterzeichnet die + Die Funktion <function>openssl_pkcs7_sign</function> signiert die Inhalte der Datei, angegeben durch den Pararmeter - <parameter>infilename</parameter>. Beim Unterzeichnen wird das Zertifikat, + <parameter>infilename</parameter>. Beim Signieren wird das Zertifikat, angegeben durch <parameter>signcert</parameter>, und der dazu gehörige - private Schlüssel, angegeben durch <parameter>privkey</parameter>, benutzt. + private Schlüssel <parameter>privkey</parameter> benutzt. </para> <para> Der Parameter <parameter>headers</parameter> ist ein Array aus Headern - die den Daten vorangestellt werden, nachdem diese unterzeichnet wurden + die den Daten vorangestellt werden, nachdem diese signiert wurden (Für mehr Informationen über das Format dieses Parameters schauen Sie bei der Funktion <function>openssl_pkcs7_encrypt</function> nach). </para> @@ -42,22 +38,23 @@ nicht angegeben ist die Vorgabe PKCS7_DETACHED. </para> <para> - Der Parameter <parameter>extracertsfilename</parameter> gibt den Namen - einer Datei an, die ein Bündel von extra Zertifikaten enthält, die in - die Unterschrift mit eingefügt werden. Das kann zum Beispiel als Hilfe - für einen Empfänger dienen, das von Ihnen benutze Zertifikat zu überprüfen. + Der Parameter <parameter>extracerts</parameter> gibt den Namen einer Datei + an, die ein mehrere extra Zertifikate enthält, die in die Unterschrift mit + eingefügt werden. Das kann zum Beispiel als Hilfe für einen Empfänger + dienen, das von Ihnen benutze Zertifikat zu überprüfen. </para> <para> <example> <title><function>openssl_pkcs7_sign</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -// Die Nachricht die Sie unterschreiben möchten, damit der Empfänger sicher sein, -// dass diese Nachricht von Ihnen stammt. +<?php +// Die Nachricht die Sie unterschreiben möchten, damit der Empfänger sicher +// sein kann, dass diese Nachricht von ihnen stammt. $data = <<<EOD -Sie haben meine Erlaubnis 20,000.- DM für Essen auszugeben. +Sie haben meine Erlaubnis 10.000 EUR für Essen auszugeben. Der CEO EOD; @@ -65,24 +62,21 @@ $fp = fopen("msg.txt", "w"); fwrite($fp, $data); fclose($fp); -// encrypt it +// verschlüsslen if (openssl_pkcs7_sign("msg.txt", "signed.txt", "mycert.pem", array("mycert.pem", "mypassphrase"), - array("To" => "joes@sales.com", // keyed syntax - "From: HQ <ceo@sales.com>", // indexed syntax - "Subject" => "Eyes only")) -{ - // Nachricht unterschrieben - abschicken! + array("To" => "joes@example.com", // keyed syntax + "From" => "HQ <ceo@example.com>", // indexed syntax + "Subject" => "Eyes only") + )) { + // Nachricht signiert - abschicken! exec(ini_get("sendmail_path") . " < signed.txt"); } +?> ]]> </programlisting> </example> </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-pkcs7-verify' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-verify"> <refnamediv> <refname>openssl_pkcs7_verify</refname> @@ -21,7 +18,6 @@ <methodparam choice="opt"><type>array</type><parameter>cainfo</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>extracerts</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Die Funktion <function>openssl_pkcs7_verify</function> liest die S/MIME Nachricht, die in der Datei <parameter>filename</parameter> @@ -45,7 +41,7 @@ </para> <para> Wird der Parameter <parameter>cainfo</parameter> angegeben, sollten - Informationen über die vertrauenswürdigen CA Zertifikate enthalten sein , + Informationen über die vertrauenswürdigen CA Zertifikate enthalten sein, die für den Überprüfungsprozess benutzt werden - für mehr Informationen zu diesem Parameter sollten Sie unter <link linkend="openssl.cert.verification">Zertifikat Nachweis</link> @@ -53,13 +49,9 @@ </para> <para> Wird der Parameter <parameter>extracerts</parameter> angegeben, ist es der - Name einer Datei, die ein Bündel von Zertifikaten enthält, die als + Name einer Datei, die ein mehrere extra Zertifikate enthält, die als nicht vertrauenswürdige CAs genutzt werden. </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-pkey-export-to-file' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkey-export-to-file"> <refnamediv> <refname>openssl_pkey_export_to_file</refname> @@ -16,15 +13,23 @@ <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>config_args</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_pkey_export_to_file</function> saves an ascii-armoured + (PEM encoded) Darstellung of <parameter>key</parameter> into the file named + by <parameter>outfilename</parameter>. + Der Schlüssel kann optional duch eine <parameter>passphrase</parameter> + geschützt werden. <parameter>configargs</parameter> können Sie benutzen, + um den Export feiner abzustimmen. Sie können damit Optionen für die + openssl Konfigurationsdatei bestimmen und/oder überschreiben. Für mehr + Informationen über <parameter>configargs</parameter> schauen Sie bitte + bei der Dokumentation zu <function>openssl_csr_new</function> nach. + &return.success; </para> + &reference.openssl.note-openssl-cnf; </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml Sun Jan 18 18:57:53 2004 @@ -1,28 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-pkey-export' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkey-export"> <refnamediv> <refname>openssl_pkey_export</refname> <refpurpose>Liefert eine exportierbare Representation eines Schlüssels - in einem String oder einer Datei </refpurpose> + in einem String</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>openssl_pkey_export</methodname> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> - <methodparam><type>mixed</type><parameter>out</parameter></methodparam> + <methodparam><type>string</type><parameter>&out</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>config_args</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; - <para> - &warn.undocumented.func; + <para> + <function>openssl_pkey_export</function> exportiert + <parameter>key</parameter> als eine PEM kodierte Zeichenkette und + speichert diese in <parameter>out</parameter> (welcher per Referenz + übergeben wird). Der Schlüssel kann optional mit einer + <parameter>passphrase</parameter> geschützt werden. + <parameter>configargs</parameter> können Sie benutzen, um den Export + feiner abzustimmen. Sie können damit Optionen für die openssl + Konfigurationsdatei bestimmen und/oder überschreiben. Für mehr + Informationen über <parameter>configargs</parameter> schauen Sie bitte + bei der Dokumentation zu <function>openssl_csr_new</function> nach. + &return.success; </para> + &reference.openssl.note-openssl-cnf; </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-pkey-new' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkey-new"> <refnamediv> <refname>openssl_pkey_new</refname> @@ -15,10 +12,16 @@ <type>resource</type><methodname>openssl_pkey_new</methodname> <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_pkey_new</function> erzeugt ein neues privates und + öffentliches Schlüsselpaar. Den öffentlichen Teil des Schlüssels können + Sie mit <function>openssl_pkey_get_public</function> erhalten. Die + Schlüsselerzeugung können Sie mit <parameter>configargs</parameter> + feiner abstimmen (z.B. die Angabe der verwendeten Bits). Weitere + Informationen zu <parameter>configargs</parameter> entnehmen Sie bitte + der Dokumentation zu <function>openssl_csr_new</function>. </para> + &reference.openssl.note-openssl-cnf; </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-private-decrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-private-decrypt"> <refnamediv> <refname>openssl_private_decrypt</refname> @@ -14,13 +11,21 @@ <methodsynopsis> <type>bool</type><methodname>openssl_private_decrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&decrypted</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_private_decrypt</function> entschlüselt + <parameter>data</parameter>, die zuvor mit + <function>openssl_private_encrypt</function> verschlüsselt wurden und + speichert das Ergebnis in <parameter>decrypted</parameter>. + <parameter>key</parameter> muss der private Schlüssel sein, der dem + Schlüssel entspricht, mit dem die Daten verschlüsselt wurden. + Für <parameter>padding</parameter> ist als Standard auf + OPENSSL_PKCS1_PADDING gesetzt, aber Sie können auch + OPENSSL_SSLV23_PADDING, OPENSSL_PKCS1_OAEP_PADDING oder + OPENSSL_NO_PADDING benutzen. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-private-encrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-private-encrypt"> <refnamediv> <refname>openssl_private_encrypt</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>bool</type><methodname>openssl_private_encrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&crypted</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> Index: phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-public-decrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-public-decrypt"> <refnamediv> <refname>openssl_public_decrypt</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>bool</type><methodname>openssl_public_decrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&crypted</parameter></methodparam> <methodparam><type>resource</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> Index: phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-public-encrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-public-encrypt"> <refnamediv> <refname>openssl_public_encrypt</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>bool</type><methodname>openssl_public_encrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&crypted</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> Index: phpdoc-de/reference/openssl/functions/openssl-seal.xml diff -u phpdoc-de/reference/openssl/functions/openssl-seal.xml:1.4 phpdoc-de/reference/openssl/functions/openssl-seal.xml:1.5 --- phpdoc-de/reference/openssl/functions/openssl-seal.xml:1.4 Mon Aug 26 10:48:53 2002 +++ phpdoc-de/reference/openssl/functions/openssl-seal.xml Sun Jan 18 18:57:53 2004 @@ -1,49 +1,47 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-seal' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-seal"> <refnamediv> <refname>openssl_seal</refname> - <refpurpose>Versiegelt (verschlüsselt) Daten</refpurpose> + <refpurpose>Verschlüsselt (versiegelt) Daten</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>openssl_seal</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>sealed_data</parameter></methodparam> - <methodparam><type>array</type><parameter>env_keys</parameter></methodparam> + <methodparam><type>string</type><parameter>&sealed_data</parameter></methodparam> + <methodparam><type>array</type><parameter>&env_keys</parameter></methodparam> <methodparam><type>array</type><parameter>pub_key_ids</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: im Erolgsfall die Länge der versiegelten Daten, - &false; bei einem Fehler. - War der Aufruf der Funktion erfolgreich, sind die versiegelten Daten - in <parameter>sealed_data</parameter> enthalten und der Umschlag - Schlüssel steht in <parameter>env_keys</parameter> zur Verfügung. + Rückgabewert: im Erfolgsfall die Länge der verschlüsselten Daten, &false; + bei einem Fehler. War der Aufruf der Funktion erfolgreich, sind die + verschlüsselten Daten in <parameter>sealed_data</parameter> enthalten und + der Umschlagschlüssel steht in <parameter>env_keys</parameter> zur + Verfügung. </para> <para> - Die Funktion <function>openssl_seal</function> versiegelt (verschlüsselt) + Die Funktion <function>openssl_seal</function> verschlüsselt <parameter>data</parameter> unter Verwendung von RC4 mit einem zufällig erzeugten geheimen Schlüssel. Dieser Schlüssel wird mit jedem öffentlichen Schlüssel verschlüsselt, der mit der Kennung in <parameter>pub_key_ids</parameter> verknüpft ist. Jeder verschlüsselte Schlüssel wird in <parameter>env_keys</parameter>zurückgegeben.Das - bedeutet, dass Sie versiegelte Daten an mehrere Empfänger versenden können - (unter der Voraussetzung, dass Sie irgendwann die öffentlichen Schlüssel - der Empfänger erhalten haben. Jeder Empfänger muss sowohl die versiegelten - Daten als auch den entsprechenden Umschlag Schlüssel erhalten, der mit - dem öffentlichen Schlüssel des Empfängers versiegelt wurde. + bedeutet, dass Sie verschlüsselte Daten an mehrere Empfänger versenden + können (unter der Voraussetzung, dass Sie irgendwann die öffentlichen + Schlüssel der Empfänger erhalten haben). Jeder Empfänger muss sowohl die + verschlüsselten Daten als auch den entsprechenden Umschlagschlüssel + erhalten, der mit dem öffentlichen Schlüssel des Empfängers versiegelt + wurde. </para> <para> <example> <title><function>openssl_seal</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $data enthält die zu versiegelnden Daten // holen und vorbereiten der öffentlichen Schlüssel unserer Empfänger @@ -58,14 +56,15 @@ fclose($fp); $pk2 = openssl_get_publickey($cert); -// versiegeln der Nachricht, nur Besitzer von $pk1 und $pk2 können -// mit Schlüsseln $sealed entschlüsseln, -// entsprechendes gilt für $ekeys[0] und $ekeys[1]. -openssl_seal($data, $sealed, $ekeys, array($pk1,$pk2)); +// versiegeln der Nachricht, nur Besitzer von $pk1 und $pk2 können mit +// Schlüsseln $sealed entschlüsseln, entsprechendes gilt für $ekeys[0] +// und $ekeys[1]. +openssl_seal($data, $sealed, $ekeys, array($pk1, $pk2)); // Löschen der Schlüssel aus dem Speicher openssl_free_key($pk1); openssl_free_key($pk2); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-sign.xml diff -u phpdoc-de/reference/openssl/functions/openssl-sign.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-sign.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-sign.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-sign.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-sign' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-sign"> <refnamediv> <refname>openssl_sign</refname> @@ -27,15 +24,16 @@ Die Funktion <function>openssl_sign</function> errechnet eine Unterschrift für die im Parameter <parameter>data</parameter> angegebenen Daten. Für das hashing der Daten wird SHA1 benutzt und - anschliessend wird mit dem privaten Schlüssel verschlüsselt, - angegeben mit <parameter>priv_key_id</parameter>. Beachten Sie, dass - die Daten selbst nicht verschlüsselt werden. + anschliessend wird mit dem privaten Schlüssel + <parameter>priv_key_id</parameter> verschlüsselt. Beachten Sie, dass die + Daten selbst nicht verschlüsselt werden. </para> <para> <example> <title><function>openssl_sign</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $data enthält die Daten, die signiert werden sollen. // holen und vorbereiten des privaten Schlüssels aus einer Datei. @@ -49,6 +47,7 @@ // Löschen des Schlüssels aus dem Speicher openssl_free_key($pkeyid); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-verify.xml diff -u phpdoc-de/reference/openssl/functions/openssl-verify.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-verify.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-verify.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-verify.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-verify' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-verify"> <refnamediv> <refname>openssl_verify</refname> @@ -27,20 +24,19 @@ Die Funktion <function>openssl_verify</function> überprüft die Korrektheit der Unterschrift <parameter>signature</parameter> für die angegebenen Daten <parameter>data</parameter> mit Hilfe des - öffentlichen Schlüssels, verknüpft über den Parameter - <parameter>pub_key_id</parameter>. Das muss der passende - öffentliche zum privaten Schlüssel sein, der für die Unterschrift - benutzt wurde. + öffentlichen Schlüssels <parameter>pub_key_id</parameter>. Das muss der + passende öffentliche zum privaten Schlüssel sein, der für die + Unterschrift benutzt wurde. </para> - <para> <example> <title><function>openssl_verify</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $data und $signature enthalten die Daten und die Unterschrift -// holen und vorbereiten des öffentlichen Schlüssels aus dem Zertifikat +// holen des öffentlichen Schlüssels aus dem Zertifikat und vorbereiten $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); @@ -48,15 +44,17 @@ // feststellen, ob die Unterschrift ok ist oder nicht $ok = openssl_verify($data, $signature, $pubkeyid); -if ($ok == 1) +if ($ok == 1) { echo "gut"; -elseif ($ok == 0) +} elseif ($ok == 0) { echo "schlecht"; -else - echo "Mist, Fehler beim Überprüfen der Unterschrift; +} else { + echo "Mist, Fehler beim Überprüfen der Signatur"; +} // Löschen des Schlüssels aus dem Speicher openssl_free_key($pubkeyid); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml Sun Jan 18 18:57:53 2004 @@ -1,13 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-check-private-key' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-check-private-key"> <refnamediv> <refname>openssl_x509_check_private_key</refname> - <refpurpose>Überprüft, ob ein privater Schlüssel zu einem CERT passt </refpurpose> + <refpurpose>Überprüft, ob ein privater Schlüssel zu einem Zertifikat passt </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -16,9 +13,10 @@ <methodparam><type>mixed</type><parameter>cert</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_x509_check_private_key</function> gibt &true; zurück, + wenn <parameter>key</parameter> der private Schlüssel ist, der zum + Zertifikat <parameter>cert</parameter> gehört, ansonsten &false;. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-x509-checkpurpose' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-checkpurpose"> <refnamediv> <refname>openssl_x509_checkpurpose</refname> @@ -20,7 +17,6 @@ <methodparam><type>array</type><parameter>cainfo</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>untrustedfile</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Kann das Zertifikat für den beabsichtigten Zweck benutzt werden, gibt diese Funktion &true; zurück; falls nicht &false;, bei einem Fehler -1. @@ -58,46 +54,55 @@ <tbody> <row> <entry>X509_PURPOSE_SSL_CLIENT</entry> - <entry>Client-Seite einer SSL Verbindung? + <entry> + Kann das Zertifikat für die Clientseite einer SSL Verbindung benutzt + werden? </entry> </row> <row> <entry>X509_PURPOSE_SSL_SERVER</entry> - <entry>Server-Seite einer SSL Verbindung? + <entry> + Kann das Zertifikat für die Serverseite einer SSL Verbindung benutzt + werden? </entry> </row> <row> <entry>X509_PURPOSE_NS_SSL_SERVER</entry> - <entry>Netscape SSL Server? + <entry> + Kann das Zertifikat für den Netscape SSL Server benutzt werden? </entry> </row> <row> <entry>X509_PURPOSE_SMIME_SIGN</entry> - <entry>Unterschreiben einer S/MIME Email? + <entry> + Kann das Zertifikat zum Signieren einer S/MIME Email benutzt werden? </entry> </row> <row> <entry>X509_PURPOSE_SMIME_ENCRYPT</entry> - <entry>Verschlüsseln einer S/MIME Email?</entry> + <entry> + Kann das Zertifikat zum Verschlüsseln einer S/MIME Email benutzt + werden? + </entry> </row> <row> <entry>X509_PURPOSE_CRL_SIGN</entry> - <entry>Unterschreiben einer Zertifikats-Widerrufliste(CRL)? + <entry> + Kann das Zertifikat zum signieren einer Zertifikatswiderrufliste + (CRL) benutzt werden? </entry> </row> <row> <entry>X509_PURPOSE_ANY</entry> - <entry>Beliebige/alle Zwecke?</entry> + <entry> + Kann das Zertifikat für beliebige/alle Zwecke benutzt werden? + </entry> </row> </tbody> </tgroup> </table> Diese Optionen sind keine Bitfelder - Sie können nur eine einzige angeben! </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml Sun Jan 18 18:57:53 2004 @@ -1,25 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-export-to-file' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-export-to-file"> <refnamediv> <refname>openssl_x509_export_to_file</refname> - <refpurpose>Exportiert ein CERT in eine Datei oder eine Variable</refpurpose> + <refpurpose>Exportiert ein Zertifikat in eine Datei</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>bool</type><methodname>openssl_x509_export_to_file </methodname> + <type>bool</type><methodname>openssl_x509_export_to_file</methodname> <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_x509_export_to_file</function> speichert das + <parameter>x509</parameter> Zertifikat in einem PEM kodierten Format + in der Datei <parameter>outfilename</parameter>. + </para> + &reference.openssl.parameter-notext; + <para> + &return.success; </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-export.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-export.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-export.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-export.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-export.xml Sun Jan 18 18:57:53 2004 @@ -1,25 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-export' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-export"> <refnamediv> <refname>openssl_x509_export</refname> - <refpurpose>Exportiert ein CERT in eine Datei oder eine Variable </refpurpose> + <refpurpose>Exportiert ein Zertifikat in eine Zeichenkette</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>openssl_x509_export</methodname> <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> + <methodparam><type>string</type><parameter>&output</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_x509_export</function> speichert das + <parameter>x509</parameter> Zertifikat in einem PEM kodierten Format + in der Zeichenkette <parameter>output</parameter>. + </para> + &reference.openssl.parameter-notext; + <para> + &return.success; </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-free.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-free.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-free.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-free.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-free.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-x509-free' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-free"> <refnamediv> <refname>openssl_x509_free</refname> @@ -15,16 +12,11 @@ <type>void</type><methodname>openssl_x509_free</methodname> <methodparam><type>resource</type><parameter>x509cert</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_x509_free</function> löscht den - Speicherbereich, der von einem Zertifikat, angegeben - durch den Parameter <parameter>x509cert</parameter>, belegt wurde. + Die Funktion <function>openssl_x509_free</function> gibt den + Speicherbereich frei, der von einer Zertifikatsressource + <parameter>x509cert</parameter> belegt wurde. </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-x509-parse' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-parse"> <refnamediv> <refname>openssl_x509_parse</refname> @@ -18,26 +15,23 @@ <methodparam><type>mixed</type><parameter>x509cert</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>shortnames</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; + &warn.experimental.func; <para> Die Funktion <function>openssl_x509_parse</function> liefert Informationen - über das angegebene Zertifikat <parameter>x509cert</parameter>. Die - Informationen sind: Name des Gegenstands, Name des Herausgebers, - Zweck, Zeitangaben, wie gültig seit... gültig bis, usw. - Der Parameter <parameter>shortnames</parameter> kontrolliert wie die Daten - im Array indiziert werden - wenn <parameter>shortnames</parameter> &true; - ist (Standard), werden die Felder in Kurzform indiziert, ansonsten werden + über das angegebene Zertifikat <parameter>x509cert</parameter>, wie + Name des Gegenstands, Name des Herausgebers, Zweck, Zeitangaben + (gültig seit... gültig bis), usw. Der Parameter + <parameter>shortnames</parameter> kontrolliert wie die Daten im Array + indiziert werden - wenn <parameter>shortnames</parameter> &true; ist + (Standard), werden die Felder in Kurzform indiziert, ansonsten werden lange Namen verwendet - z.B.: CN ist die Kurzform von commonName. </para> - <para><emphasis> Die Struktur der zurückgegeben Daten ist bis jetzt - (absichtlich) nicht dokumentiert, da es noch vorbehaltliche Änderungen - geben wird + <para> + <emphasis> + Die Struktur der zurückgegeben Daten ist bis jetzt (absichtlich) noch + nicht dokumentiert, da es noch Änderungen geben wird. </emphasis> </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-read.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-read.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-read.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-read.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-read.xml Sun Jan 18 18:57:53 2004 @@ -1,14 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-read' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-read"> <refnamediv> <refname>openssl_x509_read</refname> <refpurpose>Analysiert ein X.509 Zertitifikat und gibt eine - Resource-Kennung zurück</refpurpose> + Ressource-Kennung zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -16,15 +13,11 @@ <type>resource</type><methodname>openssl_x509_read</methodname> <methodparam><type>mixed</type><parameter>x509certdata</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_x509_read</function> analysiert das Zertifikat - das mit dem Parameter <parameter>x509certdata</parameter> - angegeben wurde und gibt eine Resource-Kennung zurück. + Die Funktion <function>openssl_x509_read</function> analysiert das + Zertifikat <parameter>x509certdata</parameter> und gibt eine + Ressourcekennung zurück. </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> </refsect1> </refentry>
Index: phpdoc-de/reference/openssl/constants.xml diff -u phpdoc-de/reference/openssl/constants.xml:1.1 phpdoc-de/reference/openssl/constants.xml:1.2 --- phpdoc-de/reference/openssl/constants.xml:1.1 Tue Sep 3 13:59:07 2002 +++ phpdoc-de/reference/openssl/constants.xml Sun Jan 18 18:57:52 2004 @@ -1,13 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.1 Maintainer: betz Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <section id="openssl.constants"> &reftitle.constants; &extension.constants; + <section id="openssl.purpose-check"> + <title>Zweckprüfende Flags</title> <variablelist> <varlistentry> <term> <constant>X509_PURPOSE_SSL_CLIENT</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -18,7 +20,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_SSL_SERVER</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -29,7 +31,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_NS_SSL_SERVER</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -40,7 +42,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_SMIME_SIGN</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -51,7 +53,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_SMIME_ENCRYPT</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -62,7 +64,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_CRL_SIGN</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -73,7 +75,7 @@ <varlistentry> <term> <constant>X509_PURPOSE_ANY</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -81,10 +83,16 @@ </simpara> </listitem> </varlistentry> + </variablelist> + </section> + + <section id="openssl.padding"> + <title>Padding Flags</title> + <variablelist> <varlistentry> <term> <constant>OPENSSL_PKCS1_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -95,7 +103,7 @@ <varlistentry> <term> <constant>OPENSSL_SSLV23_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -106,7 +114,7 @@ <varlistentry> <term> <constant>OPENSSL_NO_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -117,7 +125,7 @@ <varlistentry> <term> <constant>OPENSSL_PKCS1_OAEP_PADDING</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -125,10 +133,16 @@ </simpara> </listitem> </varlistentry> + </variablelist> + </section> + + <section id="openssl.key-types"> + <title>Key types</title> + <variablelist> <varlistentry> <term> <constant>OPENSSL_KEYTYPE_RSA</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -139,7 +153,7 @@ <varlistentry> <term> <constant>OPENSSL_KEYTYPE_DSA</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -150,7 +164,7 @@ <varlistentry> <term> <constant>OPENSSL_KEYTYPE_DH</constant> - (<link linkend="language.types.integer">integer</link>) + (<type>integer</type>) </term> <listitem> <simpara> @@ -159,14 +173,14 @@ </listitem> </varlistentry> </variablelist> + </section> <section id="openssl.pkcs7.flags"> - <title>PKCS7 Kennzeichen/Konstanten</title> + <title>PKCS7 Flags/Konstanten</title> <para> - Die S/MIME Funktionen nutzen Kennzeichen die sich dadurch auszeichnen, dass + Die S/MIME Funktionen nutzen Flags die sich dadurch auszeichnen, dass sie ein Bitfeld benutzen, das einen oder mehrere der folgenden Werte enthalten kann: - <table> <title>PKCS7 KONSTANTEN</title> <tgroup cols="2"> @@ -179,85 +193,94 @@ <tbody> <row> <entry>PKCS7_TEXT</entry> - <entry>Fügt den text/plain Inhaltstyp Header einer - verschlüsselten/signierten Nachricht hinzu. - Wenn Sie entschlüsseln oder überprüfen, werden diese Header - von der Ausgabe entfernt - wenn die entschlüsselte oder - geprüfte Nachricht nicht dem MIME Typ text/plain entspricht, - tritt ein Fehler auf.</entry> + <entry> + Fügt den Inhaltstyp Header text/plain einer + verschlüsselten/signierten Nachricht hinzu. Wenn Sie entschlüsseln + oder überprüfen, werden diese Header von der Ausgabe entfernt. + Entspricht die entschlüsselte oder geprüfte Nachricht nicht dem MIME + Typ text/plain, tritt ein Fehler auf. + </entry> </row> <row> <entry>PKCS7_BINARY</entry> - <entry>Normalerweise wird die Nachricht in ein "kanonisches" - Format konvertiert, das effektiv CR und LF als Zeilende benutzt: - wie von der S/MIME Spezifikation gefordert. - Wird diese Option angegeben, findet keine Konvertierung statt. - Das kann sich als nützlich erweisen, wenn Sie mit binären Daten - umgehen, die nicht dem MIME Format entprechen. + <entry> + Normalerweise wird die Nachricht in ein "kanonisches" Format + konvertiert, das effektiv CR und LF als Zeilende benutzt, wie von + der S/MIME Spezifikation gefordert. Wird diese Option angegeben, + findet keine Konvertierung statt. Das kann sich als nützlich + erweisen, wenn Sie es mit binären Daten zu tun haben, die nicht dem + MIME Format entprechen. </entry> </row> <row> <entry>PKCS7_NOINTERN</entry> - <entry>Wenn Sie eine Nachricht überprüfen, werden in der Nachricht - enthaltene Zertifikate (falls es welche gibt) nach dem - unterzeichnenden Zertifikat durchsucht. Mit dieser Option werden - nur Zertifikate benutzt, die mit dem Parameter - <parameter>extracerts</parameter> in der Funktion - <function>openssl_pkcs7_verify</function> angegeben wurden. - Die mitgelieferten Zertifikate können aber dennoch als nicht - vertrauenswürdige CAs benutzt werden. + <entry> + Wenn Sie eine Nachricht überprüfen, werden in der Nachricht + enthaltene Zertifikate (falls es welche gibt) nach dem + unterzeichnenden Zertifikat durchsucht. Mit dieser Option werden nur + Zertifikate benutzt, die mit dem Parameter + <parameter>extracerts</parameter> in der Funktion + <function>openssl_pkcs7_verify</function> angegeben wurden. Die + mitgelieferten Zertifikate können aber dennoch als nicht + vertrauenswürdige CAs benutzt werden. </entry> </row> <row> <entry>PKCS7_NOVERIFY</entry> - <entry>Keine Überprüfung des signierenden Zertifikats - einer signierten Nachricht.</entry> + <entry> + Keine Überprüfung des signierenden Zertifikats einer signierten + Nachricht. + </entry> </row> <row> <entry>PKCS7_NOCHAIN</entry> - <entry>Keine Verknüpfung der Überprüfung des Zertifikats mit den - Zertifikaten des Unterzeichners: das bedeutet, die Zertifikate in - der signierten Nachricht werden nicht als unvertrauenswürdige CAs - benutzt. + <entry> + Keine Verknüpfung der Überprüfung des Zertifikats mit den + Zertifikaten des Unterzeichners: das bedeutet, die Zertifikate in + der signierten Nachricht werden nicht als nicht vertrauenswürdige + CAs benutzt. </entry> </row> <row> <entry>PKCS7_NOCERTS</entry> - <entry>Beim Signieren einer Nachricht wird normalerweise das - Zertifikat des Unterzeichnenden mit in die Nachricht - aufgenommen - mit dieser Option wird das Zertifikat nicht - mit aufgenommen. Diese Option verringert die Größe der signierten - Nachricht, aber der Überprüfende muss eine lokale Kopie des - Zertifikats vom Unterzeichnenden besitzen (zum Beispiel durch Angabe - des Parameters <parameter>extracerts</parameter> in der Funktion - <function>openssl_pkcs7_verify</function>). + <entry> + Beim Signieren einer Nachricht wird normalerweise das Zertifikat des + Unterzeichnenden mit in die Nachricht aufgenommen - mit dieser + Option wird das Zertifikat nicht mit aufgenommen. Diese Option + verringert die Größe der signierten Nachricht, aber der Überprüfende + muss eine lokale Kopie des Zertifikats vom Unterzeichnenden besitzen + (zum Beispiel durch Angabe des Parameters + <parameter>extracerts</parameter> in der Funktion + <function>openssl_pkcs7_verify</function>). </entry> </row> <row> <entry>PKCS7_NOATTR</entry> - <entry>Beim Signieren einer Nachricht wird normalerweise eine Reihe - von Attributen mit angehängt. Diese enthalten die Zeit der Signierung - und die unterstützen symmetrischen Algorithmen. Mit dieser Option werden - diese Attribute nicht mit aufgenommen. + <entry> + Beim Signieren einer Nachricht wird normalerweise eine Reihe von + Attributen mit angehängt. Diese enthalten die Zeit der Signierung + und die unterstützen symmetrischen Algorithmen. Mit dieser Option + werden diese Attribute nicht mit aufgenommen. </entry> </row> <row> <entry>PKCS7_DETACHED</entry> - <entry>Beim Signieren einer Nachricht wird Klartext-Signierung - verwendet mit MIME Typ multipart/signed. Das ist der Standard, - wenn Sie keinen optionalen Parameter <parameter>flags</parameter> - an die Funktion <function>openssl_pkcs7_sign</function> übergeben. - Wenn Sie diese Option ausschalten wird die Nachricht mit einer - undurchsichtigen Signatur unterzeichnet. Dieses Verhalten ist robuster - gegenüber der Übersetzung durch Mail-Relays, kann aber nicht mit - Mailprogrammen gelesen werden, die nicht den S/Mime Standard - unterstützen. + <entry> + Beim Signieren einer Nachricht wird Klartext-Signierung verwendet + mit dem MIME Typ multipart/signed. Das ist der Standard, wenn Sie + keinen optionalen Parameter <parameter>flags</parameter> + an die Funktion <function>openssl_pkcs7_sign</function> übergeben. + Wenn Sie diese Option ausschalten wird die Nachricht mit einer + undurchsichtigen Signatur unterzeichnet. Dieses Verhalten ist robuster + gegenüber der Übersetzung durch Mail-Relays, kann aber nicht mit + Mailprogrammen gelesen werden, die nicht den S/Mime Standard + unterstützen. </entry> </row> <row> <entry>PKCS7_NOSIGS</entry> - <entry>Kein Versuch und keine Überprüfung der Signaturen einer - Nachricht. + <entry> + Kein Versuch und keine Überprüfung der Signaturen einer Nachricht. </entry> </row> </tbody> @@ -268,6 +291,70 @@ <para>Diese Konstanten wurden in 4.0.6 hinzugefügt.</para> </note> </section> + +<!-- + <section id="openssl.ciphers"> + <title>Ciphers</title> + <variablelist> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_RC2_40</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_RC2_128</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_RC2_64</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_DES</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OPENSSL_CIPHER_3DES</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + </variablelist> + </section> +--> + </section> <!-- Keep this comment at the end of the file @@ -290,5 +377,3 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> - - \ No newline at end of file Index: phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml:1.4 phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml:1.5 --- phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml:1.4 Tue Sep 3 13:59:07 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-export-to-file.xml Sun Jan 18 18:57:53 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-export-to-file"> <refnamediv> <refname>openssl_csr_export_to_file</refname> @@ -14,15 +14,21 @@ <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - <function>openssl_csr_export_to_file</function> exportiert einen CSR, - angegeben mit <parameter>csr</parameter> und speichert diesen in eine - Datei mit dem Namen <parameter>outfilename</parameter>. Der optionale - Parameter <parameter>notext</parameter> beeinflusst den Umfang der - Ausgabe; ist dieser auf &false; gesetzt werden zusätzliche, für Menschen - lesbare, Informationen in der Datei mit ausgegeben. + <function>openssl_csr_export_to_file</function> exportiert die mit dem + Parameter <parameter>csr</parameter> angegebene + Zertifikatssignierungsanfrage und speichert diese als ASCII-armierten + Text in die Datei mit dem Namen <parameter>outfilename</parameter>. </para> + &reference.openssl.parameter-notext; + <para> + &return.success; + </para> + <simpara> + Siehe auch <function>openssl_csr_export</function>, + <function>openssl_csr_new</function> und + <function>openssl_csr_sign</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-csr-export.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-export.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-csr-export.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-csr-export.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-export.xml Sun Jan 18 18:57:53 2004 @@ -1,26 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-csr-export' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-export"> <refnamediv> <refname>openssl_csr_export</refname> - <refpurpose>Exportiert ein CSR in eine Datei oder eine Variable </refpurpose> + <refpurpose>Exportiert einen CSR als Zeichenkette</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>openssl_csr_export</methodname> <methodparam><type>resource</type><parameter>csr</parameter></methodparam> - <methodparam><type>string</type><parameter>out</parameter></methodparam> + <methodparam><type>string</type><parameter>&out</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_csr_export</function> exportiert die mit dem Parameter + <parameter>csr</parameter> angegebene Zertifikatssignierungsanfrage und + speichert diese als ASCII-armierten Text in <parameter>out</parameter>, + der per Referenz übergeben wird. </para> + &reference.openssl.parameter-notext; + <para> + &return.success; + </para> + <simpara> + Siehe auch <function>openssl_csr_export_to_file</function>, + <function>openssl_csr_new</function> und + <function>openssl_csr_sign</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-csr-new.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-new.xml:1.4 phpdoc-de/reference/openssl/functions/openssl-csr-new.xml:1.5 --- phpdoc-de/reference/openssl/functions/openssl-csr-new.xml:1.4 Tue Sep 3 13:59:07 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-new.xml Sun Jan 18 18:57:53 2004 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.11 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-new"> <refnamediv> <refname>openssl_csr_new</refname> - <refpurpose>Erzeugt einen privaten Schlüssesl und ein CSR </refpurpose> + <refpurpose>Erzeugt einen CSR </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -13,16 +13,178 @@ <type>bool</type><methodname>openssl_csr_new</methodname> <methodparam><type>array</type><parameter>dn</parameter></methodparam> <methodparam><type>resource</type><parameter>privkey</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>extraattribs</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>extraattribs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>openssl_csr_new</function> erzeugt einen neuen CSR - (Certificate Signing Request) basierend auf den Informationen, die mit + (Zertifikatssignierungsanfrage) basierend auf den Informationen, die mit dem Parameter <parameter>dn</parameter> angegeben werden. Dieser bestimmt den Distinguished Name, der im Zertifikat benutzt werden soll. </para> + <para> + <parameter>privkey</parameter> sollte auf einen privaten Schlüssel + zeigen, der vorher mit <function>openssl_pkey_new</function> erzeugt + wurde (oder den Sie auf andere Weise von der Familie der openssl_pkey + Funktionen erhalten haben). Der entsprechende öffentliche Teil des + Schlüssels wird benutzt um den CSR zu signieren. + </para> + <para> + <parameter>extraattribs</parameter> können Sie benutzen um zusätzliche + Konfigurationsoptionen für den CSR anzugeben. Sowohl + <parameter>dn</parameter> als auch <parameter>extraattribs</parameter> + sind assoziative Arrays, deren Schlüssel zu OIDs konvertiert und auf den + relevanten Teil der Anfrage angewendet werden. + </para> + &reference.openssl.note-openssl-cnf; + <para> + Im Standard werden die Informationen für die Anfrage aus der + <literal>openssl.conf</literal> ihres Systems benutzt. Sie können einen + Konfigurationsabsschnitt mit dem Schlüssel + <literal>config_section_section</literal> des Arrays + <parameter>configargs</parameter>setzen. Außerdem haben Sie die + Möglichkeit eine alternative openssl Konfigurationsdatei anzugeben, indem + Sie den Wert des Schlüssels <literal>config</literal> auf den Pfad zu der + Datei setzen, die Sie benutzen möchten. Die unten in der Tabelle + aufgeführten Schlüssel in <parameter>configargs</parameter>, falls Sie + diese definiert haben, verhalten sich genau gleich wie die entsprechenden + Werte in der <literal>openssl.conf</literal> + <table> + <title>Überschreiben der Konfiguration</title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>configargs</parameter> Schlüssel</entry> + <entry>Typ</entry> + <entry><literal>openssl.conf</literal> Entsprechung</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry>digest_alg</entry> + <entry><type>string</type></entry> + <entry>default_md</entry> + <entry>Bestimmt welche digest Methode benutzt wird</entry> + </row> + <row> + <entry>x509_extensions</entry> + <entry><type>string</type></entry> + <entry>x509_extensions</entry> + <entry> + Bestimmt welche Erweiterung benutzt werden soll, wenn ein x509 + Zertifikat erzeugt werden soll. + </entry> + </row> + <row> + <entry>req_extensions</entry> + <entry><type>string</type></entry> + <entry>req_extensions</entry> + <entry> + Bestimmt welche Erweiterung benutzt werden soll, wenn eine + Zertifikatssignierungsanfrage (CSR) erzeugt werden soll. + </entry> + </row> + <row> + <entry>private_key_bits</entry> + <entry><type>string</type></entry> + <entry>default_bits</entry> + <entry> + Bestimmt wieviele Bits verwendet werden, um einen privaten Schlüssel + zu erzeugen. + </entry> + </row> + <row> + <entry>private_key_type</entry> + <entry><type>integer</type></entry> + <entry>none</entry> + <entry> + Bestimmt den Typ des privaten Schlüssels der erzeugt werden soll. + Der Typ kann einer der folgenden sein: + <constant>OPENSSL_KEYTYPE_DSA</constant>, + <constant>OPENSSL_KEYTYPE_DH</constant> oder + <constant>OPENSSL_KEYTYPE_RSA</constant>. Der Standardwert ist + <constant>OPENSSL_KEYTYPE_RSA</constant>, momentan ist das der + einzige Schlüsseltyp, der unterstützt wird. + </entry> + </row> + <row> + <entry>encrypt_key</entry> + <entry><type>boolean</type></entry> + <entry>encrypt_key</entry> + <entry> + Soll ein exportiertet Schlüssel (mit Passphrase) verschlüsselt + werden? + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <simpara> + &return.success; + </simpara> + <para> + <example> + <title> + <function>openssl_csr_new</function> Beispiel - erzeugen eines + selbstsignierten Zertifikats + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// Angabe der Daten für den distinguished name, der in dem Zertifikat benutzt +// wird. Sie müssen die Werte dieser Schlüssel so anpassen, dass diese ihrem +// Namen und Firma entsprechen, oder um präziser zu sein, den Namen und die +// Firma der Person/Seite angeben, für die Sie das Zertifikat erzeugen. +// Für SSL Zertifikate entspricht der commonName gewöhnlich dem Domainnamen, +// für den das Zertifikat benutzt werden soll, aber bei S/MIME Zertifikaten +// entspricht der commonName dem Namen der Person, die das Zertifikat nutzen +// möchte. +$dn = array( + "countryName" => "UK", + "stateOrProvinceName" => "Somerset", + "localityName" => "Glastonbury", + "organizationName" => "The Brain Room Limited", + "organizationalUnitName" => "PHP Documentation Team", + "commonName" => "Wez Furlong", + "emailAddress" => "wez@example.com" +); + +// Erzeugen eines neuen privaten (und öffentlichen) Schlüsselpaars +$privkey = openssl_pkey_new(); + +// Erzeugen einer Zertifikatssignierungsanfrage +$csr = openssl_csr_new($dn, $privkey); + +// Gewöhnlicherweise möchten Sie zu diesem Zeitpunkt ein selbstsigniertes +// Zertifikat erzeugen, das Sie benutzten können, bis ihre CA ihre Anfrage +// im positiven Sinne bearbeitet hat. +// Erzeugen eines selbstsignierten Zertifikts, das für die Dauer von 365 Tagen +// gültig ist. +$sscert = openssl_csr_sign($csr, null, $privkey, 365); + +// Jetzt möchten Sie ihren privaten Schlüssel, ihren CSR und das +// selbstsignierte Zertifikat sichern, damit Sie dieses, abhängig vom +// beabsichtigten Verwendungszweck, auf ihrem Web-, Mailserver oder +// in ihrem Mailprogramm installieren können. +// Dieses Beispiel zeigt ihnen, wie Sie diese Dinge in Variablen abspeichern, +// aber genauso können Sie die Informationen direkt in Dateien speichern. +// Typischerweise schicken Sie den CSR an Ihre CA, die daraufhin diese Anfrage +// bearbeitet und Sie mit einem "richtigen" Zertifikat ausstattet. +openssl_csr_export($csr, $csrout) and var_dump($csrout);; +openssl_x509_export($sscert, $certout) and var_dump($certout); +openssl_pkey_export($privkey, $pkeyout, "mypassword") and var_dump($pkeyout); + +// Anzeigen der möglichen aufgetretenen Fehler +while (($e = openssl_error_string()) !== false) { + echo $e . "\n"; +} +?> +]]> + </programlisting> + </example> + </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml diff -u phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-csr-sign.xml Sun Jan 18 18:57:53 2004 @@ -1,26 +1,92 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-csr-sign' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.9 Maintainer: betz Status: ready --> <refentry id="function.openssl-csr-sign"> <refnamediv> <refname>openssl_csr_sign</refname> - <refpurpose>Signiert ein Zertifikat mit einem andern CERT </refpurpose> + <refpurpose>Signiert einen CSR mit einem anderen Zertifikat + (oder sich selbst) und generiert ein Zertifikat</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>resource</type><methodname>openssl_csr_sign</methodname> <methodparam><type>mixed</type><parameter>csr</parameter></methodparam> - <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> + <methodparam><type>mixed</type><parameter>cacert</parameter></methodparam> <methodparam><type>mixed</type><parameter>priv_key</parameter></methodparam> - <methodparam><type>long</type><parameter>days</parameter></methodparam> + <methodparam><type>int</type><parameter>days</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>serial</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_csr_sign</function> erzeugt eine x509 + Zertifikatressource von <parameter>csr</parameter>, der vorher mit + <function>openssl_csr_new</function> erzeugt wurde. Sie können mit + <parameter>csr</parameter> aber auch einen Pfad zu einer PEM kodierten + CSR Datei angeben: <filename>file://path/to/csr</filename>, oder einer + mit Hilfe von <function>openssl_csr_export</function>exportierten + Zeichenkette. Das generierte Zertifikat wird mit + <parameter>cacert</parameter> signiert. Falls Sie für + <parameter>cacert</parameter> &null; angeben, wird das generierte + Zertifikat ein selbstsigniertes Zertifikat sein. + <parameter>priv_key</parameter> ist der private Schlüssel, der zu + <parameter>cacert</parameter> gehört. Mit <parameter>days</parameter> + legen Sie die Gültigkeitsdauer des generierten Zertifikats in Tagen fest. + Mit <parameter>configargs</parameter> können Sie die Signierung des CSR + feiner abstimmen. Für weterführende Informationen über die Verwendung von + <parameter>configargs</parameter> lesen Sie bitte bei der Dokumentation + zu <function>openssl_csr_new</function> nach. Seit PHP 4.3.3 können Sie + die Seriennummer des ausgestellten Zertifikats mit + <parameter>serial</parameter> angeben. In früheren Versionen war dieser + Wert immer 0. + </para> + <para> + Gibt bei Erfolg eine x509 Zertifikatressource zurück, &false; bei einem + Fehler. + </para> + &reference.openssl.note-openssl-cnf; + <para> + <example> + <title><function>openssl_csr_sign</function> Beispiel - signieren eines + CSR (wie Sie ihre eigene CA implementieren)</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Annahme: dieses Skript erhält einen CSR, der auf einer anderen Seite in +// eine Textarea eingegeben wurde. +$csrdata = $_POST["CSR"]; + +// Wir werden die Anfrage mit unserem eigenen ""certificate authority" +// Zertifikat signieren. Sie können jedes beliebige Zertifikat verwenden, um +// ein anderes zu signieren. Aber das Ganze ist ziemlich nutzlos, solange die +// Software/Benutzer, die dieses neu signierte Zertifikat nutzen werden, dem +// signierenden Zertifikat + +// We will sign the request using our own "certificate authority" +// certificate. You can use any certificate to sign another, but +// the process is worthless unless the signing certificate is trusted +// by the software/users that will deal with the newly signed certificate + +// Wir brauchen unser CA Zertifikat und dessen privaten Schlüssel +$cacert = "file://path/to/ca.crt"; +$privkey = array("file://path/to/ca.key", "your_ca_key_passphrase"); + +$userscert = openssl_csr_sign($csrdata, $cacert, $privkey, 365); + +// Jetzt zeigem wir das generierte Zertifikat an, damit die Benutzer es +// kopieren und in ihre lokale Konfiguration einfügen können (wie z.B. eine +// Datei, die das Zertifikat für ihren SSL Server enthalten soll. +openssl_x509_export($usercert, $certout); +echo $certout; + +// Anzeigen der möglichen aufgetretenen Fehler +while (($e = openssl_error_string()) !== false) { + echo $e . "\n"; +} +?> +]]> + </programlisting> + </example> </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-error-string.xml diff -u phpdoc-de/reference/openssl/functions/openssl-error-string.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-error-string.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-error-string.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-error-string.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-error-string' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-error-string"> <refnamediv> <refname>openssl_error_string</refname> @@ -15,11 +12,9 @@ <type>mixed</type><methodname>openssl_error_string</methodname> <void/> </methodsynopsis> - &warn.experimental.func; <para> Liefert einen Fehlertext, oder &false;, wenn es keine weiteren Fehler gibt. - </para> <para> Die Funktion <function>openssl_error_string</function> liefert den letzten @@ -28,28 +23,20 @@ Informationen zu erhalten. </para> <para> - <emphasis>Die Parameter/Rückgabewerte dieser Funktion können sich - ändern, bevor diese in einer Release Version von PHP zur Verfügung stehen. - </emphasis> - </para> - <para> <example> <title><function>openssl_error_string</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: Sie haben eine openssl-Funktion aufgerufen, die einen Fehler // verursacht hat. -while($msg = openssl_error_string()) +while ($msg = openssl_error_string()) echo $msg . "<br />\n"; +?> ]]> </programlisting> </example> </para> - <note> - <para> - Diese Funktion wurde in 4.0.6 hinzugefügt. - </para> - </note> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-free-key.xml diff -u phpdoc-de/reference/openssl/functions/openssl-free-key.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-free-key.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-free-key.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-free-key.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-free-key' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-free-key"> <refnamediv> <refname>openssl_free_key</refname> @@ -15,10 +12,9 @@ <type>void</type><methodname>openssl_free_key</methodname> <methodparam><type>resource</type><parameter>key_identifier</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_free_key</function> löscht den Schlüssel mit dem - angegebenen Parameter <parameter>key_identifier</parameter> aus + Die Funktion <function>openssl_free_key</function> löscht den Schlüssel + mit dem angegebenen Parameter <parameter>key_identifier</parameter> aus dem Speicher. </para> </refsect1> Index: phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml diff -u phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-get-privatekey.xml Sun Jan 18 18:57:53 2004 @@ -1,14 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-get-privatekey' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-get-privatekey"> <refnamediv> <refname>openssl_get_privatekey</refname> - <refpurpose>Bereitet einen PEM formatierten privaten Schlüssel zum - Gebrauch vor</refpurpose> + <refpurpose>Liefert einen privaten Schlüssel</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -17,19 +13,8 @@ <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: im Erfolgsfall eine positive Schlüssel-Resource-Kennung, - &false; im Fehlerfall. - </para> - <para> - Die Funktion <function>openssl_get_privatekey</function> analysiert - den PEM formatierten privaten Schlüssel der mit dem Parameter - <parameter>key</parameter> angegeben wurde und bereitet ihn - für den Gebrauch durch andere Funktionen vor. - Der optionale Parameter <parameter>passphrase</parameter> muss - angegeben werden, falls der Schlüssel selbst verschlüsselt ist - (geschützt durch eine Passphrase). + Das ist ein Alias für <function>openssl_pkey_get_private</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml diff -u phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-get-publickey.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-get-publickey' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-get-publickey"> <refnamediv> <refname>openssl_get_publickey</refname> @@ -16,16 +13,8 @@ <type>resource</type><methodname>openssl_get_publickey</methodname> <methodparam><type>mixed</type><parameter>certificate</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: im Erfolgsfall eine positive Schlüssel-Resource-Kennung, - &false; im Fehlerfall. - </para> - <para> - Die Funktion <function>openssl_get_publickey</function> extrahiert den - öffentlichen Schlüssel aus einem X.509 Zertifikat, angegeben - durch den Parameter <parameter>certificate</parameter>, und bereitet - ihn für den Gebrauch durch andere Funktionen vor. + Das ist ein Alias für <function>openssl_pkey_get_public</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-open.xml diff -u phpdoc-de/reference/openssl/functions/openssl-open.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-open.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-open.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-open.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-open' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-open"> <refnamediv> <refname>openssl_open</refname> @@ -14,35 +11,34 @@ <methodsynopsis> <type>bool</type><methodname>openssl_open</methodname> <methodparam><type>string</type><parameter>sealed_data</parameter></methodparam> - <methodparam><type>string</type><parameter>open_data</parameter></methodparam> + <methodparam><type>string</type><parameter>&open_data</parameter></methodparam> <methodparam><type>string</type><parameter>env_key</parameter></methodparam> <methodparam><type>mixed</type><parameter>priv_key_id</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: &return.success; Im - Erfolgsfall werden die geöffneten Daten im Parameter <parameter> - open_data</parameter> zurückgegeben. + &return.success; Im Erfolgsfall werden die geöffneten Daten im Parameter + <parameter>open_data</parameter> zurückgegeben. </para> <para> Die Funktion <function>openssl_open</function> öffnet (entschlüsselt) <parameter>sealed_data</parameter> unter Verwendung des privaten - Schlüsssels, der mit der Schlüsselkennung - <parameter>priv_key_id</parameter> und dem Umschlag Schlüssel + Schlüssels, der mit der Schlüsselkennung + <parameter>priv_key_id</parameter> und dem Umschlagschlüssel <parameter>env_key</parameter> verknüpft ist und füllt <parameter> - open_data</parameter> mit den entschlüsselten Daten. - Der Umschlag Schlüssel wird bei der Versiegelung erzeugt und kann + open_data</parameter> mit den entschlüsselten Daten. Der + Umschlagschlüssel wird bei der Versiegelung erzeugt und kann ausschlieslich für einen bestimmten privaten Schlüssel verwendet werden. - Mehr Informationen erhalten Sie unter der <function>openssl_seal</function> Funktion. + Mehr Informationen erhalten Sie bei der Dokumentation zu + <function>openssl_seal</function>. </para> <para> <example> <title><function>openssl_open</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -// Annahme: $sealed und $env_key enthalten versiegelte Daten -// und unseren Umschlag Schlüssel; beide haben wir von dem sie -// Versiegelnden erhalten +<?php +// Annahme: $sealed und $env_key enthalten versiegelte Daten und unseren +// Umschlagschlüssel; beide haben wir von dem Versiegelnden erhalten // privaten Schlüssel aus einer Datei holen und vorbereiten $fp = fopen("/src/openssl-0.9.6/demos/sign/key.pem", "r"); @@ -51,13 +47,15 @@ $pkeyid = openssl_get_privatekey($priv_key); // entschlüsseln der Daten und speichern in $open -if (openssl_open($sealed, $open, $env_key, $pkeyid)) +if (openssl_open($sealed, $open, $env_key, $pkeyid)) { echo "Das sind die geöffneten Daten: ", $open; -else +} else { echo "Öffnen der Daten nicht möglich!"; +} // löschen des privaten Schlüssels aus dem Speicher openssl_free_key($pkeyid); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-decrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-pkcs7-decrypt' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-decrypt"> <refnamediv> <refname>openssl_pkcs7_decrypt</refname> @@ -17,18 +14,18 @@ <methodparam><type>string</type><parameter>infilename</parameter></methodparam> <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam><type>mixed</type><parameter>recipcert</parameter></methodparam> - <methodparam><type>mixed</type><parameter>recipkey</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>recipkey</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Die Funktion <function>openssl_pkcs7_decrypt</function> entschlüsselt - die mit S/MIME verschlüsselte Nachricht, die sich in der - Datei befindet, die mit dem Paramter <parameter>infilename</parameter> - angegeben wurde. Benutzt wird dafür das Zertifikat, angegeben durch - <parameter>recipcert</parameter>, und der damit verknüpfte - private Schlüssel, angegeben durch <parameter>recipkey</parameter>. + die mit S/MIME verschlüsselte Nachricht, die sich in der Datei befindet, + die mit dem Paramter <parameter>infilename</parameter> angegeben wurde. + Benutzt wird dafür das Zertifikat, angegeben durch + <parameter>recipcert</parameter>, und der damit verknüpfte private + Schlüssel, angegeben durch <parameter>recipkey</parameter>. </para> - <para>Die entschlüsselte Nachricht wird in die Datei geschrieben, die mit + <para> + Die entschlüsselte Nachricht wird in die Datei geschrieben, die mit dem Parameter <parameter>outfilename</parameter> angegeben wurde. </para> <para> @@ -36,24 +33,23 @@ <title><function>openssl_pkcs7_decrypt</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $cert enthält Ihr persönliches Zertifikat und // $key Ihr privates Schlüsselpaar. Sie erhalten eine S/MIME Nachricht. $infilename = "encrypted.msg"; // diese Datei enthält ihre verschlüsselte Nachricht $outfilename = "decrypted.msg"; // stellen Sie sicher, dass Sie Schreibrechte haben! -if (openssl_pkcs7_decrypt($infilename, $outfilename, $cert, $key)) +if (openssl_pkcs7_decrypt($infilename, $outfilename, $cert, $key)) { echo "entschlüsselt!"; -else +} else { echo "entschlüsseln fehlgeschlagen!"; +} +?> ]]> </programlisting> </example> </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml:1.6 phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml:1.7 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml:1.6 Sat Jul 20 06:07:15 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-encrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-encrypt"> <refnamediv> <refname>openssl_pkcs7_encrypt</refname> @@ -14,26 +14,25 @@ <methodparam><type>string</type><parameter>outfile</parameter></methodparam> <methodparam><type>mixed</type><parameter>recipcerts</parameter></methodparam> <methodparam><type>array</type><parameter>headers</parameter></methodparam> - <methodparam choice="opt"><type>long</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Die Funktion <function>openssl_pkcs7_encrypt</function> verschlüsselt die Inhalte der Datei, angegeben durch den Pararmeter - <parameter>infile</parameter>. Die Verschlüsselung benutzt - eine RC2 40 Bit Chiffre, so dass diese Inhalte nur von den - beabsichtigten Empfängern gelesen werden können, die mit dem Parameter + <parameter>infile</parameter>. Die Verschlüsselung benutzt eine RC2 40 + Bit Chiffre, so dass diese Inhalte nur von den beabsichtigten Empfängern + gelesen werden können, die mit dem Parameter <parameter>recipcerts</parameter> angegeben wurden. Der Parameter <parameter>recipcerts</parameter> kann ein einzelnes X.509 Zertifikat oder ein Array von X.509 Zertifikaten enthalten. Der Parameter <parameter>headers</parameter> ist ein Array aus Headern die den Daten vorangestellt wird, nachdem diese verschlüsselt wurden. - Das Array <parameter>headers</parameter> kann entweder ein assoziatives - Array sein, mit Indizes aus den Headernamen, oder ein indiziertes Array, - wobei jedes Element eine einzelne Header-Zeile enthält. Um den Verschlüsselungsprozess zu beeinflussen, können Sie den Paramter <parameter>flags</parameter> benutzen - siehe <link linkend="openssl.pkcs7.flags"> PKCS7 Konstanten</link>. + <parameter>headers</parameter> kann entweder ein assoziatives Array sein, + mit Indizes aus den Headernamen, oder ein indiziertes Array, wobei jedes + Element eine einzelne Header-Zeile enthält. </para> <para> <example> @@ -41,6 +40,7 @@ Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Die Nachricht die Sie verschlüsselt an Ihren Geheimagenten, // bekannt als Nachtfalke, schicken wollen. // Sein Zertifikat liegt Ihnen in der Datei nighthawk.pem vor. @@ -56,7 +56,7 @@ EOD; // Schlüssel laden -$key = implode("", file("nighthawk.pem")); +$key = file_get_contents("nighthawk.pem"); // speichern der Nachricht in einer Datei $fp = fopen("msg.txt", "w"); @@ -66,17 +66,17 @@ // verschlüsseln if (openssl_pkcs7_encrypt("msg.txt", "enc.txt", $key, array("To" => "nighthawk@example.com", // keyed syntax - "From: HQ <hq@example.com>", // indexed syntax - "Subject" => "Eyes only"))) -{ + "From: HQ <hq@example.com>", // indexed syntax + "Subject" => "Eyes only"))) { + // Nachricht verschlüsselt - ab damit! exec(ini_get("sendmail_path") . " < enc.txt"); } +?> ]]> </programlisting> </example> </para> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-sign.xml Sun Jan 18 18:57:53 2004 @@ -1,13 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-pkcs7-sign' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.11 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-sign"> <refnamediv> <refname>openssl_pkcs7_sign</refname> - <refpurpose>Unterzeichnen einer S/MIME Nachricht</refpurpose> + <refpurpose>Signieren einer S/MIME Nachricht</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -18,20 +15,19 @@ <methodparam><type>mixed</type><parameter>signcert</parameter></methodparam> <methodparam><type>mixed</type><parameter>privkey</parameter></methodparam> <methodparam><type>array</type><parameter>headers</parameter></methodparam> - <methodparam choice="opt"><type>long</type><parameter>flags</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>extracertsfilename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>extracerts</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_pkcs7_sign</function> unterzeichnet die + Die Funktion <function>openssl_pkcs7_sign</function> signiert die Inhalte der Datei, angegeben durch den Pararmeter - <parameter>infilename</parameter>. Beim Unterzeichnen wird das Zertifikat, + <parameter>infilename</parameter>. Beim Signieren wird das Zertifikat, angegeben durch <parameter>signcert</parameter>, und der dazu gehörige - private Schlüssel, angegeben durch <parameter>privkey</parameter>, benutzt. + private Schlüssel <parameter>privkey</parameter> benutzt. </para> <para> Der Parameter <parameter>headers</parameter> ist ein Array aus Headern - die den Daten vorangestellt werden, nachdem diese unterzeichnet wurden + die den Daten vorangestellt werden, nachdem diese signiert wurden (Für mehr Informationen über das Format dieses Parameters schauen Sie bei der Funktion <function>openssl_pkcs7_encrypt</function> nach). </para> @@ -42,22 +38,23 @@ nicht angegeben ist die Vorgabe PKCS7_DETACHED. </para> <para> - Der Parameter <parameter>extracertsfilename</parameter> gibt den Namen - einer Datei an, die ein Bündel von extra Zertifikaten enthält, die in - die Unterschrift mit eingefügt werden. Das kann zum Beispiel als Hilfe - für einen Empfänger dienen, das von Ihnen benutze Zertifikat zu überprüfen. + Der Parameter <parameter>extracerts</parameter> gibt den Namen einer Datei + an, die ein mehrere extra Zertifikate enthält, die in die Unterschrift mit + eingefügt werden. Das kann zum Beispiel als Hilfe für einen Empfänger + dienen, das von Ihnen benutze Zertifikat zu überprüfen. </para> <para> <example> <title><function>openssl_pkcs7_sign</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -// Die Nachricht die Sie unterschreiben möchten, damit der Empfänger sicher sein, -// dass diese Nachricht von Ihnen stammt. +<?php +// Die Nachricht die Sie unterschreiben möchten, damit der Empfänger sicher +// sein kann, dass diese Nachricht von ihnen stammt. $data = <<<EOD -Sie haben meine Erlaubnis 20,000.- DM für Essen auszugeben. +Sie haben meine Erlaubnis 10.000 EUR für Essen auszugeben. Der CEO EOD; @@ -65,24 +62,21 @@ $fp = fopen("msg.txt", "w"); fwrite($fp, $data); fclose($fp); -// encrypt it +// verschlüsslen if (openssl_pkcs7_sign("msg.txt", "signed.txt", "mycert.pem", array("mycert.pem", "mypassphrase"), - array("To" => "joes@sales.com", // keyed syntax - "From: HQ <ceo@sales.com>", // indexed syntax - "Subject" => "Eyes only")) -{ - // Nachricht unterschrieben - abschicken! + array("To" => "joes@example.com", // keyed syntax + "From" => "HQ <ceo@example.com>", // indexed syntax + "Subject" => "Eyes only") + )) { + // Nachricht signiert - abschicken! exec(ini_get("sendmail_path") . " < signed.txt"); } +?> ]]> </programlisting> </example> </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkcs7-verify.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-pkcs7-verify' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkcs7-verify"> <refnamediv> <refname>openssl_pkcs7_verify</refname> @@ -21,7 +18,6 @@ <methodparam choice="opt"><type>array</type><parameter>cainfo</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>extracerts</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Die Funktion <function>openssl_pkcs7_verify</function> liest die S/MIME Nachricht, die in der Datei <parameter>filename</parameter> @@ -45,7 +41,7 @@ </para> <para> Wird der Parameter <parameter>cainfo</parameter> angegeben, sollten - Informationen über die vertrauenswürdigen CA Zertifikate enthalten sein , + Informationen über die vertrauenswürdigen CA Zertifikate enthalten sein, die für den Überprüfungsprozess benutzt werden - für mehr Informationen zu diesem Parameter sollten Sie unter <link linkend="openssl.cert.verification">Zertifikat Nachweis</link> @@ -53,13 +49,9 @@ </para> <para> Wird der Parameter <parameter>extracerts</parameter> angegeben, ist es der - Name einer Datei, die ein Bündel von Zertifikaten enthält, die als + Name einer Datei, die ein mehrere extra Zertifikate enthält, die als nicht vertrauenswürdige CAs genutzt werden. </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkey-export-to-file.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-pkey-export-to-file' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkey-export-to-file"> <refnamediv> <refname>openssl_pkey_export_to_file</refname> @@ -16,15 +13,23 @@ <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>config_args</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_pkey_export_to_file</function> saves an ascii-armoured + (PEM encoded) Darstellung of <parameter>key</parameter> into the file named + by <parameter>outfilename</parameter>. + Der Schlüssel kann optional duch eine <parameter>passphrase</parameter> + geschützt werden. <parameter>configargs</parameter> können Sie benutzen, + um den Export feiner abzustimmen. Sie können damit Optionen für die + openssl Konfigurationsdatei bestimmen und/oder überschreiben. Für mehr + Informationen über <parameter>configargs</parameter> schauen Sie bitte + bei der Dokumentation zu <function>openssl_csr_new</function> nach. + &return.success; </para> + &reference.openssl.note-openssl-cnf; </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkey-export.xml Sun Jan 18 18:57:53 2004 @@ -1,28 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-pkey-export' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkey-export"> <refnamediv> <refname>openssl_pkey_export</refname> <refpurpose>Liefert eine exportierbare Representation eines Schlüssels - in einem String oder einer Datei </refpurpose> + in einem String</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>openssl_pkey_export</methodname> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> - <methodparam><type>mixed</type><parameter>out</parameter></methodparam> + <methodparam><type>string</type><parameter>&out</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>config_args</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; - <para> - &warn.undocumented.func; + <para> + <function>openssl_pkey_export</function> exportiert + <parameter>key</parameter> als eine PEM kodierte Zeichenkette und + speichert diese in <parameter>out</parameter> (welcher per Referenz + übergeben wird). Der Schlüssel kann optional mit einer + <parameter>passphrase</parameter> geschützt werden. + <parameter>configargs</parameter> können Sie benutzen, um den Export + feiner abzustimmen. Sie können damit Optionen für die openssl + Konfigurationsdatei bestimmen und/oder überschreiben. Für mehr + Informationen über <parameter>configargs</parameter> schauen Sie bitte + bei der Dokumentation zu <function>openssl_csr_new</function> nach. + &return.success; </para> + &reference.openssl.note-openssl-cnf; </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml diff -u phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-pkey-new.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-pkey-new' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-pkey-new"> <refnamediv> <refname>openssl_pkey_new</refname> @@ -15,10 +12,16 @@ <type>resource</type><methodname>openssl_pkey_new</methodname> <methodparam choice="opt"><type>array</type><parameter>configargs</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_pkey_new</function> erzeugt ein neues privates und + öffentliches Schlüsselpaar. Den öffentlichen Teil des Schlüssels können + Sie mit <function>openssl_pkey_get_public</function> erhalten. Die + Schlüsselerzeugung können Sie mit <parameter>configargs</parameter> + feiner abstimmen (z.B. die Angabe der verwendeten Bits). Weitere + Informationen zu <parameter>configargs</parameter> entnehmen Sie bitte + der Dokumentation zu <function>openssl_csr_new</function>. </para> + &reference.openssl.note-openssl-cnf; </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-private-decrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-private-decrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-private-decrypt"> <refnamediv> <refname>openssl_private_decrypt</refname> @@ -14,13 +11,21 @@ <methodsynopsis> <type>bool</type><methodname>openssl_private_decrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&decrypted</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_private_decrypt</function> entschlüselt + <parameter>data</parameter>, die zuvor mit + <function>openssl_private_encrypt</function> verschlüsselt wurden und + speichert das Ergebnis in <parameter>decrypted</parameter>. + <parameter>key</parameter> muss der private Schlüssel sein, der dem + Schlüssel entspricht, mit dem die Daten verschlüsselt wurden. + Für <parameter>padding</parameter> ist als Standard auf + OPENSSL_PKCS1_PADDING gesetzt, aber Sie können auch + OPENSSL_SSLV23_PADDING, OPENSSL_PKCS1_OAEP_PADDING oder + OPENSSL_NO_PADDING benutzen. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-private-encrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-private-encrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-private-encrypt"> <refnamediv> <refname>openssl_private_encrypt</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>bool</type><methodname>openssl_private_encrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&crypted</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> Index: phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-public-decrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-public-decrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-public-decrypt"> <refnamediv> <refname>openssl_public_decrypt</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>bool</type><methodname>openssl_public_decrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&crypted</parameter></methodparam> <methodparam><type>resource</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> Index: phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml diff -u phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-public-encrypt.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-public-encrypt' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-public-encrypt"> <refnamediv> <refname>openssl_public_encrypt</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>bool</type><methodname>openssl_public_encrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>crypted</parameter></methodparam> + <methodparam><type>string</type><parameter>&crypted</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>padding</parameter></methodparam> </methodsynopsis> Index: phpdoc-de/reference/openssl/functions/openssl-seal.xml diff -u phpdoc-de/reference/openssl/functions/openssl-seal.xml:1.4 phpdoc-de/reference/openssl/functions/openssl-seal.xml:1.5 --- phpdoc-de/reference/openssl/functions/openssl-seal.xml:1.4 Mon Aug 26 10:48:53 2002 +++ phpdoc-de/reference/openssl/functions/openssl-seal.xml Sun Jan 18 18:57:53 2004 @@ -1,49 +1,47 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-seal' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-seal"> <refnamediv> <refname>openssl_seal</refname> - <refpurpose>Versiegelt (verschlüsselt) Daten</refpurpose> + <refpurpose>Verschlüsselt (versiegelt) Daten</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>openssl_seal</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>sealed_data</parameter></methodparam> - <methodparam><type>array</type><parameter>env_keys</parameter></methodparam> + <methodparam><type>string</type><parameter>&sealed_data</parameter></methodparam> + <methodparam><type>array</type><parameter>&env_keys</parameter></methodparam> <methodparam><type>array</type><parameter>pub_key_ids</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Rückgabewert: im Erolgsfall die Länge der versiegelten Daten, - &false; bei einem Fehler. - War der Aufruf der Funktion erfolgreich, sind die versiegelten Daten - in <parameter>sealed_data</parameter> enthalten und der Umschlag - Schlüssel steht in <parameter>env_keys</parameter> zur Verfügung. + Rückgabewert: im Erfolgsfall die Länge der verschlüsselten Daten, &false; + bei einem Fehler. War der Aufruf der Funktion erfolgreich, sind die + verschlüsselten Daten in <parameter>sealed_data</parameter> enthalten und + der Umschlagschlüssel steht in <parameter>env_keys</parameter> zur + Verfügung. </para> <para> - Die Funktion <function>openssl_seal</function> versiegelt (verschlüsselt) + Die Funktion <function>openssl_seal</function> verschlüsselt <parameter>data</parameter> unter Verwendung von RC4 mit einem zufällig erzeugten geheimen Schlüssel. Dieser Schlüssel wird mit jedem öffentlichen Schlüssel verschlüsselt, der mit der Kennung in <parameter>pub_key_ids</parameter> verknüpft ist. Jeder verschlüsselte Schlüssel wird in <parameter>env_keys</parameter>zurückgegeben.Das - bedeutet, dass Sie versiegelte Daten an mehrere Empfänger versenden können - (unter der Voraussetzung, dass Sie irgendwann die öffentlichen Schlüssel - der Empfänger erhalten haben. Jeder Empfänger muss sowohl die versiegelten - Daten als auch den entsprechenden Umschlag Schlüssel erhalten, der mit - dem öffentlichen Schlüssel des Empfängers versiegelt wurde. + bedeutet, dass Sie verschlüsselte Daten an mehrere Empfänger versenden + können (unter der Voraussetzung, dass Sie irgendwann die öffentlichen + Schlüssel der Empfänger erhalten haben). Jeder Empfänger muss sowohl die + verschlüsselten Daten als auch den entsprechenden Umschlagschlüssel + erhalten, der mit dem öffentlichen Schlüssel des Empfängers versiegelt + wurde. </para> <para> <example> <title><function>openssl_seal</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $data enthält die zu versiegelnden Daten // holen und vorbereiten der öffentlichen Schlüssel unserer Empfänger @@ -58,14 +56,15 @@ fclose($fp); $pk2 = openssl_get_publickey($cert); -// versiegeln der Nachricht, nur Besitzer von $pk1 und $pk2 können -// mit Schlüsseln $sealed entschlüsseln, -// entsprechendes gilt für $ekeys[0] und $ekeys[1]. -openssl_seal($data, $sealed, $ekeys, array($pk1,$pk2)); +// versiegeln der Nachricht, nur Besitzer von $pk1 und $pk2 können mit +// Schlüsseln $sealed entschlüsseln, entsprechendes gilt für $ekeys[0] +// und $ekeys[1]. +openssl_seal($data, $sealed, $ekeys, array($pk1, $pk2)); // Löschen der Schlüssel aus dem Speicher openssl_free_key($pk1); openssl_free_key($pk2); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-sign.xml diff -u phpdoc-de/reference/openssl/functions/openssl-sign.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-sign.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-sign.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-sign.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-sign' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-sign"> <refnamediv> <refname>openssl_sign</refname> @@ -27,15 +24,16 @@ Die Funktion <function>openssl_sign</function> errechnet eine Unterschrift für die im Parameter <parameter>data</parameter> angegebenen Daten. Für das hashing der Daten wird SHA1 benutzt und - anschliessend wird mit dem privaten Schlüssel verschlüsselt, - angegeben mit <parameter>priv_key_id</parameter>. Beachten Sie, dass - die Daten selbst nicht verschlüsselt werden. + anschliessend wird mit dem privaten Schlüssel + <parameter>priv_key_id</parameter> verschlüsselt. Beachten Sie, dass die + Daten selbst nicht verschlüsselt werden. </para> <para> <example> <title><function>openssl_sign</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $data enthält die Daten, die signiert werden sollen. // holen und vorbereiten des privaten Schlüssels aus einer Datei. @@ -49,6 +47,7 @@ // Löschen des Schlüssels aus dem Speicher openssl_free_key($pkeyid); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-verify.xml diff -u phpdoc-de/reference/openssl/functions/openssl-verify.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-verify.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-verify.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-verify.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-verify' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.1 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-verify"> <refnamediv> <refname>openssl_verify</refname> @@ -27,20 +24,19 @@ Die Funktion <function>openssl_verify</function> überprüft die Korrektheit der Unterschrift <parameter>signature</parameter> für die angegebenen Daten <parameter>data</parameter> mit Hilfe des - öffentlichen Schlüssels, verknüpft über den Parameter - <parameter>pub_key_id</parameter>. Das muss der passende - öffentliche zum privaten Schlüssel sein, der für die Unterschrift - benutzt wurde. + öffentlichen Schlüssels <parameter>pub_key_id</parameter>. Das muss der + passende öffentliche zum privaten Schlüssel sein, der für die + Unterschrift benutzt wurde. </para> - <para> <example> <title><function>openssl_verify</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php // Annahme: $data und $signature enthalten die Daten und die Unterschrift -// holen und vorbereiten des öffentlichen Schlüssels aus dem Zertifikat +// holen des öffentlichen Schlüssels aus dem Zertifikat und vorbereiten $fp = fopen("/src/openssl-0.9.6/demos/sign/cert.pem", "r"); $cert = fread($fp, 8192); fclose($fp); @@ -48,15 +44,17 @@ // feststellen, ob die Unterschrift ok ist oder nicht $ok = openssl_verify($data, $signature, $pubkeyid); -if ($ok == 1) +if ($ok == 1) { echo "gut"; -elseif ($ok == 0) +} elseif ($ok == 0) { echo "schlecht"; -else - echo "Mist, Fehler beim Überprüfen der Unterschrift; +} else { + echo "Mist, Fehler beim Überprüfen der Signatur"; +} // Löschen des Schlüssels aus dem Speicher openssl_free_key($pubkeyid); +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-check-private-key.xml Sun Jan 18 18:57:53 2004 @@ -1,13 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-check-private-key' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-check-private-key"> <refnamediv> <refname>openssl_x509_check_private_key</refname> - <refpurpose>Überprüft, ob ein privater Schlüssel zu einem CERT passt </refpurpose> + <refpurpose>Überprüft, ob ein privater Schlüssel zu einem Zertifikat passt </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -16,9 +13,10 @@ <methodparam><type>mixed</type><parameter>cert</parameter></methodparam> <methodparam><type>mixed</type><parameter>key</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_x509_check_private_key</function> gibt &true; zurück, + wenn <parameter>key</parameter> der private Schlüssel ist, der zum + Zertifikat <parameter>cert</parameter> gehört, ansonsten &false;. </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-checkpurpose.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-x509-checkpurpose' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-checkpurpose"> <refnamediv> <refname>openssl_x509_checkpurpose</refname> @@ -20,7 +17,6 @@ <methodparam><type>array</type><parameter>cainfo</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>untrustedfile</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> Kann das Zertifikat für den beabsichtigten Zweck benutzt werden, gibt diese Funktion &true; zurück; falls nicht &false;, bei einem Fehler -1. @@ -58,46 +54,55 @@ <tbody> <row> <entry>X509_PURPOSE_SSL_CLIENT</entry> - <entry>Client-Seite einer SSL Verbindung? + <entry> + Kann das Zertifikat für die Clientseite einer SSL Verbindung benutzt + werden? </entry> </row> <row> <entry>X509_PURPOSE_SSL_SERVER</entry> - <entry>Server-Seite einer SSL Verbindung? + <entry> + Kann das Zertifikat für die Serverseite einer SSL Verbindung benutzt + werden? </entry> </row> <row> <entry>X509_PURPOSE_NS_SSL_SERVER</entry> - <entry>Netscape SSL Server? + <entry> + Kann das Zertifikat für den Netscape SSL Server benutzt werden? </entry> </row> <row> <entry>X509_PURPOSE_SMIME_SIGN</entry> - <entry>Unterschreiben einer S/MIME Email? + <entry> + Kann das Zertifikat zum Signieren einer S/MIME Email benutzt werden? </entry> </row> <row> <entry>X509_PURPOSE_SMIME_ENCRYPT</entry> - <entry>Verschlüsseln einer S/MIME Email?</entry> + <entry> + Kann das Zertifikat zum Verschlüsseln einer S/MIME Email benutzt + werden? + </entry> </row> <row> <entry>X509_PURPOSE_CRL_SIGN</entry> - <entry>Unterschreiben einer Zertifikats-Widerrufliste(CRL)? + <entry> + Kann das Zertifikat zum signieren einer Zertifikatswiderrufliste + (CRL) benutzt werden? </entry> </row> <row> <entry>X509_PURPOSE_ANY</entry> - <entry>Beliebige/alle Zwecke?</entry> + <entry> + Kann das Zertifikat für beliebige/alle Zwecke benutzt werden? + </entry> </row> </tbody> </tgroup> </table> Diese Optionen sind keine Bitfelder - Sie können nur eine einzige angeben! </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-export-to-file.xml Sun Jan 18 18:57:53 2004 @@ -1,25 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-export-to-file' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-export-to-file"> <refnamediv> <refname>openssl_x509_export_to_file</refname> - <refpurpose>Exportiert ein CERT in eine Datei oder eine Variable</refpurpose> + <refpurpose>Exportiert ein Zertifikat in eine Datei</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>bool</type><methodname>openssl_x509_export_to_file </methodname> + <type>bool</type><methodname>openssl_x509_export_to_file</methodname> <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_x509_export_to_file</function> speichert das + <parameter>x509</parameter> Zertifikat in einem PEM kodierten Format + in der Datei <parameter>outfilename</parameter>. + </para> + &reference.openssl.parameter-notext; + <para> + &return.success; </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-export.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-export.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-export.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-export.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-export.xml Sun Jan 18 18:57:53 2004 @@ -1,25 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-export' in en/ tree in rev 1.19 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.19 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-export"> <refnamediv> <refname>openssl_x509_export</refname> - <refpurpose>Exportiert ein CERT in eine Datei oder eine Variable </refpurpose> + <refpurpose>Exportiert ein Zertifikat in eine Zeichenkette</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>openssl_x509_export</methodname> <methodparam><type>mixed</type><parameter>x509</parameter></methodparam> - <methodparam><type>string</type><parameter>outfilename</parameter></methodparam> + <methodparam><type>string</type><parameter>&output</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>notext</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - &warn.undocumented.func; + <function>openssl_x509_export</function> speichert das + <parameter>x509</parameter> Zertifikat in einem PEM kodierten Format + in der Zeichenkette <parameter>output</parameter>. + </para> + &reference.openssl.parameter-notext; + <para> + &return.success; </para> </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-free.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-free.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-free.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-free.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-free.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-x509-free' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-free"> <refnamediv> <refname>openssl_x509_free</refname> @@ -15,16 +12,11 @@ <type>void</type><methodname>openssl_x509_free</methodname> <methodparam><type>resource</type><parameter>x509cert</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_x509_free</function> löscht den - Speicherbereich, der von einem Zertifikat, angegeben - durch den Parameter <parameter>x509cert</parameter>, belegt wurde. + Die Funktion <function>openssl_x509_free</function> gibt den + Speicherbereich frei, der von einer Zertifikatsressource + <parameter>x509cert</parameter> belegt wurde. </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-parse.xml Sun Jan 18 18:57:53 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.1 --> -<!-- last change to 'openssl-x509-parse' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-parse"> <refnamediv> <refname>openssl_x509_parse</refname> @@ -18,26 +15,23 @@ <methodparam><type>mixed</type><parameter>x509cert</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>shortnames</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; + &warn.experimental.func; <para> Die Funktion <function>openssl_x509_parse</function> liefert Informationen - über das angegebene Zertifikat <parameter>x509cert</parameter>. Die - Informationen sind: Name des Gegenstands, Name des Herausgebers, - Zweck, Zeitangaben, wie gültig seit... gültig bis, usw. - Der Parameter <parameter>shortnames</parameter> kontrolliert wie die Daten - im Array indiziert werden - wenn <parameter>shortnames</parameter> &true; - ist (Standard), werden die Felder in Kurzform indiziert, ansonsten werden + über das angegebene Zertifikat <parameter>x509cert</parameter>, wie + Name des Gegenstands, Name des Herausgebers, Zweck, Zeitangaben + (gültig seit... gültig bis), usw. Der Parameter + <parameter>shortnames</parameter> kontrolliert wie die Daten im Array + indiziert werden - wenn <parameter>shortnames</parameter> &true; ist + (Standard), werden die Felder in Kurzform indiziert, ansonsten werden lange Namen verwendet - z.B.: CN ist die Kurzform von commonName. </para> - <para><emphasis> Die Struktur der zurückgegeben Daten ist bis jetzt - (absichtlich) nicht dokumentiert, da es noch vorbehaltliche Änderungen - geben wird + <para> + <emphasis> + Die Struktur der zurückgegeben Daten ist bis jetzt (absichtlich) noch + nicht dokumentiert, da es noch Änderungen geben wird. </emphasis> </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> - </refsect1> </refentry> Index: phpdoc-de/reference/openssl/functions/openssl-x509-read.xml diff -u phpdoc-de/reference/openssl/functions/openssl-x509-read.xml:1.3 phpdoc-de/reference/openssl/functions/openssl-x509-read.xml:1.4 --- phpdoc-de/reference/openssl/functions/openssl-x509-read.xml:1.3 Sun Jun 9 06:56:01 2002 +++ phpdoc-de/reference/openssl/functions/openssl-x509-read.xml Sun Jan 18 18:57:53 2004 @@ -1,14 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/openssl.xml, last change in rev 1.6 --> -<!-- last change to 'openssl-x509-read' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> -<!-- OLD-Revision: 1.22/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.openssl-x509-read"> <refnamediv> <refname>openssl_x509_read</refname> <refpurpose>Analysiert ein X.509 Zertitifikat und gibt eine - Resource-Kennung zurück</refpurpose> + Ressource-Kennung zurück</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -16,15 +13,11 @@ <type>resource</type><methodname>openssl_x509_read</methodname> <methodparam><type>mixed</type><parameter>x509certdata</parameter></methodparam> </methodsynopsis> -&warn.experimental.func; <para> - Die Funktion <function>openssl_x509_read</function> analysiert das Zertifikat - das mit dem Parameter <parameter>x509certdata</parameter> - angegeben wurde und gibt eine Resource-Kennung zurück. + Die Funktion <function>openssl_x509_read</function> analysiert das + Zertifikat <parameter>x509certdata</parameter> und gibt eine + Ressourcekennung zurück. </para> - <note> - <para>Diese Funktion wurde in 4.0.6 hinzugefügt.</para> - </note> </refsect1> </refentry>