openssl pkey get details(): Skillnad mellan sidversioner

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök
Ingen redigeringssammanfattning
Ingen redigeringssammanfattning
 
Rad 8: Rad 8:
openssl_pkey_get_details(OpenSSLAsymmetricKey '''$key'''): array|false
openssl_pkey_get_details(OpenSSLAsymmetricKey '''$key'''): array|false
</pre>
</pre>
Denna funktion returnerar nyckeldetaljer (bits, nyckel, typ).
Denna funktion returnerar detaljer om nyckeln såsom bitantal, nyckel och typ.


==== Parametrar ====
==== Parametrar ====
Rad 15: Rad 15:


==== Returnerar ====
==== Returnerar ====
Returnerar en array med nyckeldetaljer vid framgång eller <code>false</code> vid fel. Returnerad array har index:
Returnerar en array med nyckeldetaljer vid framgång, eller <code>false</code> vid misslyckande. Returnerad array innehåller indexen:
* '''bits''' — Antal bitar.
* '''bits''' — Antal bitar.
* '''key''' — Strängrepresentation av den publika nyckeln.
* '''key''' — Strängrepresentation av den publika nyckeln.
* '''type''' — Typ av nyckel, vilket är en av <code>OPENSSL_KEYTYPE_RSA</code>, <code>OPENSSL_KEYTYPE_DSA</code>, <code>OPENSSL_KEYTYPE_DH</code>, <code>OPENSSL_KEYTYPE_EC</code>, eller <code>-1</code> vilket betyder okänd.
* '''type''' — Nyckeltypen, en av <code>OPENSSL_KEYTYPE_RSA</code>, <code>OPENSSL_KEYTYPE_DSA</code>, <code>OPENSSL_KEYTYPE_DH</code>, <code>OPENSSL_KEYTYPE_EC</code> eller <code>-1</code> (okänd typ).


Beroende på vilken nyckeltyp som används kan ytterligare detaljer returneras. Observera att vissa element kanske inte alltid är tillgängliga.
Beroende på använd nyckeltyp kan ytterligare detaljer returneras. Notera att vissa element kanske inte alltid är tillgängliga.


* '''OPENSSL_KEYTYPE_RSA''' - En extra array-nyckel med namnet "rsa" som innehåller nyckeldata:
==== Nyckeldetaljer per nyckeltyp ====
  * "n" — modulus
{| class="wikitable"
  * "e" publik exponent
|+ Nyckeltyper och ytterligare detaljer
  * "d" — privat exponent
|-
  * "p" — primtal 1
! Typ !! Beskrivning
  * "q" — primtal 2
|-
  * "dmp1" — exponent1, d mod (p-1)
| <code>OPENSSL_KEYTYPE_RSA</code> || En array med nyckeldetaljer, med indexen:
  * "dmq1" — exponent2, d mod (q-1)
* '''n''' — modulus
  * "iqmp" — koefficient, (inversen av q) mod p
* '''e''' offentlig exponent
 
* '''d''' — privat exponent
* '''OPENSSL_KEYTYPE_DSA''' - En extra array-nyckel med namnet "dsa" som innehåller nyckeldata:
* '''p''' — primtal 1
  * "p" — primtal (publikt)
* '''q''' — primtal 2
  * "q" — 160-bitars subprimtal, q | p-1 (publikt)
* '''dmp1''' — exponent1, d mod (p-1)
  * "g" — generator för undergruppen (publikt)
* '''dmq1''' — exponent2, d mod (q-1)
  * "priv_key" — privat nyckel x
* '''iqmp''' — koefficient, (invers av q) mod p
  * "pub_key" publik nyckel y = g^x
|-
 
| <code>OPENSSL_KEYTYPE_DSA</code> || En array med nyckeldetaljer, med indexen:
* '''OPENSSL_KEYTYPE_DH''' - En extra array-nyckel med namnet "dh" som innehåller nyckeldata:
* '''p''' — primtal (offentlig)
  * "p" — primtal (delat)
* '''q''' — 160-bits subprimtal, q | p-1 (offentlig)
  * "g" — generator av Z_p (delat)
* '''g''' — generator av undergrupp (offentlig)
  * "priv_key" — privat DH-värde x
* '''priv_key''' — privat nyckel x
  * "pub_key" publik DH-värde g^x
* '''pub_key''' offentlig nyckel y = g^x
 
|-
* '''OPENSSL_KEYTYPE_EC''' - En extra array-nyckel med namnet "ec" som innehåller nyckeldata:
| <code>OPENSSL_KEYTYPE_DH</code> || En array med nyckeldetaljer, med indexen:
  * "curve_name" namn på kurvan, se <code>openssl_get_curve_names()</code>
* '''p''' — primtal (delad)
  * "curve_oid" — ASN1 Object identifier (OID) för EC-kurvan
* '''g''' — generator av Z_p (delad)
  * "x" — x-koordinat (publik)
* '''priv_key''' — privat DH-värde x
  * "y" — y-koordinat (publik)
* '''pub_key''' offentlig DH-värde g^x
  * "d" — privat nyckel
|-
| <code>OPENSSL_KEYTYPE_EC</code> || En array med nyckeldetaljer, med indexen:
* '''curve_name''' Namn på kurvan, se <code>openssl_get_curve_names()</code>.
* '''curve_oid''' — ASN1-objektidentifierare (OID) för EC-kurva.
* '''x''' — x-koordinat (offentlig)
* '''y''' — y-koordinat (offentlig)
* '''d''' — privat nyckel
|}


