| Предыдущий | Следующий |
| NTE_BUFFERS_OVERLAP | NTE_INTERNAL_ERROR |
NTE_DECRYPTION_FAILURE
NTE_DECRYPTION_FAILURE следует интерпретировать на границе проверки расшифрования или unwrap . Поставщик не смог получить корректный plaintext или ключевой материал с указанным ключом, ciphertext, IV, nonce, padding, tag или параметрами wrapping. Полезный диагностический вопрос — какой конкретный объект и операция заставили Windows выбрать именно этот HRESULT, а не работает ли в целом некий ключ, сертификат, учётная запись, файл или устройство.
Где выбирается это состояние
Сбой возникает после того, как криптографическая операция получила достаточно контекста для обработки ключевого материала и данных. Для этого результата сохраните точные алгоритм, режим, padding, версию ключа, nonce или IV, authentication tag, associated data, входные байты и контракт вывода. Общего ярлыка «decrypt» или «verify» недостаточно для воспроизведения операции.
Данные, которые меняют диагноз
| Запишите | Почему это важно для данного кода |
|---|---|
| Идентификаторы алгоритма и поставщика, а также идентичность ключа и политика его использования | Для этого результата это позволяет воспроизвести криптографическую операцию без записи секретов. |
| Ciphertext или байты сообщения, режим, padding, IV или nonce, tag и границы associated data | При этом результате это отделяет повреждённые или несовпадающие данные от выполнения операции поставщиком. |
| Первый результат поставщика до преобразования обёрткой в общую ошибку безопасности | Это сохраняет низкоуровневый результат, который обёртки часто скрывают при этом результате. |
Проверки, специфичные для кода:
- Убедитесь, что шифрование и расшифрование используют одинаковые идентификатор алгоритма, режим, padding, nonce/IV, associated data и версию ключа.
- Сохраните байты ciphertext до преобразования в текст, декодирования транспорта или извлечения из контейнера.
- Для аутентифицированного шифрования записывайте длину tag и границы associated data, не записывая секреты.
Сохраните цепочку доказательств
Сопоставьте последнюю успешную операцию с установкой или обновлением поставщика, созданием или обновлением ключа, изменениями профиля или сеанса, подключением и отключением устройства, обновлением политик и первым неудачным вызовом. При этом результате порядок важен: ошибка сразу после миграции ключа указывает на другую границу, чем сбой после смены учётной записи службы.
- Для этого результата подготовьте минимальный пример с именем API, поставщика, ключа или контейнера, флагами и размерами нечувствительных входных данных.
- Для этого пути сохраните события поставщика, устройства, профиля и ОС за период от последнего успеха до первого сбоя.
- Для этого пути сохраните заведомо исправный контрольный результат с той же идентичностью, архитектурой и выбором поставщика.
Контролируемое воспроизведение
Используйте опубликованный или внутренний фиксированный known-answer vector с тем же криптографическим примитивом, затем, если политика допускает, обработайте производственный ввод заведомо исправными ключом и поставщиком. Эти два направления отделяют проблему реализации или параметров от повреждённых либо несовпадающих данных.
| Тест | Интерпретация |
|---|---|
| Тот же ввод, заведомо исправный путь | Успех переносит внимание на выбранного поставщика, политику, устройство, контекст или состояние транзакции. |
| Заведомо исправный ввод, сбойный путь | Сбой указывает, что среда или выбранный объект самостоятельно не способны выполнить операцию. |
| Исходный путь после одного изолированного изменения | Это сравнение показывает, устраняет ли предложенное исправление исходное условие. |
Соседние результаты и вводящие в заблуждение исправления
Этот результат не доказывает, что помогут дополнительные разрешения. Обычно он означает криптографическое несовпадение, повреждённый ввод или ошибку аутентификации. Повторный перебор паролей, режимов padding или ключей на защищённых данных может вызвать блокировку и скрывает связь каждого результата с конкретным набором параметров. Помечайте каждую контролируемую попытку.
Также сохраняйте исходное числовое значение: соседние константы могут требовать существенно разного восстановления, даже если приложение показывает их все как ошибку аутентификации, сертификата или безопасности.
Что считается реальным исправлением
Для этого результата проверка должна успешно проходить с предназначенными ключом и параметрами протокола, а намеренно изменённый ввод — по-прежнему завершаться сбоем. Такая положительная и отрицательная пара доказывает больше, чем один удачный повтор. Сохраните регрессионный тест с нечувствительными идентификаторами и ожидаемыми результатами, включая отрицательный контроль.
Технические ссылки
Эти источники определяют HRESULT и соответствующий интерфейс, протокол или формат данных.
- Открытые спецификации Microsoft: значения HRESULT.
- Microsoft: NCryptDecrypt.
- NIST SP 800-38D: GCM и GMAC.
Нужно найти другой код? Найти другой код состояния или ошибки.