OpenSSL 的 AES_ctr128_encrypt() 的参数详细信息

Question

我正在尝试了解 openSSL 加密库中以下函数的参数。

void AES_ctr128_encrypt(const unsigned char *in, unsigned char *out,
    size_t length, const AES_KEY *key,
    unsigned char ivec[AES_BLOCK_SIZE],
    unsigned char ecount_buf[AES_BLOCK_SIZE],
    unsigned int *num);

通过研究给出的建议 here 我能够弄清楚：

*in - is the buffer in.
*out - is the buffer out.
length - is the the length of the *in buffer.
*key - is the private key.
ivec[0-7] - is the random IV
ivec[8-15] - is the counter thats incremented for every block that's encrypted.

I am not certain about the ecount_buf and num parameters.

我看到 num 在调用 returns 后设置为 length % AES_BLOCK_SIZE。

Any pointers to what the ecount_buf parameter is for ?

Answer 1

如果您查看取自 here 的实现代码：

/* The input encrypted as though 128bit counter mode is being
 * used.  The extra state information to record how much of the
 * 128bit block we have used is contained in *num, and the
 * encrypted counter is kept in ecount_buf.  Both *num and
 * ecount_buf must be initialised with zeros before the first
 * call to AES_ctr128_encrypt().
 */
void AES_ctr128_encrypt(const unsigned char *in, unsigned char *out,
    const unsigned long length, const AES_KEY *key,
    unsigned char counter[AES_BLOCK_SIZE],
    unsigned char ecount_buf[AES_BLOCK_SIZE],
    unsigned int *num) {

    unsigned int n;
    unsigned long l=length;

    assert(in && out && key && counter && num);
    assert(*num < AES_BLOCK_SIZE);

    n = *num;

    while (l--) {
        if (n == 0) {
            AES_encrypt(counter, ecount_buf, key);
            AES_ctr128_inc(counter);
        }
        *(out++) = *(in++) ^ ecount_buf[n];
        n = (n+1) % AES_BLOCK_SIZE;
    }

    *num=n;
}

你可以推断它是一个中间缓冲区，用于保存 encrypted counter。 num 以总块大小中使用的字节数的形式保存状态信息（以防我们可能为了链接额外数据而进行的后续调用）。

OpenSSL 的 AES_ctr128_encrypt() 的参数详细信息

Parameter details of OpenSSL's AES_ctr128_encrypt()

c

encryption

openssl

aes

libcrypto