openssl-enc
名称
openssl-enc – symmetric cipher routines
概要
openssl enc|cipher [-cipher] [-help] [-list] [-ciphers] [-in filename] [-out filename] [-pass arg] [-e] [-d] [-a] [-base64] [-A] [-k password] [-kfile filename] [-K key] [-iv IV] [-S salt] [-salt] [-nosalt] [-z] [-md digest] [-iter count] [-pbkdf2] [-p] [-P] [-bufsize number] [-nopad] [-v] [-debug] [-none] [-engine id] [-rand files] [-writerand file] [-provider name] [-provider-path path] [-propquery propq]
openssl cipher [...]
描述
对称加密命令允许使用基于密码或明确提供的密钥，使用各种块和流密码算法对数据进行加密或解密。在执行时可以使用 Base64 编码或解码，也可以在加密或解密操作之外执行。
选项
- -cipher
指定使用的算法，cipher替换为具体的算法名字
-
-help
Print out a usage message.
-
-list
列出所支持的算法
-
-ciphers
同-list
-
-in filename
如果未指定此选项，则标准输入读取数据。
-
-out filename
如果不指定，则写入标准输出
-
-pass arg
密码源
-
-e
加密输入的数据
-
-d
解密输入的数据
-
-a
Base64 对数据进行处理。这意味着如果正在进行加密，则数据在加密后将进行 Base64 编码。如果设置了解密，则输入数据在解密之前将进行 Base64 解码。
当未指定 -A 选项时，编码时每 64 个字符后会插入一个换行符，解码时输入的前 1024 个字节中应有一个换行符。
-
-base64
同-a
-
-A
If the -a option is set then base64 encoding produces output without any newline character, and base64 decoding does not require any newlines. Therefore it can be helpful to use the -A option when decoding unknown input.
如果设置了 -a 选项，则 base64 编码会产生不带任何换行符的输出，而 base64 解码也不需要任何换行符。在解码未知输入时使用 -A 选项。 -
-k password
直接指定密码，为了兼容旧版本，新版用-pass
-
-kfile filename
从文件中读取密码，新版用-pass
-
-md digest
从passphrase创建密钥所用的摘要算法，默认是sha-256
-
-iter count
在导出加密密钥时对密码使用给定的迭代次数。较高的值会增加暴力破解所需的时间。此选项允许使用 PBKDF2 算法来导出密钥。
-
-pbkdf2
使用 PBKDF2 算法，默认迭代次数为 10000，除非 -iter 命令行选项另有规定。
-
-saltlen
设置使用 -pbkdf2 选项时要使用的盐长度。出于兼容性原因，默认值为 8 字节。最大值目前为 16 字节。如果不使用 -pbkdf2 选项，则忽略此选项并使用固定盐长度 8。解密时也必须使用加密时使用的盐长度。
-
-nosalt
不要在密钥派生例程中使用盐。除了测试目的或与旧版本的 OpenSSL 兼容外，不应使用此选项。
-
-salt
Use salt (randomly generated or provide with -S option) when encrypting, this is the default.
加密的时候使用salt(随机生成或通过-S选项指定),这是默认选项 -
-S salt
实际使用的盐：必须以十六进制数字字符串表示。如果在加密时使用此选项，则解密时将再次需要相同的精确值。
-
-K key
实际使用的加密密钥：必须用仅包含十六进制数字的字符串表示。如果仅指定key，则必须使用 -iv 选项指定 IV。当同时指定key和password时，将使用 -K 选项给出的key，并采用从password生成的 IV。同时指定密钥和密码没有多大意义。
-
-iv IV
实际使用的 IV：必须将其表示为仅由十六进制数字组成的字符串。当仅使用 -K 选项指定密钥时，必须明确定义 IV。当使用其他选项之一指定密码时，IV 将从此密码生成。
-
-p
打印key和IV
-
-P
打印出使用的 key 和 IV，然后立即退出：不进行任何加密或解密。
-
-bufsize number
设置I/O缓存区大小
-
-nopad
禁用块填充
-
-v
Verbose打印；显示一些有关 I/O 和缓冲区大小的统计信息。
-
-debug
Debug the BIOs used for I/O.
-
-z
在加密后或解密前使用 zlib 压缩或解压缩加密数据。仅当使用 zlib 或 zlib-dynamic 选项编译 OpenSSL 时才存在此选项。
-
-none
使用NULL算法(不执行加密或解密)
-
-rand files, -writerand file
See “Random State Options” in openssl(1) for details.
-
-provider name
-
-provider-path path
-
-propquery propq
See “Provider Options” in openssl(1), provider(7), and property(7).
-
-engine id
See “Engine Options” in openssl(1). This option is deprecated.
注意
该程序可以通 openssl cipher or openssl enc –cipher 命令来调用(cipher是算法名称)。第一种形式不适用于引擎提供的密码，因为此形式在读取配置文件和加载任何 ENGINE 之前进行处理。使用 openssl-list(1) 命令获取受支持的密码列表。
应在配置文件中配置提供全新加密算法的引擎（例如提供 gost89 算法的 ccgost 引擎）。使用 -engine 选项在命令行上指定的引擎只能用于硬件辅助实现的密码，这些密码由 OpenSSL 核心或配置文件中指定的其他引擎支持。
当使用openssl enc -list列出受支持的密码时，配置文件中指定的引擎提供的密码也会列出。
如果需要，将提示输入密码以派生Key和 IV。
如果密钥是从密码派生的，则应始终使用 -salt 选项，除非您希望与以前版本的 OpenSSL 兼容。
如果没有 -salt 选项，则有可能对密码执行有效的字典攻击，并攻击流密码加密数据。原因是如果没有盐，相同的密码总是会生成相同的加密密钥。
当salt是随机生成时（没有使用 -S 选项给出明确盐），加密数据的第一个字节被保留以存储盐以供以后解密。
有些密码没有大密钥，而其他密码如果使用不当则会产生安全隐患。建议初学者在 CBC 模式下仅使用strong block cipher，例如 AES。
所有block ciphers通常都使用 PKCS#5 填充，也称为standard block填充。这允许执行基本的完整性或密码检查。但是，由于随机数据通过测试的概率大于 256 分之一，因此这不是一个很好的测试。
如果禁用填充，则输入数据必须是密码块长度的倍数。
所有 RC2 密码都具有相同的密钥和有效密钥长度。
Blowfish 和 RC5 算法使用 128 位密钥。
请注意，OpenSSL 3.0 改变了 -S 选项的效果。通过此选项指定的任何显式盐值在加密时不再添加到密文前面，并且在解密时必须再次显式提供。相反，当在解密期间使用 -S 选项时，密文预计不会有前面插入的盐值。
使用 OpenSSL 3.0 或更高版本解密在 OpenSSL 1.1.1 下使用显式盐加密的数据时，请勿使用 -S 选项，然后将从密文中读取盐。要生成可以使用 OpenSSL 1.1.1 解密的密文，请勿使用 -S 选项，然后会随机生成盐并将其添加到输出前面。
SUPPORTED CIPHERS
请注意，有些密码可以在编译时禁用，有些密码只有在配置文件中配置了适当的引擎后才可用。使用 -list 选项调用此命令（即 openssl enc -list）时的输出是您的 OpenSSL 版本支持的密码列表，包括通过配置的引擎提供的算法。
此命令不支持 CCM 和 GCM 等经过身份验证的加密模式，将来也不会支持此类模式。这是因为在验证身份验证标签之前必须开始流式输出（例如，当未使用 -out 时输出到标准输出）。当在管道中使用此命令时，接收端将无法在身份验证失败时回滚。当前常用的 AEAD 模式在重用 key/iv/nonce 时也会遭受机密性和/或完整性的灾难性故障，并且由于 openssl enc 将 key/iv/nonce 管理的全部负担都放在用户身上，因此暴露 AEAD 模式的风险太大而无法允许。这些 key/iv/nonce 管理问题也会影响此命令中当前暴露的其他模式，但在这些情况下故障模式不那么严重，并且无法通过稳定的发布分支删除该功能。对于批量数据加密，无论是使用经过身份验证的加密模式还是其他模式，都建议使用 openssl-cms(1)，因为它提供了标准数据格式并执行所需的 key/iv/nonce 管理。
When enc is used with key wrapping modes the input data cannot be streamed, meaning it must be processed in a single pass. Consequently, the input data size must be less than the buffer size (-bufsize arg, default to 81024 bytes). The ‘-wrap’ ciphers require the input to be a multiple of 8 bytes long, because no padding is involved. The ‘*-wrap-pad’ ciphers allow any input length. In both cases, no IV is needed. See example below.
当 enc 与 key wrapping 模式一起使用时，输入数据无法流式传输，这意味着必须一次性处理。因此，输入数据大小必须小于缓冲区大小（-bufsize 参数，默认为 81024 字节）。’-wrap’ 密码要求输入长度为 8 字节的倍数，因为不涉及填充。’*-wrap-pad’ 密码允许任意长度的输入。在这两种情况下，都不需要 IV。请参见下面的示例。
base64 Base 64
bf-cbc Blowfish in CBC mode
bf Alias for bf-cbc
blowfish Alias for bf-cbc
bf-cfb Blowfish in CFB mode
bf-ecb Blowfish in ECB mode
bf-ofb Blowfish in OFB mode
cast-cbc CAST in CBC mode
cast Alias for cast-cbc
cast5-cbc CAST5 in CBC mode
cast5-cfb CAST5 in CFB mode
cast5-ecb CAST5 in ECB mode
cast5-ofb CAST5 in OFB mode
chacha20 ChaCha20 algorithm
des-cbc DES in CBC mode
des Alias for des-cbc
des-cfb DES in CFB mode
des-ofb DES in OFB mode
des-ecb DES in ECB mode
des-ede-cbc Two key triple DES EDE in CBC mode
des-ede Two key triple DES EDE in ECB mode
des-ede-cfb Two key triple DES EDE in CFB mode
des-ede-ofb Two key triple DES EDE in OFB mode
des-ede3-cbc Three key triple DES EDE in CBC mode
des-ede3 Three key triple DES EDE in ECB mode
des3 Alias for des-ede3-cbc
des-ede3-cfb Three key triple DES EDE CFB mode
des-ede3-ofb Three key triple DES EDE in OFB mode
desx DESX algorithm.
gost89 GOST 28147-89 in CFB mode (provided by ccgost engine)
gost89-cnt GOST 28147-89 in CNT mode (provided by ccgost engine)
idea-cbc IDEA algorithm in CBC mode
idea same as idea-cbc
idea-cfb IDEA in CFB mode
idea-ecb IDEA in ECB mode
idea-ofb IDEA in OFB mode
rc2-cbc 128 bit RC2 in CBC mode
rc2 Alias for rc2-cbc
rc2-cfb 128 bit RC2 in CFB mode
rc2-ecb 128 bit RC2 in ECB mode
rc2-ofb 128 bit RC2 in OFB mode
rc2-64-cbc 64 bit RC2 in CBC mode
rc2-40-cbc 40 bit RC2 in CBC mode
rc4 128 bit RC4
rc4-64 64 bit RC4
rc4-40 40 bit RC4
rc5-cbc RC5 cipher in CBC mode
rc5 Alias for rc5-cbc
rc5-cfb RC5 cipher in CFB mode
rc5-ecb RC5 cipher in ECB mode
rc5-ofb RC5 cipher in OFB mode
seed-cbc SEED cipher in CBC mode
seed Alias for seed-cbc
seed-cfb SEED cipher in CFB mode
seed-ecb SEED cipher in ECB mode
seed-ofb SEED cipher in OFB mode
sm4-cbc SM4 cipher in CBC mode
sm4 Alias for sm4-cbc
sm4-cfb SM4 cipher in CFB mode
sm4-ctr SM4 cipher in CTR mode
sm4-ecb SM4 cipher in ECB mode
sm4-ofb SM4 cipher in OFB mode
aes-[128|192|256]-cbc 128/192/256 bit AES in CBC mode
aes[128|192|256] Alias for aes-[128|192|256]-cbc
aes-[128|192|256]-cfb 128/192/256 bit AES in 128 bit CFB mode
aes-[128|192|256]-cfb1 128/192/256 bit AES in 1 bit CFB mode
aes-[128|192|256]-cfb8 128/192/256 bit AES in 8 bit CFB mode
aes-[128|192|256]-ctr 128/192/256 bit AES in CTR mode
aes-[128|192|256]-ecb 128/192/256 bit AES in ECB mode
aes-[128|192|256]-ofb 128/192/256 bit AES in OFB mode
aes-[128|192|256]-wrap key wrapping using 128/192/256 bit AES
aes-[128|192|256]-wrap-pad key wrapping with padding using 128/192/256 bit AES
aria-[128|192|256]-cbc 128/192/256 bit ARIA in CBC mode
aria[128|192|256] Alias for aria-[128|192|256]-cbc
aria-[128|192|256]-cfb 128/192/256 bit ARIA in 128 bit CFB mode
aria-[128|192|256]-cfb1 128/192/256 bit ARIA in 1 bit CFB mode
aria-[128|192|256]-cfb8 128/192/256 bit ARIA in 8 bit CFB mode
aria-[128|192|256]-ctr 128/192/256 bit ARIA in CTR mode
aria-[128|192|256]-ecb 128/192/256 bit ARIA in ECB mode
aria-[128|192|256]-ofb 128/192/256 bit ARIA in OFB mode
camellia-[128|192|256]-cbc 128/192/256 bit Camellia in CBC mode
camellia[128|192|256] Alias for camellia-[128|192|256]-cbc
camellia-[128|192|256]-cfb 128/192/256 bit Camellia in 128 bit CFB mode
camellia-[128|192|256]-cfb1 128/192/256 bit Camellia in 1 bit CFB mode
camellia-[128|192|256]-cfb8 128/192/256 bit Camellia in 8 bit CFB mode
camellia-[128|192|256]-ctr 128/192/256 bit Camellia in CTR mode
camellia-[128|192|256]-ecb 128/192/256 bit Camellia in ECB mode
camellia-[128|192|256]-ofb 128/192/256 bit Camellia in OFB mode
示例
Just base64 encode a binary file:
openssl base64 -in file.bin -out file.b64
Decode the same file
openssl base64 -d -in file.b64 -out file.bin
Encrypt a file using AES-128 using a prompted password and PBKDF2 key derivation:
openssl enc -aes128 -pbkdf2 -in file.txt -out file.aes128
Decrypt a file using a supplied password:
openssl enc -aes128 -pbkdf2 -d -in file.aes128 -out file.txt -pass pass:<password>
Encrypt a file then base64 encode it (so it can be sent via mail for example) using AES-256 in CTR mode and PBKDF2 key derivation:
openssl enc -aes-256-ctr -pbkdf2 -a -in file.txt -out file.aes256
Base64 decode a file then decrypt it using a password supplied in a file:
openssl enc -aes-256-ctr -pbkdf2 -d -a -in file.aes256 -out file.txt -pass file:<passfile>
AES key wrapping:
openssl enc -e -a -id-aes128-wrap-pad -K 000102030405060708090A0B0C0D0E0F -in file.bin
or
openssl aes128-wrap-pad -e -a -K 000102030405060708090A0B0C0D0E0F -in file.bin
Bugs
-A 选项在处理大文件时无法正常工作。另一方面，在不使用 -A 选项的情况下进行 base64 解码时，如果输入的前 1024 个字节不包含换行符，则前两行输入将被忽略。
openssl enc 命令仅支持具有特定参数的固定数量的算法。因此，例如，如果您想使用带有 76 位密钥的 RC2 或带有 84 位密钥的 RC4，则无法使用此程序。
历史
The default digest was changed from MD5 to SHA256 in OpenSSL 1.1.0.
The -list option was added in OpenSSL 1.1.1e.
The -ciphers and -engine options were deprecated in OpenSSL 3.0.
The -saltlen option was added in OpenSSL 3.2.
Views: 0