PHP Velho Oeste 2024

openssl_pkey_get_details

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

openssl_pkey_get_detailsLiefert ein Array mit Schlüssel-Details

Beschreibung

openssl_pkey_get_details(OpenSSLAsymmetricKey $key): array|false

Diese Funktion gibt die Schlüssel-Details zurück (Bits, Schlüssel, Typ).

Parameter-Liste

key

Die Ressource, die den Schlüssel enthält.

Rückgabewerte

Gibt bei Erfolg ein Array mit den Schlüssel-Details zurück oder false im Fehlerfall. Das zurückgegebene Array enthält die Indizes bits (Anzahl der Bits), key (der öffentliche Schlüssel als Zeichenkette) und type (Typ des Schlüssels, eine der Konstanten OPENSSL_KEYTYPE_RSA, OPENSSL_KEYTYPE_DSA, OPENSSL_KEYTYPE_DH und OPENSSL_KEYTYPE_EC oder -1 für einen unbekannten Typ).

In Abhängigkeit vom verwendeten Schlüssel-Typ können zusätzliche Details zurückgegeben werden. Es ist zu beachten, dass manche Elemente u.U. nicht immer verfügbar sind.

  • OPENSSL_KEYTYPE_RSA: ein zusätzlicher Array-Schlüssel mit dem Namen "rsa", der die Schlüssel-Daten enthält, wird zurückgegeben.
    Schlüssel Beschreibung
    "n" Modul
    "e" Öffentlicher Exponent
    "d" Privater Exponent
    "p" Primzahl 1
    "q" Primzahl 2
    "dmp1" Exponent 1, d mod (p-1)
    "dmq1" Exponent 2, d mod (q-1)
    "iqmp" Koeffizient, (Kehrwert von q) mod p
  • OPENSSL_KEYTYPE_DSA: ein zusätzlicher Array-Schlüssel mit dem Namen "dsa", der die Schlüssel-Daten enthält, wird zurückgegeben.
    Schlüssel Beschreibung
    "p" Primzahl (öffentlich)
    "q" 160-bit Unterprimzahl, q | p-1 (öffentlich)
    "g" Generator der Untergruppe (öffentlich)
    "priv_key" privater Schlüssel
    "pub_key" öffentlicher Schlüssel y = g^x
  • OPENSSL_KEYTYPE_DH: ein zusätzlicher Array-Schlüssel mit dem Namen "dh", der die Schlüssel-Daten enthält, wird zurückgegeben.
    Schlüssel Beschreibung
    "p" Primzahl (geteilt)
    "g" Generator von Z_p (geteilt)
    "priv_key" privater DH-Wert x
    "pub_key" öffentlicher DH-Wert g^x
  • OPENSSL_KEYTYPE_EC: ein zusätzlicher Array-Schlüssel mit dem Namen "ec", der die Schlüssel-Daten enthält, wird zurückgegeben.
    Key Beschreibung
    "curve_name" Der Name der Kurve, siehe openssl_get_curve_names().
    "curve_oid" ASN1-Objektkennung (OID) für EC-Kurve.
    "x" x-Koordinate (öffentlich)
    "y" y-Koordinate (öffentlich)
    "d" privater Schlüssel

Changelog

Version Beschreibung
8.0.0 key akzeptiert nun eine OpenSSLAsymmetricKey-Instanz; vorher wurde eine Ressource vom Typ OpenSSL-Schlüssel akzeptiert.
add a note add a note

User Contributed Notes 1 note

up
15
langemeijer at php dot net
11 years ago
These are the missing descriptions for RSA elements:

n - modulus
e - publicExponent
d - privateExponent
p - prime1
q - prime2
dmp1 - exponent1, d mod (p-1)
dmq1 - exponent2, d mod (q-1)
iqmp - coefficient, (inverse of q) mod p
To Top