1 /* 2 * Copyright 2012-2021 The OpenSSL Project Authors. All Rights Reserved. 3 * 4 * Licensed under the Apache License 2.0 (the "License"). You may not use 5 * this file except in compliance with the License. You can obtain a copy 6 * in the file LICENSE in the source distribution or at 7 * https://www.openssl.org/source/license.html 8 */ 9 10 /* 11 * Simple AES GCM authenticated encryption with additional data (AEAD) 12 * demonstration program. 13 */ 14 15 #include <stdio.h> 16 #include <openssl/err.h> 17 #include <openssl/bio.h> 18 #include <openssl/evp.h> 19 #include <openssl/core_names.h> 20 21 /* AES-GCM test data obtained from NIST public test vectors */ 22 23 /* AES key */ 24 static const unsigned char gcm_key[] = { 25 0xee, 0xbc, 0x1f, 0x57, 0x48, 0x7f, 0x51, 0x92, 0x1c, 0x04, 0x65, 0x66, 26 0x5f, 0x8a, 0xe6, 0xd1, 0x65, 0x8b, 0xb2, 0x6d, 0xe6, 0xf8, 0xa0, 0x69, 27 0xa3, 0x52, 0x02, 0x93, 0xa5, 0x72, 0x07, 0x8f 28 }; 29 30 /* Unique initialisation vector */ 31 static const unsigned char gcm_iv[] = { 32 0x99, 0xaa, 0x3e, 0x68, 0xed, 0x81, 0x73, 0xa0, 0xee, 0xd0, 0x66, 0x84 33 }; 34 35 /* Example plaintext to encrypt */ 36 static const unsigned char gcm_pt[] = { 37 0xf5, 0x6e, 0x87, 0x05, 0x5b, 0xc3, 0x2d, 0x0e, 0xeb, 0x31, 0xb2, 0xea, 38 0xcc, 0x2b, 0xf2, 0xa5 39 }; 40 41 /* 42 * Example of Additional Authenticated Data (AAD), i.e. unencrypted data 43 * which can be authenticated using the generated Tag value. 44 */ 45 static const unsigned char gcm_aad[] = { 46 0x4d, 0x23, 0xc3, 0xce, 0xc3, 0x34, 0xb4, 0x9b, 0xdb, 0x37, 0x0c, 0x43, 47 0x7f, 0xec, 0x78, 0xde 48 }; 49 50 /* Expected ciphertext value */ 51 static const unsigned char gcm_ct[] = { 52 0xf7, 0x26, 0x44, 0x13, 0xa8, 0x4c, 0x0e, 0x7c, 0xd5, 0x36, 0x86, 0x7e, 53 0xb9, 0xf2, 0x17, 0x36 54 }; 55 56 /* Expected AEAD Tag value */ 57 static const unsigned char gcm_tag[] = { 58 0x67, 0xba, 0x05, 0x10, 0x26, 0x2a, 0xe4, 0x87, 0xd7, 0x37, 0xee, 0x62, 59 0x98, 0xf7, 0x7e, 0x0c 60 }; 61 62 /* 63 * A library context and property query can be used to select & filter 64 * algorithm implementations. If they are NULL then the default library 65 * context and properties are used. 66 */ 67 OSSL_LIB_CTX *libctx = NULL; 68 const char *propq = NULL; 69 70 int aes_gcm_encrypt(void) 71 { 72 int ret = 0; 73 EVP_CIPHER_CTX *ctx; 74 EVP_CIPHER *cipher = NULL; 75 int outlen, tmplen; 76 size_t gcm_ivlen = sizeof(gcm_iv); 77 unsigned char outbuf[1024]; 78 unsigned char outtag[16]; 79 OSSL_PARAM params[2] = { 80 OSSL_PARAM_END, OSSL_PARAM_END 81 }; 82 83 printf("AES GCM Encrypt:\n"); 84 printf("Plaintext:\n"); 85 BIO_dump_fp(stdout, gcm_pt, sizeof(gcm_pt)); 86 87 /* Create a context for the encrypt operation */ 88 if ((ctx = EVP_CIPHER_CTX_new()) == NULL) 89 goto err; 90 91 /* Fetch the cipher implementation */ 92 if ((cipher = EVP_CIPHER_fetch(libctx, "AES-256-GCM", propq)) == NULL) 93 goto err; 94 95 /* Set IV length if default 96 bits is not appropriate */ 96 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_AEAD_IVLEN, 97 &gcm_ivlen); 98 99 /* 100 * Initialise an encrypt operation with the cipher/mode, key, IV and 101 * IV length parameter. 102 * For demonstration purposes the IV is being set here. In a compliant 103 * application the IV would be generated internally so the iv passed in 104 * would be NULL. 105 */ 106 if (!EVP_EncryptInit_ex2(ctx, cipher, gcm_key, gcm_iv, params)) 107 goto err; 108 109 /* Zero or more calls to specify any AAD */ 110 if (!EVP_EncryptUpdate(ctx, NULL, &outlen, gcm_aad, sizeof(gcm_aad))) 111 goto err; 112 113 /* Encrypt plaintext */ 114 if (!EVP_EncryptUpdate(ctx, outbuf, &outlen, gcm_pt, sizeof(gcm_pt))) 115 goto err; 116 117 /* Output encrypted block */ 118 printf("Ciphertext:\n"); 119 BIO_dump_fp(stdout, outbuf, outlen); 120 121 /* Finalise: note get no output for GCM */ 122 if (!EVP_EncryptFinal_ex(ctx, outbuf, &tmplen)) 123 goto err; 124 125 /* Get tag */ 126 params[0] = OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_AEAD_TAG, 127 outtag, 16); 128 129 if (!EVP_CIPHER_CTX_get_params(ctx, params)) 130 goto err; 131 132 /* Output tag */ 133 printf("Tag:\n"); 134 BIO_dump_fp(stdout, outtag, 16); 135 136 ret = 1; 137 err: 138 if (!ret) 139 ERR_print_errors_fp(stderr); 140 141 EVP_CIPHER_free(cipher); 142 EVP_CIPHER_CTX_free(ctx); 143 144 return ret; 145 } 146 147 int aes_gcm_decrypt(void) 148 { 149 int ret = 0; 150 EVP_CIPHER_CTX *ctx; 151 EVP_CIPHER *cipher = NULL; 152 int outlen, rv; 153 size_t gcm_ivlen = sizeof(gcm_iv); 154 unsigned char outbuf[1024]; 155 OSSL_PARAM params[2] = { 156 OSSL_PARAM_END, OSSL_PARAM_END 157 }; 158 159 printf("AES GCM Decrypt:\n"); 160 printf("Ciphertext:\n"); 161 BIO_dump_fp(stdout, gcm_ct, sizeof(gcm_ct)); 162 163 if ((ctx = EVP_CIPHER_CTX_new()) == NULL) 164 goto err; 165 166 /* Fetch the cipher implementation */ 167 if ((cipher = EVP_CIPHER_fetch(libctx, "AES-256-GCM", propq)) == NULL) 168 goto err; 169 170 /* Set IV length if default 96 bits is not appropriate */ 171 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_AEAD_IVLEN, 172 &gcm_ivlen); 173 174 /* 175 * Initialise an encrypt operation with the cipher/mode, key, IV and 176 * IV length parameter. 177 */ 178 if (!EVP_DecryptInit_ex2(ctx, cipher, gcm_key, gcm_iv, params)) 179 goto err; 180 181 /* Zero or more calls to specify any AAD */ 182 if (!EVP_DecryptUpdate(ctx, NULL, &outlen, gcm_aad, sizeof(gcm_aad))) 183 goto err; 184 185 /* Decrypt plaintext */ 186 if (!EVP_DecryptUpdate(ctx, outbuf, &outlen, gcm_ct, sizeof(gcm_ct))) 187 goto err; 188 189 /* Output decrypted block */ 190 printf("Plaintext:\n"); 191 BIO_dump_fp(stdout, outbuf, outlen); 192 193 /* Set expected tag value. */ 194 params[0] = OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_AEAD_TAG, 195 (void*)gcm_tag, sizeof(gcm_tag)); 196 197 if (!EVP_CIPHER_CTX_set_params(ctx, params)) 198 goto err; 199 200 /* Finalise: note get no output for GCM */ 201 rv = EVP_DecryptFinal_ex(ctx, outbuf, &outlen); 202 /* 203 * Print out return value. If this is not successful authentication 204 * failed and plaintext is not trustworthy. 205 */ 206 printf("Tag Verify %s\n", rv > 0 ? "Successful!" : "Failed!"); 207 208 ret = 1; 209 err: 210 if (!ret) 211 ERR_print_errors_fp(stderr); 212 213 EVP_CIPHER_free(cipher); 214 EVP_CIPHER_CTX_free(ctx); 215 216 return ret; 217 } 218 219 int main(int argc, char **argv) 220 { 221 if (!aes_gcm_encrypt()) 222 return 1; 223 224 if (!aes_gcm_decrypt()) 225 return 1; 226 227 return 0; 228 } 229