openssl_verify(): Supplied key param cannot be coerced into a public key

Имя функции бывает разным (`openssl_verify`, `openssl_sign`, `openssl_seal`, `openssl_public_encrypt`…), как и вид ключа («public key» / «private key»). При включённом `display_errors` PHP добавляет префикс «Warning: ».

PHP OpenSSL extension — warning from openssl_verify / openssl_sign / openssl_seal

Что это означает

Функции OpenSSL в PHP принимают ключ в виде текста PEM, пути `file://` или объекта ключа, а переданное значение не удалось превратить в ключ нужного вида (открытый для проверки, закрытый для подписи). Это предупреждение, а не исключение: функция возвращает `false` (или `-1`), и код, который проверяет только `=== 1`, молча принимает это за неверную подпись. Исходную причину от OpenSSL можно получить через `openssl_error_string()`.

Почему это происходит

• PEM с буквальными \n из переменной окружения

  часто

  Ключи, хранящиеся в файлах `.env`, переменных CI или JSON, часто содержат вместо переводов строк два символа: `\` и `n`. OpenSSL не может разобрать такой PEM.

• Путь к файлу без file://

  часто

  Голый путь вроде `/etc/app/private.pem` воспринимается как текст PEM, и разбор не удаётся. PHP ожидает `file:///etc/app/private.pem` или содержимое файла.

• Сертификат, закрытый ключ или SSH-ключ там, где ожидается открытый ключ

  иногда

  `openssl_verify` принимает сертификат или открытый ключ; открытый ключ OpenSSH (`ssh-ed25519 AAAA…`) или JSON-строка JWK — это не PEM.

• Зашифрованный закрытый ключ без парольной фразы

  иногда

  Если передать PEM `ENCRYPTED PRIVATE KEY` строкой в `openssl_sign`, ничего не выйдет; сначала загрузите ключ через `openssl_pkey_get_private($pem, $passphrase)`.

Как исправить

1. 1.

   Загружайте ключ явно и выводите причину от OpenSSL

   `openssl_pkey_get_public` / `_private` при сбое возвращают `false`; вызывайте `openssl_error_string()`, пока очередь ошибок не опустеет, записывайте причину в журнал и останавливайтесь, а не продолжайте после неудачной проверки.

   $pem = str_replace('\\n', "\n", getenv('JWT_PUBLIC_KEY'));   // undo escaped newlines
   $publicKey = openssl_pkey_get_public($pem);
   if ($publicKey === false) {
       while ($msg = openssl_error_string()) {
           error_log($msg);                                     // the real OpenSSL reason
       }
       throw new RuntimeException('JWT_PUBLIC_KEY is not a usable public key');
   }
   $ok = openssl_verify($data, $signature, $publicKey, OPENSSL_ALGO_SHA256) === 1;

2. 2.

   Используйте file:// для путей к файлам и передавайте парольные фразы

   Указывайте источник ключа явно: либо содержимое PEM, либо URI `file://`, а для зашифрованных ключей — ещё и парольную фразу.

   // Paths need the file:// scheme; encrypted keys need their passphrase.
   $privateKey = openssl_pkey_get_private('file:///etc/app/private.pem', getenv('KEY_PASSPHRASE') ?: null);

← Открыть всю базу ошибок подписей