Хешировать или шифровать: как хранить пароли и секреты
- Как разделить секреты по необходимости восстановления
- Почему пользовательские пароли нельзя хранить обратимо
- Как подбирать соль, память и время для Argon2
- Что предусмотреть для старых хешей, ключей и токенов
В одной таблице лежат пароль пользователя и API-ключ внешнего сервиса. Оба значения секретны, но хранить их одинаково нельзя: пароль достаточно проверять, а ключ приложению может понадобиться в исходном виде.
Поэтому пользовательский пароль храните как односторонний парольный хеш с солью. Для восстанавливаемого секрета выбирайте шифрование и отдельно определяйте, где находится ключ шифрования, кто имеет к нему доступ и как менять его версию.
Ниже — редакционный чек-лист Deskforge. Его нужно адаптировать к инфраструктуре и рискам проекта: это не обязательный стандарт и не результат испытания продукта. Общий подход к проверяемым требованиям разобран в статье о критериях приёмки программы, а работа с веб-сервисами описана на странице контента и сайтов.
Разделить секреты по необходимости восстановления
Первый вопрос — должно ли приложение получить исходное значение. Если системе нужно только проверить введённый пароль, обратимое хранение не требуется. Документация Python рекомендует не сохранять пароли ни открытым текстом, ни в зашифрованном восстанавливаемом виде.
Когда сервис должен передать сохранённый API-ключ внешней системе, односторонний хеш не подходит: получить из него исходное значение нельзя. Для таких секретов нужен обратимый механизм. Например, pgcrypto поддерживает симметричное и открыто-ключевое PGP-шифрование.
Редакционная рекомендация: составьте реестр секретов и назначьте каждому одно основное действие — проверка совпадения или извлечение исходного значения. Добавьте владельца, места использования и компоненты с доступом. Такой реестр задаёт границы решения, но не заменяет модель угроз проекта.
Пользовательские пароли: необратимое хранение вместо шифрования
Пароль приложения следует сохранять как результат стойкой односторонней парольной функции с солью. Шифрование оставляет возможность восстановить значение, хотя для обычной проверки входа она не нужна.
Быстрый хеш не заменяет парольную функцию. Документация Python приводит прямой вызов SHA-1 для пароля как наивный подход, неустойчивый к перебору. Подходящая функция должна быть настраиваемой, медленной и использовать соль.
Argon2 предназначен в том числе для хеширования паролей и требует затрат памяти. RFC 9106 предписывает реализациям этого документа поддерживать Argon2id. Это требование RFC к реализации, а не подтверждение пригодности любых параметров для любого сервиса.
Соль и вычислительная стоимость Argon2
RFC 9106 рекомендует для парольного хеширования соль длиной 16 байт и отдельную уникальную соль для каждого пароля. Уникальность не означает секретность соли и сама по себе не определяет всю схему аутентификации.
У Argon2 раздельно настраиваются размер памяти и число проходов. Допустимые диапазоны RFC — границы протокола, а не готовая конфигурация приложения. Параметры из чужого примера нельзя считать подходящими без проверки ресурсов своего сервиса.
Редакционная проверка: на изолированном стенде измерьте расход памяти и задержку при ожидаемом числе одновременных проверок. RFC предлагает исходить из доступной памяти на вызов и допустимого времени выполнения. Конкретные пределы команда определяет для своей нагрузки и среды.
Для будущих изменений полезно сохранять вместе с хешем распознаваемые алгоритм и параметры либо версию схемы. Это редакционная проектная рекомендация, а не требование RFC. Она позволяет определить, соответствует ли запись текущей политике.
Сосуществование старых и новых парольных хешей
При смене алгоритма или параметров старые записи могут оставаться в базе. Приложению нужно различать форматы. В pgcrypto результат функций crypt() содержит тип алгоритма, поэтому хеши разных алгоритмов могут сосуществовать. Это свойство конкретных функций, а не общий формат Argon2.
Документация pgcrypto также отмечает адаптивность некоторых поддерживаемых парольных алгоритмов: их вычислительную стоимость можно увеличивать без несовместимости с существующими паролями. Источник не устанавливает способ обновления записей.
Редакционный вариант миграции: после успешной проверки старого хеша создать новый из уже введённого пароля и заменить запись только после успешного сохранения. При ошибке старая запись остаётся действующей. Для неактивной учётной записи исходного пароля нет, поэтому потребуется дождаться входа либо направить пользователя по маршруту смены пароля.
Проверять продвижение миграции можно по числу записей каждого формата. Порог завершения, срок поддержки старого формата и порядок обработки неактивных записей нужно закрепить как отдельное проектное решение.
Восстанавливаемые секреты: возможности шифрования и опасность низкоуровневых функций
API-ключ, который приложение должно использовать в исходном виде, нельзя заменить одним хешем. pgcrypto предоставляет PGP-функции для симметричного и открыто-ключевого шифрования, но наличие функции не решает вопросы доступа, резервирования и смены ключей.
Документация PostgreSQL предупреждает, что низкоуровневые raw-функции pgcrypto не проверяют изменение данных и оставляют пользователю управление параметрами, включая IV. Поэтому их применение в pgcrypto не рекомендуется.
Для синтетического примера выберем прикладное шифрование: база хранит шифротекст и идентификатор версии, а ключевой материал находится в отдельном хранилище секретов, доступном только компоненту расшифрования. Это редакционная схема для адаптации, а не универсальное требование.
При выборе хранилища проверьте четыре критерия: разграничение доступа, журналирование операций, резервное восстановление и возможность одновременно держать текущую и прежнюю версии ключа.
Маршрут смены ключа тоже нужно выбрать явно.
Пакетный вариант обрабатывает записи отдельной задачей; ленивый — при очередном обращении к секрету; комбинированный совмещает оба подхода. В редакционном примере новая версия записывается только после успешного расшифрования старой записи, проверки целостности и повторного шифрования. Ошибка оставляет прежний шифротекст без изменений и попадает в список повторной обработки.
Прежний ключ можно выводить из рабочего контура только по заранее установленному проектному условию: записей его версии не осталось, контрольная выборка расшифровывается новым ключом, а резервное восстановление проверено на синтетическом секрете. Конкретное хранилище, права и сроки команда выбирает по своей инфраструктуре и модели угроз.
Генерация токенов и сравнение секретных значений
Токен сессии или восстановления доступа должен создаваться криптографически стойким генератором. В Python для этого предназначен модуль secrets; обычный генератор random рассчитан на моделирование, а не на задачи безопасности и криптографии. В другой среде нужен соответствующий стойкий источник платформы.
Для сравнения секретных строк Python предоставляет compare_digest со сравнением за постоянное время. Документация указывает, что такой способ снижает риск атак по времени, но он закрывает только один риск и не заменяет защиту всего маршрута проверки.
Редакционный чек-лист для адаптации: разделить проверяемые и восстанавливаемые секреты; проверить одностороннее хранение паролей и уникальные соли; измерить параметры Argon2; предусмотреть версию схемы и миграцию старых хешей; отделить ключи шифрования от данных; выбрать способ смены ключа; проверить целостность, обработку ошибок и резервное восстановление; подтвердить источник случайности и способ сравнения.