Openssl spki export challenge: примеры (PHP)

Короткие примеры использования

Извлечение challenge из строки SPKAC.

<?php
$spkac = 'MIICRTCCASUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDM...'; // сокращено
$challenge = openssl_spki_export_challenge($spkac);
echo $challenge;
?>

0b4a5e8f3d2c1a9b876543210fedcba9

Если переданная строка не является корректным SPKAC, функция вернет null.

<?php
$invalidSpkac = 'некорректная_строка';
$result = openssl_spki_export_challenge($invalidSpkac);
var_dump($result);
?>

NULL

Похожие функции в PHP

В PHP существует ряд функций для работы с SPKAC и ключами.

• openssl_spki_new – генерирует новый подписанный запрос на ключ (SPKAC) с использованием приватного ключа и challenge.
• openssl_spki_verify – проверяет подпись SPKAC.
• openssl_spki_export – экспортирует открытый ключ из SPKAC в формате PEM.

Функция openssl_spki_export_challenge используется именно для извлечения challenge, тогда как другие функции выполняют связанные задачи по созданию и проверке SPKAC.

Типичные ошибки

Если строка не является валидным SPKAC, функция возвращает null и может генерировать предупреждение.

<?php
$spkac = 'случайная_строка';
$challenge = openssl_spki_export_challenge($spkac);
if ($challenge === null) {
    echo "Не удалось извлечь challenge. Возможно, неверный формат SPKAC.";
}
?>

Не удалось извлечь challenge. Возможно, неверный формат SPKAC.

Передача аргумента не строкового типа приведет к ошибке типа в PHP 8+.

<?php
$spkac = 12345;
$challenge = openssl_spki_export_challenge($spkac);
?>

TypeError: openssl_spki_export_challenge(): Argument #1 ($spki) must be of type string, int given

Изменения в последних версиях PHP

В PHP 8.0 сигнатура функции была изменена для приведения к строгой типизации. Аргумент $spki теперь имеет тип string. Передача значения другого типа приводит к TypeError.

До PHP 8.0 аргумент принимался без строгой проверки типа, что могло приводить к неожиданному поведению.

Расширенные примеры использования

Создание SPKAC, проверка и извлечение challenge.

<?php
// Генерация ключевой пары и SPKAC
$privkey = openssl_pkey_new(['private_key_bits' => 2048]);
$challenge = 'my_secret_challenge_123';
$spkac = openssl_spki_new($privkey, $challenge);

// Проверка SPKAC
if (openssl_spki_verify($spkac)) {
    echo "SPKAC валиден.\n";
    // Извлечение challenge
    $extractedChallenge = openssl_spki_export_challenge($spkac);
    echo "Извлеченный challenge: $extractedChallenge\n";
    echo "Оригинальный challenge: $challenge\n";
    echo "Совпадают: " . ($extractedChallenge === $challenge ? 'да' : 'нет');
}
?>

SPKAC валиден.
Извлеченный challenge: my_secret_challenge_123
Оригинальный challenge: my_secret_challenge_123
Совпадают: да

SPKAC часто передается в кодировке base64.

<?php
// Предположим, что данные пришли из POST запроса
$spkacBase64 = $_POST['spkac'] ?? '';
if (!empty($spkacBase64)) {
    // Декодируем из base64, если требуется (SPKAC может передаваться как чистая строка)
    $spkac = base64_decode($spkacBase64) ?: $spkacBase64;
    $challenge = openssl_spki_export_challenge($spkac);
    if ($challenge) {
        echo "Challenge для сессии: $challenge";
        // Использовать challenge для проверки подлинности запроса
    }
}
?>

Challenge для сессии: 0b4a5e8f3d2c1a9b876543210fedcba9

Извлечение challenge из массива SPKAC.

<?php
$spkacs = [
    'SPKAC1' => 'MIICRTCCASUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDM...',
    'SPKAC2' => 'MIICRTCCASUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDL...',
];
foreach ($spkacs as $name => $spkac) {
    $challenge = openssl_spki_export_challenge($spkac);
    if ($challenge) {
        echo "$name: $challenge\n";
    } else {
        echo "$name: не удалось извлечь\n";
    }
}
?>

SPKAC1: 0b4a5e8f3d2c1a9b876543210fedcba9
SPKAC2: a1b2c3d4e5f67890123456789abcdef0

Альтернативы в других языках

Прямых аналогов openssl_spki_export_challenge в других языках может не быть, так как SPKAC – это специфичный формат. Однако аналогичные операции по извлечению данных из структур, подобных SPKAC, возможны.

В Node.js можно разобрать SPKAC с помощью модуля crypto.

const crypto = require('crypto');
const spkac = getSpkacSomehow(); // получение SPKAC
const challenge = crypto.verifySpkac(Buffer.from(spkac)); // verifySpkac возвращает объект с данными
console.log(challenge.challenge.toString('hex'));

0b4a5e8f3d2c1a9b876543210fedcba9

В Python можно использовать субпроцесс для вызова OpenSSL или парсить вручную.

import subprocess
import base64
# Предполагаем, что SPKAC в base64
spkac_b64 = 'MIICRTCCASUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDM...'
# Декодируем и передаем в openssl через subprocess
result = subprocess.run(['openssl', 'spkac', '-challenge'], 
                       input=base64.b64decode(spkac_b64), 
                       capture_output=True)
print(result.stdout.decode().strip())

0B4A5E8F3D2C1A9B876543210FEDCBA9