==== Ändringslogg ====
==== Changelog ====
{| class="wikitable"
{| class="wikitable"
! Version !! Beskrivning
! Version !! Beskrivning
|-
|-
| 8.0.0 || '''key''' accepterar nu en OpenSSLAsymmetricKey; tidigare accepterades en resurs av typen OpenSSL-nyckel.
| 8.0.0 || '''key''' accepterar nu en <code>OpenSSLAsymmetricKey</code>; tidigare accepterades en resurs av typen OpenSSL-nyckel.
|}
|}


= Sidslut =
= Sidslut =

Nuvarande version från 31 oktober 2024 kl. 17.22

openssl_pkey_get_details

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

openssl_pkey_get_details — Returnerar en array med nyckeldetaljer

Beskrivning

openssl_pkey_get_details(OpenSSLAsymmetricKey '''$key'''): array|false

Denna funktion returnerar detaljer om nyckeln såsom bitantal, nyckel och typ.

Parametrar

key Resurs som håller nyckeln.

Returnerar

Returnerar en array med nyckeldetaljer vid framgång, eller false vid misslyckande. Returnerad array innehåller indexen:

  • bits — Antal bitar.
  • key — Strängrepresentation av den publika nyckeln.
  • type — Nyckeltypen, en av OPENSSL_KEYTYPE_RSA, OPENSSL_KEYTYPE_DSA, OPENSSL_KEYTYPE_DH, OPENSSL_KEYTYPE_EC eller -1 (okänd typ).

Beroende på använd nyckeltyp kan ytterligare detaljer returneras. Notera att vissa element kanske inte alltid är tillgängliga.

Nyckeldetaljer per nyckeltyp

Nyckeltyper och ytterligare detaljer
Typ Beskrivning
OPENSSL_KEYTYPE_RSA En array med nyckeldetaljer, med indexen:
  • n — modulus
  • e — offentlig exponent
  • d — privat exponent
  • p — primtal 1
  • q — primtal 2
  • dmp1 — exponent1, d mod (p-1)
  • dmq1 — exponent2, d mod (q-1)
  • iqmp — koefficient, (invers av q) mod p
OPENSSL_KEYTYPE_DSA En array med nyckeldetaljer, med indexen:
  • p — primtal (offentlig)
  • q — 160-bits subprimtal, q | p-1 (offentlig)
  • g — generator av undergrupp (offentlig)
  • priv_key — privat nyckel x
  • pub_key — offentlig nyckel y = g^x
OPENSSL_KEYTYPE_DH En array med nyckeldetaljer, med indexen:
  • p — primtal (delad)
  • g — generator av Z_p (delad)
  • priv_key — privat DH-värde x
  • pub_key — offentlig DH-värde g^x
OPENSSL_KEYTYPE_EC En array med nyckeldetaljer, med indexen:
  • curve_name — Namn på kurvan, se openssl_get_curve_names().
  • curve_oid — ASN1-objektidentifierare (OID) för EC-kurva.
  • x — x-koordinat (offentlig)
  • y — y-koordinat (offentlig)
  • d — privat nyckel

Changelog

Version Beskrivning
8.0.0 key accepterar nu en OpenSSLAsymmetricKey; tidigare accepterades en resurs av typen OpenSSL-nyckel.

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/function.openssl-pkey-get-details.php PHP Funktioner Funktionsreferens OpenSSL-funktioner


Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp som har sponsrat Linux.se med webserver.