Openssl get curve names: примеры (PHP)

Получение всего списка доступных кривых.

<?php
$curves = openssl_get_curve_names();
if ($curves === false) {
    echo 'Не удалось получить список кривых';
} else {
    print_r($curves);
}

Array
(
    [0] => secp112r1
    [1] => secp112r2
    [2] => secp128r1
    [3] => secp128r2
    [4] => secp160k1
    [5] => secp160r1
    [6] => secp160r2
    [7] => secp192k1
    [8] => prime192v1
    [9] => secp224k1
    [10] => secp224r1
    [11] => secp256k1
    [12] => prime256v1
    [13] => secp384r1
    [14] => secp521r1
    [15] => brainpoolP256r1
    [16] => brainpoolP384r1
    [17] => brainpoolP512r1
)

<?php
$curves = openssl_get_curve_names();
if (!empty($curves)) {
    echo 'Первая доступная кривая: ' . $curves[0];
}

Первая доступная кривая: secp112r1

Прямых аналогов для получения списка эллиптических кривых в PHP нет. Однако, для работы с криптографией доступны другие функции модуля OpenSSL.

• openssl_get_md_methods() — возвращает доступные алгоритмы хеширования.
• openssl_get_cipher_methods() — предоставляет список симметричных шифров.
• openssl_get_publickey() и openssl_get_privatekey() — используются для работы с ключами, которые могут быть сгенерированы на определенных кривых.

Функцию openssl_get_curve_names() применяют на этапе выбора параметров для генерации ключей, тогда как другие функции выполняют сами криптографические операции.

Функция недоступна, если модуль OpenSSL не скомпилирован или отключен в PHP.

<?php
// Если модуль openssl отсутствует
$curves = openssl_get_curve_names();
var_dump($curves);

Fatal error: Uncaught Error: Call to undefined function openssl_get_curve_names()

На некоторых старых или особо сконфигурированных сборках список может быть пустым.

<?php
$curves = openssl_get_curve_names();
if (empty($curves)) {
    echo 'Нет доступных эллиптических кривых.';
}

Нет доступных эллиптических кривых.

Для предотвращения проблем проверяют наличие функции и результат ее выполнения.

Функция openssl_get_curve_names() была добавлена в PHP 7.1. С момента своего появления она не претерпела значительных изменений в синтаксисе или поведении. В PHP 8.0 и 8.1 не было внесено модификаций, влияющих на ее работу. Стабильность функции обеспечивает ее предсказуемость в различных версиях.

Поиск кривых, относящихся к набору "secp".

<?php
$curves = openssl_get_curve_names();
$filtered = array_filter($curves, function($curve) {
    return strpos($curve, 'secp') === 0;
});
print_r(array_values($filtered));

Array
(
    [0] => secp112r1
    [1] => secp112r2
    [2] => secp128r1
    [3] => secp128r2
    [4] => secp160k1
    [5] => secp160r1
    [6] => secp160r2
    [7] => secp192k1
    [8] => secp224k1
    [9] => secp224r1
    [10] => secp256k1
    [11] => secp384r1
    [12] => secp521r1
)

<?php
$desiredCurve = 'prime256v1';
$availableCurves = openssl_get_curve_names();

if (in_array($desiredCurve, $availableCurves)) {
    // Генерация ключа с использованием $desiredCurve
    $config = [
        "curve_name" => $desiredCurve,
        "private_key_type" => OPENSSL_KEYTYPE_EC,
    ];
    $keyPair = openssl_pkey_new($config);
    echo 'Ключ для кривой ' . $desiredCurve . ' успешно создан.';
} else {
    echo 'Кривая ' . $desiredCurve . ' не поддерживается.';
}

Ключ для кривой prime256v1 успешно создан.

Получение списка кривых для настройки параметров обмена ключами.

<?php
$curves = openssl_get_curve_names();
$strongCurves = [];
// Условный выбор кривых с размером больше 256 бит
foreach ($curves as $curve) {
    if (preg_match('/secp(\d+)r1/', $curve, $matches)) {
        if ($matches[1] >= 256) {
            $strongCurves[] = $curve;
        }
    }
}
echo 'Рекомендуемые кривые для ECDH: ' . implode(', ', $strongCurves);

Рекомендуемые кривые для ECDH: secp256k1, secp256r1, secp384r1, secp521r1

В Python используется библиотека cryptography. Прямого аналога для получения списка кривых может не быть, но имена кривых указываются напрямую при создании ключей.

from cryptography.hazmat.primitives.asymmetric import ec

# Выбор конкретной кривой при генерации ключа
private_key = ec.generate_private_key(ec.SECP256R1())
print(type(private_key))

<class 'cryptography.hazmat.primitives.asymmetric.ec.EllipticCurvePrivateKey'>

В Node.js модуль crypto предоставляет методы для работы с ECDH, где также требуется указывать имя кривой.

const crypto = require('crypto');

// Создание объекта ECDH с конкретной кривой
alice = crypto.createECDH('prime256v1');
alice.generateKeys();
console.log('Ключ сгенерирован для кривой: prime256v1');

Ключ сгенерирован для кривой: prime256v1

В отличие от PHP, где можно получить весь список, в других языках имена кривых обычно указываются явно на основе документации.