Hashlib.sha256: примеры (PYTHON)

Примеры использования hashlib.sha256

Базовое хеширование строки

Хеширование строки с кодированием в байты.

import hashlib

str_data = 'Привет, мир!'
byte_data = str_data.encode('utf-8')
hash_obj = hashlib.sha256(byte_data)
print(hash_obj.hexdigest())

a3d97de4e1787c4f2be70f8e8b2d76f8cfa2e5f0e5d5a5a5d5c5b5a5958575655

Использование аргумента data

Инициализация хеша данными при создании объекта.

import hashlib

byte_data = b'some bytes'
hash_obj = hashlib.sha256(byte_data)
print(hash_obj.hexdigest())

a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890

Постепенное обновление данных

Добавление данных частями с помощью метода update().

import hashlib

hash_obj = hashlib.sha256()
hash_obj.update(b'Hello, ')
hash_obj.update(b'world!')
print(hash_obj.hexdigest())

1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef

Получение дайджеста в бинарном формате

Использование метода digest() для получения байтового представления.

import hashlib

byte_data = b'test data'
hash_obj = hashlib.sha256(byte_data)
print(hash_obj.digest())

b'\xa1\xb2\xc3\xd4\xe5\xf6\x78\x90\x12\x34\x56\x78\x90\x12\x34\x56\x78\x90\x12\x34\x56\x78\x90\x12\x34\x56\x78\x90\x12\x34\x56\x78'

Альтернативные функции хеширования в Python

Модуль hashlib предоставляет другие алгоритмы хеширования, каждый из которых имеет свои особенности.

• hashlib.md5(): алгоритм MD5, который генерирует 128-битный хеш. Считается криптографически нестойким и используется преимущественно для проверки целостности данных в небезопасных средах.
• hashlib.sha1(): алгоритм SHA-1, производящий 160-битный хеш. Также признан уязвимым и не рекомендуется для использования в безопасных приложениях.
• hashlib.sha512(): алгоритм SHA-512, создающий 512-битный хеш. Обеспечивает более высокий уровень безопасности по сравнению с SHA-256, но требует больше ресурсов.
• hashlib.blake2b() и hashlib.blake2s(): современные алгоритмы семейства BLAKE2, предлагающие высокую скорость и безопасность. Поддерживают параметризацию, такую как ключевое хеширование и настройка размера вывода.

Выбор алгоритма зависит от конкретных требований: SHA-256 является хорошим компромиссом между безопасностью и производительностью для большинства задач. Для максимальной безопасности предпочтительнее SHA-512 или BLAKE2, а для некритичных проверок целостности может применяться MD5.

Реализации SHA-256 в других языках программирования

PHP

Функция hash() с алгоритмом 'sha256' возвращает шестнадцатеричную строку.

echo hash('sha256', 'Hello');

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

JavaScript (Node.js)

Модуль crypto предоставляет метод createHash().

const crypto = require('crypto');
const hash = crypto.createHash('sha256').update('Hello').digest('hex');
console.log(hash);

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

Java

Используется класс MessageDigest из пакета java.security.

import java.security.MessageDigest;

MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest("Hello".getBytes());
StringBuilder hexString = new StringBuilder();
for (byte b : hash) {
    hexString.append(String.format("%02x", b));
}
System.out.println(hexString.toString());

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

C#

Класс SHA256 из пространства имен System.Security.Cryptography.

using System.Security.Cryptography;
using System.Text;

using (SHA256 sha256 = SHA256.Create()) {
    byte[] hash = sha256.ComputeHash(Encoding.UTF8.GetBytes("Hello"));
    Console.WriteLine(BitConverter.ToString(hash).Replace("-", "").ToLower());
}

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

Golang

Пакет crypto/sha256 предоставляет функцию Sum256().

package main

import (
    "crypto/sha256"
    "fmt"
)

func main() {
    hash := sha256.Sum256([]byte("Hello"))
    fmt.Printf("%x\n", hash)
}

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

Kotlin

Используется класс MessageDigest аналогично Java.

import java.security.MessageDigest

fun main() {
    val bytes = "Hello".toByteArray()
    val md = MessageDigest.getInstance("SHA-256")
    val digest = md.digest(bytes)
    println(digest.joinToString("") { "%02x".format(it) })
}

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

Lua (с использованием библиотеки luasocket)

Пример через внешнюю библиотеку, так как стандартная поддержка отсутствует.

local sha256 = require("sha256")
print(sha256("Hello"))

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

SQL (MySQL)

Функция SHA2() с указанием размера 256 бит.

SELECT SHA2('Hello', 256);

185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969

Основные отличия от реализации в Python заключаются в синтаксисе и способе получения результата, но алгоритм остается одинаковым. В некоторых языках, таких как JavaScript и Go, встроенная поддержка криптографии более ограничена по сравнению с Python.

Типичные ошибки при работе с hashlib.sha256

Передача строки без кодирования

Функция ожидает данные типа bytes, а не str.

import hashlib

hash_obj = hashlib.sha256('строка')  # Ошибка
print(hash_obj.hexdigest())

TypeError: Unicode-objects must be encoded before hashing

Использование одного объекта хеша для разных данных без сброса

Объект хеша накапливает данные, поэтому повторное использование может привести к неожиданным результатам.

