Модуль crypto

Общие сведения

«Crypto» is short for «Cryptography», which generally refers to the production of a digest value from a function (usually a Cryptographic hash function), applied against a string. Tarantool’s crypto module supports ten types of cryptographic hash functions (AES, DES, DSS, MD4, MD5, MDC2, RIPEMD, SHA-1, SHA-2). Some of the crypto functionality is also present in the Модуль digest module.

Указатель

Ниже приведен перечень всех функций модуля crypto.

crypto.cipher.{aes128|aes192|aes256|des}.{cbc|cfb|ecb|ofb}.encrypt(string, key, initialization_vector)¶

crypto.cipher.{aes128|aes192|aes256|des}.{cbc|cfb|ecb|ofb}.decrypt(string, key, initialization_vector)¶

Передача или возврат шифрованного сообщения, полученного из строки, ключа и (необязательно) вектора инициализации. Четыре алгоритма на выбор:

• aes128 - aes-128 (128-битные двоичные строки с использованием AES)
• aes192 - aes-192 (192-битные двоичные строки с использованием AES)
• aes256 - aes-256 (256-битные двоичные строки с использованием AES)
• des - des (56-битные двоичные строки с использованием DES, хотя использование DES не рекомендуется)

Также доступны четыре режима блочного шифрования на выбор:

• cbc - Сцепление блоков шифротекста
• cfb - Обратная связь по шифротексту
• ecb - Электронная кодовая книга
• ofb - Обратная связь по выходу

For more information, read the article about Encryption Modes

Пример:

_16byte_iv='1234567890123456'
_16byte_pass='1234567890123456'
e=crypto.cipher.aes128.cbc.encrypt('string', _16byte_pass, _16byte_iv)
crypto.cipher.aes128.cbc.decrypt(e,  _16byte_pass, _16byte_iv)

crypto.digest.{dss|dss1|md4|md5|mdc2|ripemd160}(string)¶

crypto.digest.{sha1|sha224|sha256|sha384|sha512}(string)¶

Передача или возврат дайджеста из строки. Выбор из одиннадцати алгоритмов:

• dss - dss (с использованием DSS)
• dss1 - dss (с использованием DSS-1)
• md4 - md4 (128-битные двоичные строки с использованием MD4)
• md5 - md5 (128-битные двоичные строки с использованием MD5)
• mdc2 - mdc2 (с использованием MDC2)
• ripemd160 - ripemd (160-битные двоичные строки с использованием RIPEMD-160)
• sha1 - sha-1 (160-битные двоичные строки с использованием SHA-1)
• sha224 - sha-224 (224-битные двоичные строки с использованием SHA-2)
• sha256 - sha-256 (256-битные двоичные строки с использованием SHA-2)
• sha384 - sha-384 (384-битные двоичные строки с использованием SHA-2)
• sha512 - sha-512(512-битные двоичные строки с использованием SHA-2).

Пример:

crypto.digest.md4('string')
crypto.digest.sha512('string')

crypto.hmac.{md4|md5|ripemd160}(key, string)¶

crypto.hmac.{sha1|sha224|sha256|sha384|sha512}(key, string)¶

Передача ключа и строки. Результатом будет код аутентификации сообщения HMAC. 8 алгоритмов на выбор:

• md4 или md4_hex - md4 (128-битные двоичные строки с использованием MD4)
• md5 или md5_hex - md5 (128-битные двоичные строки с использованием MD5)
• ripemd160 или ripemd160_hex - ripemd (160-битные двоичные строки с использованием RIPEMD-160)
• sha1 или sha1_hex - sha-1 (160-битные двоичные строки с использованием SHA-1)
• sha224 или sha224_hex - sha-224 (224-битные двоичные строки с использованием SHA-2)
• sha256 или sha256_hex - sha-256 (256-битные двоичные строки с использованием SHA-2)
• sha384 или sha384_hex - sha-384 (384-битные двоичные строки с использованием SHA-2)
• sha512 или sha512_hex - sha-512(512-битные двоичные строки с использованием SHA-2).

Пример:

crypto.hmac.md4('key', 'string')
crypto.hmac.md4_hex('key', 'string')

Инкрементальные методы в модуле crypto

Предположим, что вычислен дайджест для строки „A“, затем часть „B“ добавляется в строку, необходим новый дайджест. Новый дайджест можно пересчитать для всей строки „AB“, но быстрее будет взять вычисленный дайджест для „A“ и внести изменения на основании добавленной части „B“. Это называется многошаговым процессом или «инкрементным» хеш-суммированием, которое поддерживает Tarantool поддерживает для всех криптографических функций.

crypto = require('crypto')

-- вывести дайджест 'AB' по aes-192 пошагово, затем с инкрементом
key = 'key/key/key/key/key/key/'
iv =  'iviviviviviviviv'
print(crypto.cipher.aes192.cbc.encrypt('AB', key, iv))
c = crypto.cipher.aes192.cbc.encrypt.new(key)
c:init(nil, iv)
c:update('A')
c:update('B')
print(c:result())
c:free()

-- вывести дайджест 'AB' по sha-256 пошагово, затем с инкрементом
print(crypto.digest.sha256('AB'))
c = crypto.digest.sha256.new()
c:init()
c:update('A')
c:update('B')
print(c:result())
c:free()

Получение одинаковых результатов из модулей digest и crypto

Следующие функции равноценны. Например, функция digest и функция crypto приведут к одному результату.

crypto.cipher.aes256.cbc.encrypt('x',b32,b16)==digest.aes256cbc.encrypt('x',b32,b16)
crypto.digest.md4('string') == digest.md4('string')
crypto.digest.md5('string') == digest.md5('string')
crypto.digest.sha1('string') == digest.sha1('string')
crypto.digest.sha224('string') == digest.sha224('string')
crypto.digest.sha256('string') == digest.sha256('string')
crypto.digest.sha384('string') == digest.sha384('string')
crypto.digest.sha512('string') == digest.sha512('string')