php / php/php-src

openssl_pkey_export() Fails Under OpenSSL 3.x FIPS Mode (due to legacy PEM encryption APIs)

オープン
#18,468 コメント 1 件 リアクション 0 件 担当者 1 名 GitHub で見る

@bukka がすでに取り組んでいます。

2025年5月3日 から。

Extension: openssl Feature
主要言語
C
スター
40.4k
フォーク
8.1k
平均マージ
2日 13時間
マージ済み PR(30日)
96

説明

Description

Summary
When using PHP with OpenSSL 3.x in FIPS mode (as enabled by default in certain environments such as Amazon Linux 2023), the openssl_pkey_export() function fails when a passphrase is provided.

This is due to the use of legacy OpenSSL APIs (PEM_write_bio_PrivateKey() → PEM_write_bio_PrivateKey_traditional() → EVP_CipherInit_ex()), which are not FIPS-compliant in OpenSSL 3.x.

Affected:
PHP 8.1 – 8.4

OpenSSL 3.x in FIPS mode

PHP’s built-in openssl extension

openssl_pkey_export($key, $out, $passphrase) when $passphrase is provided

Reproduction

<?php
$privateKey = openssl_pkey_new([
    "private_key_bits" => 2048,
    "private_key_type" => OPENSSL_KEYTYPE_RSA,
]);

openssl_pkey_export($privateKey, $out, 'testpass');

When run under OpenSSL 3.x with FIPS enabled, the call fails with:

error:0308010C:digital envelope routines::unsupported

Root Cause (maybe?)

Internally, PHP uses:

openssl_pkey_export()
  ↓
PEM_write_bio_PrivateKey()
  ↓
PEM_write_bio_PrivateKey_traditional()
  ↓
PEM_ASN1_write_bio()
  ↓
EVP_CipherInit_ex() (manual cipher setup)

In OpenSSL 3 FIPS mode, manual cipher encryption is disallowed.
Only provider-based encryption (via OSSL_ENCODER, etc.) is allowed.

This behavior is documented in the OpenSSL 3.x migration guide and FIPS module guide:

Applications should no longer rely on implicit fetches of algorithms
or manually configure cipher contexts outside the provider framework.

Expected Behavior

If the system is in FIPS mode and the passphrase is provided,
openssl_pkey_export() should either:

Properly export the key using a FIPS-compliant provider mechanism (e.g., via OSSL_ENCODER)

Or fail with a clear message that encrypted exports are not supported under current conditions

As a note, my openssl is configured properly and I can generate a private key with a passphrase via the command line. Also, if you leave the passphrase out of the call openssl_pkey_export() it does work without encryption.

PHP Version

PHP 8.1.32 (cli) (built: Mar 11 2025 22:09:20) (NTS gcc x86_64)
Copyright (c) The PHP Group
Zend Engine v4.1.32, Copyright (c) Zend Technologies
with Zend OPcache v8.1.32, Copyright (c), by Zend Technologies

Operating System

No response

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。