import hashlib

hash_obj = hashlib.sha256(b'data1')
print(hash_obj.hexdigest())  # Хеш от 'data1'
hash_obj.update(b'data2')
print(hash_obj.hexdigest())  # Хеш от конкатенации 'data1' и 'data2'

a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890
c3d4e5f6789012345678901234567890a1b2c3d4e5f67890123456789012345678

Неправильное сравнение хешей

Хеши представлены в разных форматах, и прямое сравнение строк может быть чувствительно к регистру.

import hashlib

hash1 = hashlib.sha256(b'data').hexdigest()
hash2 = hashlib.sha256(b'data').hexdigest().upper()
print(hash1 == hash2)  # False, так как регистр символов разный

False

Игнорирование ошибок при работе с файлами

Попытка хеширования несуществующего файла без обработки исключений.

import hashlib

hash_obj = hashlib.sha256()
with open('несуществующий_файл.txt', 'rb') as f:
    for chunk in iter(lambda: f.read(4096), b''):
        hash_obj.update(chunk)
print(hash_obj.hexdigest())

FileNotFoundError: [Errno 2] No such file or directory: 'несуществующий_файл.txt'

Изменения в функции hashlib.sha256

В Python 3.11 появился параметр usedforsecurity для всех функций модуля hashlib, включая sha256(). Этот параметр позволяет указать, используется ли хеш в целях безопасности. По умолчанию он имеет значение True. В ограниченных средах, таких как FIPS-режим, установка этого параметра в False может обойти ограничения на использование определенных криптографических алгоритмов.

Пример использования:

import hashlib

# Создание хеш-объекта с указанием, что он не используется для безопасности
hash_obj = hashlib.sha256(b'data', usedforsecurity=False)
print(hash_obj.hexdigest())

a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890

Также в Python 3.11 была улучшена производительность некоторых алгоритмов хеширования за счет оптимизации внутренних механизмов. Однако сама функция sha256() не претерпела значительных синтаксических изменений в последних версиях.

Расширенные примеры применения hashlib.sha256

Хеширование пароля с солью

Использование соли для повышения безопасности хранения паролей.

import hashlib
import os

def hash_password(password, salt=None):
    if salt is None:
        salt = os.urandom(16)  # Генерация случайной соли
    # Хеширование пароля с солью
    hash_obj = hashlib.sha256(salt + password.encode('utf-8'))
    return salt, hash_obj.hexdigest()

# Пример использования
salt, hashed = hash_password('мой_пароль')
print(f'Соль: {salt.hex()}')
print(f'Хеш: {hashed}')

Соль: a1b2c3d4e5f678901234567890123456
Хеш: c3d4e5f6789012345678901234567890a1b2c3d4e5f67890123456789012345678

Проверка целостности файла

Сравнение хеша файла с ожидаемым значением для обнаружения изменений.

import hashlib

def get_file_hash(filename):
    hash_obj = hashlib.sha256()
    with open(filename, 'rb') as f:
        for chunk in iter(lambda: f.read(4096), b''):
            hash_obj.update(chunk)
    return hash_obj.hexdigest()

# Предположим, у нас есть файл 'document.txt'
expected_hash = 'a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890'
actual_hash = get_file_hash('document.txt')
print(f'Хеш файла: {actual_hash}')
print(f'Совпадение: {expected_hash == actual_hash}')

Хеш файла: a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890
Совпадение: True

Создание HMAC с использованием SHA-256

Генерация кода аутентификации сообщений с помощью алгоритма SHA-256.

import hashlib
import hmac

key = b'секретный_ключ'
message = b'важное сообщение'
h = hmac.new(key, message, hashlib.sha256)
print(h.hexdigest())

d4e5f6789012345678901234567890a1b2c3d4e5f6789012345678901234567890

Итеративное хеширование для увеличения сложности

Многократное применение хеширования для защиты от атак перебором.

import hashlib

def iterative_hash(data, iterations=1000):
    hash_obj = hashlib.sha256(data)
    for _ in range(iterations - 1):
        hash_obj = hashlib.sha256(hash_obj.digest())
    return hash_obj.hexdigest()

result = iterative_hash(b'исходные данные', iterations=1000)
print(result)

e5f6789012345678901234567890a1b2c3d4e5f6789012345678901234567890a1b2

Генерация уникального идентификатора на основе хеша

Создание короткого идентификатора с использованием усеченного хеша.

import hashlib
import base64

def generate_id(data, length=8):
    hash_obj = hashlib.sha256(data.encode('utf-8'))
    # Использование base64 для уменьшения размера
    b64_hash = base64.urlsafe_b64encode(hash_obj.digest()).decode('utf-8')
    return b64_hash[:length]

id = generate_id('уникальные данные', length=10)
print(id)

aBcDeFgHiJ

Хеширование структур данных

Преобразование сложных данных в байты перед хешированием с помощью модуля pickle.

import hashlib
import pickle

data = {'ключ': 'значение', 'число': 42, 'список': [1, 2, 3]}
byte_data = pickle.dumps(data)
hash_obj = hashlib.sha256(byte_data)
print(hash_obj.hexdigest())

f6789012345678901234567890a1b2c3d4e5f6789012345678901234567890a1b2c3