SecureCompatibleEncryptionExamples

安全兼容的加密示例

该存储库的创建是为了解决围绕Internet浮动的较差的加密代码示例数量不断增长。该存储库会随着时间的推移而扩展，以包括更多语言的示例。

截至2021年4月，在5个不同平台上有18种不同的兼容示例，用于15种不同的语言。

算法

• 加密：AES-128-GCM
• 键推导：PBKDF2
• pbkdf2底于哈希：SHA-256

由于Java无限强度政策，因此选择了具有128位密钥的AE，由于密码出口法而需要不超过128位的关键尺寸。虽然使用AES-128显示了示例，但可以通过更改algorithm_key_size（以及某些情况，algorithm_name）参数来琐碎地更改为256位AE。

兼容性

此处显示的每个示例均兼容在平台和/或语言之间。任何语言的加密条件的结果都可以通过任何语言解密。请不要提交拉动请求以获取与现有示例不兼容的示例。

方法

每个示例都以大约等同于以下签名的签名公开4种方法：

• 字符串EncryptString（明文：字符串，密码：字符串）
• 字符串decryptstring（ciphertext：字符串，密码：字符串）
• byte []加密（明文：byte []，键：字节[]）
• byte []解密（ciphertext：byte []，键：字节[]）

正如预期的那样，加密和解密方法可在运行并返回原始二进制数据。但是， *字符串方法采用字符串参数并返回基本64编码字符串。首先通过PBKDF2馈送密码参数。密码可以有任何长度，但是密钥必须长度为128位。您可以通过调整algorithm_key_size参数来更改AES密钥大小，在某些示例中，也可以更改algorithm_name参数。

注意：由于使用PBKDF2，二进制与字符串方法不兼容。

依赖性

测试向量

以下密码是使用给定密码加密标准的结果。如果您的实现可以使用您编写的代码进行加密和解密，并且还可以将下文的密文源分解为相同的给定结果，则适用于此存储库中。回想一下，由于随机生成的盐和nonce，未预期的加密串输出，它们仅用于测试解密。

C示例

C示例需要更多的努力来理解和使用，因为相对于Base64填充的缓冲尺寸变化。下面的示例显示了如何使用crypt_string_get_length来确定需要分配哪个缓冲区以存储结果。

 #include \"SCEE.h\"
#include <stdio.h>

int main ( int argc , char * argv []) {

    // Our plaintext and password.
    unsigned char plaintext [] = \"Hello, World!\" ;
    unsigned char password [] = \"OddShapelyOak7332\" ;

    // Make enough space for our ciphertext.
    // Note that scee_crypt_string_get_length will give us the size of the buffer we
    // need INCLUDING the null character.
    size_t ct_length = scee_crypt_string_get_length ( strlen ( plaintext ), SCEE_CRYPT_ENCRYPT );
    unsigned char ciphertext [ ct_length ];

    // Encryption.
    // The operation places the null character at the end of the buffer for us.
    int r = scee_encrypt_string ( plaintext , strlen ( plaintext ), password , strlen ( password ), ciphertext );
    if ( r != SCEE_OK ) { return 1 ; }

    // Output for Encryption.
    printf ( \"Ciphertext Buffer Size: %zu\\n\" , ct_length );
    printf ( \"Ciphertext strlen     : %zu\\n\" , strlen ( ciphertext ));
    printf ( \"Ciphertext            : %s\\n\\n\" , ciphertext );

    // Make enough space for our plaintext again.
    // Note that because of base64 padding, scee_crypt_string_get_length will
    // usually tell us that we need more space than we do.  We can get the
    // actual length of the plaintext after we decrypt.
    size_t pt_max_length = scee_crypt_string_get_length ( strlen ( ciphertext ), SCEE_CRYPT_DECRYPT );
    size_t pt_actual_length ;
    unsigned char plaintext2 [ pt_max_length ];

    // Decryption.
    // The operation places the null character at the end of the buffer for us.
    r = scee_decrypt_string ( ciphertext , strlen ( ciphertext ), password , strlen ( password ), plaintext2 , & pt_actual_length );
    if ( r != SCEE_OK ) { return 1 ; }

    // Output for Decryption.
    printf ( \"Plaintext Buffer Size: %zu\\n\" , pt_max_length );
    printf ( \"Plaintext Actual Size: %zu\\n\" , pt_actual_length );
    printf ( \"Plaintext strlen     : %zu\\n\" , strlen ( plaintext ));
    printf ( \"Plaintext            : %s\\n\\n\" , plaintext );

    return 0 ;
}