test/sqlcipher-pragmas.test

   1 # SQLCipher
   2 # codec.test developed by Stephen Lombardo (Zetetic LLC)
   3 # sjlombardo at zetetic dot net
   4 # http://zetetic.net
   5 #
   6 # Copyright (c) 2018, ZETETIC LLC
   7 # Redistribution and use in source and binary forms, with or without
   8 # modification, are permitted provided that the following conditions are met:
   9 #     * Redistributions of source code must retain the above copyright
  10 #       notice, this list of conditions and the following disclaimer.
  11 #     * Redistributions in binary form must reproduce the above copyright
  12 #       notice, this list of conditions and the following disclaimer in the
  13 #       documentation and/or other materials provided with the distribution.
  14 #     * Neither the name of the ZETETIC LLC nor the
  15 #       names of its contributors may be used to endorse or promote products
  16 #       derived from this software without specific prior written permission.
  17 #
  18 # THIS SOFTWARE IS PROVIDED BY ZETETIC LLC ''AS IS'' AND ANY
  19 # EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  20 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  21 # DISCLAIMED. IN NO EVENT SHALL ZETETIC LLC BE LIABLE FOR ANY
  22 # DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  23 # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  24 # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  25 # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  27 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28 #
  29 # This file implements regression tests for SQLite library.  The
  30 # focus of this script is testing code cipher features.
  31 #
  32 # NOTE: tester.tcl has overridden the definition of sqlite3 to
  33 # automatically pass in a key value. Thus tests in this file
  34 # should explicitly close and open db with sqlite_orig in order
  35 # to bypass default key assignment.
  36
  37 set testdir [file dirname $argv0]
  38 source $testdir/tester.tcl
  39 source $testdir/sqlcipher.tcl
  40
  41 # verify the pragma cipher_version
  42 # returns the currently configured
  43 # sqlcipher version
  44 do_test verify-pragma-cipher-version {
  45     sqlite_orig db test.db
  46     execsql {
  47         PRAGMA cipher_version;
  48     }
  49 } {{4.3.0 community}}
  50 db close
  51 file delete -force test.db
  52
  53 # verify the pragma cipher_use_hmac
  54 # is set to true be default
  55 do_test verify-pragma-cipher-use-hmac-default {
  56     sqlite_orig db test.db
  57     execsql {
  58         PRAGMA key = 'test';
  59         PRAGMA cipher_use_hmac;
  60     }
  61 } {ok 1}
  62 db close
  63 file delete -force test.db
  64
  65 # verify the pragma cipher_use_hmac
  66 # reports the flag turned off
  67 do_test verify-pragma-cipher-use-hmac-off {
  68     sqlite_orig db test.db
  69     execsql {
  70         PRAGMA key = 'test';
  71         PRAGMA cipher_use_hmac = off;
  72         PRAGMA cipher_use_hmac;
  73     }
  74 } {ok 0}
  75 db close
  76 file delete -force test.db
  77
  78 # verify the pragma default_cipher_use_hmac
  79 # is set to true by default
  80 do_test verify-pragma-cipher-default-use-hmac-default {
  81     sqlite_orig db test.db
  82     execsql {
  83         PRAGMA cipher_default_use_hmac;
  84     }
  85 } {1}
  86 db close
  87 file delete -force test.db
  88
  89 # verify the pragma default_cipher_use_hmac
  90 # reports the flag turned off
  91 do_test verify-pragma-cipher-default-use-hmac-off {
  92     sqlite_orig db test.db
  93     execsql {
  94         PRAGMA cipher_default_use_hmac = off;
  95         PRAGMA cipher_default_use_hmac;
  96         -- Be sure to turn cipher_default_use_hmac
  97         -- back on or it will break later tests
  98         -- (it's a global flag)
  99         PRAGMA cipher_default_use_hmac = ON;
 100     }
 101 } {0}
 102 db close
 103 file delete -force test.db
 104
 105 # verify the pragma default_cipher_kdf_iter
 106 # is set to 256000 by default
 107 do_test verify-pragma-cipher-default-kdf-iter-default {
 108     sqlite_orig db test.db
 109     execsql {
 110         PRAGMA cipher_default_kdf_iter;
 111     }
 112 } {256000}
 113 db close
 114 file delete -force test.db
 115
 116
 117 # verify the pragma default_cipher_kdf_ter
 118 # reports changes
 119 do_test verify-pragma-cipher-default-use-hmac-off {
 120     sqlite_orig db test.db
 121     execsql {
 122         PRAGMA cipher_default_kdf_iter = 1000;
 123         PRAGMA cipher_default_kdf_iter;
 124         PRAGMA cipher_default_kdf_iter = 256000;
 125     }
 126 } {1000}
 127 db close
 128 file delete -force test.db
 129
 130 # verify the pragma kdf_iter
 131 # reports the default value
 132 do_test verify-pragma-kdf-iter-reports-default {
 133     sqlite_orig db test.db
 134     execsql {
 135         PRAGMA key = 'test';
 136         PRAGMA kdf_iter;
 137     }
 138 } {ok 256000}
 139 db close
 140 file delete -force test.db
 141
 142 # verify the pragma kdf_iter
 143 # reports value changed
 144 do_test verify-pragma-kdf-iter-reports-value-changed {
 145     sqlite_orig db test.db
 146     execsql {
 147         PRAGMA key = 'test';
 148         PRAGMA kdf_iter = 8000;
 149         PRAGMA kdf_iter;
 150     }
 151  } {ok 8000}
 152 db close
 153 file delete -force test.db
 154
 155 # verify the pragma fast_kdf_iter
 156 # reports the default value
 157 do_test verify-pragma-fast-kdf-iter-reports-default {
 158     sqlite_orig db test.db
 159     execsql {
 160         PRAGMA key = 'test';
 161         PRAGMA fast_kdf_iter;
 162     }
 163 } {ok 2}
 164 db close
 165 file delete -force test.db
 166
 167 # verify the pragma fast_kdf_iter
 168 # reports value changed
 169 do_test verify-pragma-kdf-iter-reports-value-changed {
 170     sqlite_orig db test.db
 171     execsql {
 172         PRAGMA key = 'test';
 173         PRAGMA fast_kdf_iter = 4000;
 174         PRAGMA fast_kdf_iter;
 175     }
 176 } {ok {PRAGMA fast_kdf_iter is deprecated, please remove from use} 4000}
 177 db close
 178 file delete -force test.db
 179
 180 # verify the pragma cipher_page_size
 181 # reports default value
 182 do_test verify-pragma-cipher-page-size-default {
 183     sqlite_orig db test.db
 184     execsql {
 185         PRAGMA key = 'test';
 186         PRAGMA cipher_page_size;
 187     }
 188 } {ok 4096}
 189 db close
 190 file delete -force test.db
 191
 192 # verify the pragma cipher_page_size
 193 # reports change in value
 194 do_test verify-pragma-cipher-page-size-changed {
 195     sqlite_orig db test.db
 196     execsql {
 197         PRAGMA key = 'test';
 198         PRAGMA cipher_page_size = 8192;
 199         PRAGMA cipher_page_size;
 200     }
 201 } {ok 8192}
 202 db close
 203 file delete -force test.db
 204
 205 # verify setting cipher_store_pass before key
 206 # does not cause segfault
 207 do_test verify-cipher-store-pass-before-key-does-not-segfault {
 208     sqlite_orig db test.db
 209     execsql {
 210         PRAGMA cipher_store_pass = 1;
 211         PRAGMA key = 'test';
 212     }
 213 } {ok}
 214 db close
 215 file delete -force test.db
 216
 217 # verify the pragma cipher
 218 # reports the default value
 219 if_built_with_openssl verify-pragma-cipher-default {
 220     sqlite_orig db test.db
 221     execsql {
 222         PRAGMA key = 'test';
 223         PRAGMA cipher;
 224     }
 225 } {ok AES-256-CBC}
 226 db close
 227 file delete -force test.db
 228
 229 # verify the pragma cipher_hmac_salt_mask reports default
 230 do_test verify-pragma-hmac-salt-mask-reports-default {
 231     sqlite_orig db test.db
 232     execsql {
 233         PRAGMA key = 'test';
 234         PRAGMA cipher_hmac_salt_mask;
 235     }
 236 } {ok 3a}
 237 db close
 238 file delete -force test.db
 239
 240 # verify the pragma cipher_hmac_salt_mask reports
 241 # reports value changed
 242 do_test verify-pragma-hmac-salt-mask-reports-value-changed {
 243     sqlite_orig db test.db
 244     execsql {
 245         PRAGMA key = 'test';
 246         PRAGMA cipher_hmac_salt_mask = "x'11'";
 247         PRAGMA cipher_hmac_salt_mask;
 248         PRAGMA cipher_hmac_salt_mask = "x'3a'";
 249     }
 250 } {ok {PRAGMA cipher_hmac_salt_mask is deprecated, please remove from use} 11 {PRAGMA cipher_hmac_salt_mask is deprecated, please remove from use}}
 251 db close
 252 file delete -force test.db
 253
 254 # verify the pragma cipher_hmac_pgno reports default
 255 do_test verify-pragma-hmac-pgno-reports-default {
 256     sqlite_orig db test.db
 257     execsql {
 258         PRAGMA key = 'test';
 259         PRAGMA cipher_hmac_pgno;
 260     }
 261 } {ok le}
 262 db close
 263 file delete -force test.db
 264
 265 # verify the pragma cipher_hmac_pgno
 266 # reports value changed
 267 do_test verify-pragma-hmac-pgno-reports-value-changed {
 268     sqlite_orig db test.db
 269     execsql {
 270         PRAGMA key = 'test';
 271         PRAGMA cipher_hmac_pgno = be;
 272         PRAGMA cipher_hmac_pgno;
 273         PRAGMA cipher_hmac_pgno = native;
 274         PRAGMA cipher_hmac_pgno;
 275         PRAGMA cipher_hmac_pgno = le;
 276         PRAGMA cipher_hmac_pgno;
 277     }
 278 } {ok {PRAGMA cipher_hmac_pgno is deprecated, please remove from use} be {PRAGMA cipher_hmac_pgno is deprecated, please remove from use} native {PRAGMA cipher_hmac_pgno is deprecated, please remove from use} le}
 279 db close
 280 file delete -force test.db
 281
 282 # verify the pragma cipher_hmac_algorithm works properly
 283 do_test verify-pragma-cipher-hmac-algorithm-reports-default {
 284     sqlite_orig db test.db
 285     execsql {
 286         PRAGMA key = 'test';
 287         PRAGMA cipher_hmac_algorithm;
 288     }
 289 } {ok HMAC_SHA512}
 290 db close
 291 file delete -force test.db
 292
 293 do_test verify-pragma-cipher-hmac-algorithm-reports-value-changed {
 294     sqlite_orig db test.db
 295     execsql {
 296         PRAGMA key = 'test';
 297         PRAGMA cipher_hmac_algorithm = HMAC_SHA1;
 298         PRAGMA cipher_hmac_algorithm;
 299     }
 300 } {ok HMAC_SHA1}
 301 db close
 302 file delete -force test.db
 303
 304 do_test verify-pragma-cipher-default-hmac-algorithm {
 305     sqlite_orig db test.db
 306     execsql {
 307         PRAGMA cipher_default_hmac_algorithm;
 308         PRAGMA cipher_default_hmac_algorithm = HMAC_SHA1;
 309         PRAGMA cipher_default_hmac_algorithm;
 310         PRAGMA cipher_default_hmac_algorithm = HMAC_SHA512;
 311     }
 312 } {HMAC_SHA512 HMAC_SHA1}
 313 db close
 314 file delete -force test.db
 315
 316 # verify the pragma cipher_kdf_algorithm works properly
 317 do_test verify-pragma-cipher-kdf-algorithm-reports-default {
 318     sqlite_orig db test.db
 319     execsql {
 320         PRAGMA key = 'test';
 321         PRAGMA cipher_kdf_algorithm;
 322     }
 323 } {ok PBKDF2_HMAC_SHA512}
 324 db close
 325 file delete -force test.db
 326
 327 do_test verify-pragma-cipher-kdf-algorithm-reports-value-changed {
 328     sqlite_orig db test.db
 329     execsql {
 330         PRAGMA key = 'test';
 331         PRAGMA cipher_kdf_algorithm = PBKDF2_HMAC_SHA1;
 332         PRAGMA cipher_kdf_algorithm;
 333     }
 334 } {ok PBKDF2_HMAC_SHA1}
 335 db close
 336 file delete -force test.db
 337
 338 do_test verify-pragma-cipher-default-kdf-algorithm {
 339     sqlite_orig db test.db
 340     execsql {
 341         PRAGMA cipher_default_kdf_algorithm;
 342         PRAGMA cipher_default_kdf_algorithm = PBKDF2_HMAC_SHA1;
 343         PRAGMA cipher_default_kdf_algorithm;
 344         PRAGMA cipher_default_kdf_algorithm = PBKDF2_HMAC_SHA512;
 345     }
 346 } {PBKDF2_HMAC_SHA512 PBKDF2_HMAC_SHA1}
 347 db close
 348 file delete -force test.db
 349
 350 if_built_with_openssl verify-default-cipher {
 351     sqlite_orig db test.db
 352     execsql {
 353         PRAGMA key='test';
 354         PRAGMA cipher;
 355     }
 356 } {ok AES-256-CBC}
 357 db close
 358 file delete -force test.db
 359
 360 if_built_with_libtomcrypt verify-default-cipher {
 361     sqlite_orig db test.db
 362     execsql {
 363         PRAGMA key='test';
 364         PRAGMA cipher;
 365     }
 366 } {ok aes-256-cbc}
 367 db close
 368 file delete -force test.db
 369
 370 if_built_with_commoncrypto verify-default-cipher {
 371     sqlite_orig db test.db
 372     execsql {
 373         PRAGMA key='test';
 374         PRAGMA cipher;
 375     }
 376 } {ok aes-256-cbc}
 377 db close
 378 file delete -force test.db
 379
 380 if_built_with_nss verify-default-cipher {
 381     sqlite_orig db test.db
 382     execsql {
 383         PRAGMA key='test';
 384         PRAGMA cipher;
 385     }
 386 } {ok aes-256-cbc}
 387 db close
 388 file delete -force test.db
 389
 390 do_test verify-cipher_settings_default {
 391     sqlite_orig db test.db
 392     execsql {
 393         PRAGMA key = 'test';
 394         PRAGMA cipher_settings;
 395     }
 396 } {ok {PRAGMA kdf_iter = 256000;} {PRAGMA cipher_page_size = 4096;} {PRAGMA cipher_use_hmac = 1;} {PRAGMA cipher_plaintext_header_size = 0;} {PRAGMA cipher_hmac_algorithm = HMAC_SHA512;} {PRAGMA cipher_kdf_algorithm = PBKDF2_HMAC_SHA512;}}
 397 db close
 398 file delete -force test.db
 399
 400 do_test verify-cipher_settings_v1 {
 401     sqlite_orig db test.db
 402     execsql {
 403         PRAGMA key = 'test';
 404         PRAGMA cipher_compatibility = 1;
 405         PRAGMA cipher_settings;
 406     }
 407 } {ok {PRAGMA kdf_iter = 4000;} {PRAGMA cipher_page_size = 1024;} {PRAGMA cipher_use_hmac = 0;} {PRAGMA cipher_plaintext_header_size = 0;} {PRAGMA cipher_hmac_algorithm = HMAC_SHA1;} {PRAGMA cipher_kdf_algorithm = PBKDF2_HMAC_SHA1;}}
 408 db close
 409 file delete -force test.db
 410
 411 do_test verify-cipher_default_settings_v1 {
 412     sqlite_orig db test.db
 413     execsql {
 414         PRAGMA cipher_default_compatibility = 1;
 415         PRAGMA cipher_default_settings;
 416         PRAGMA cipher_default_compatibility = 4;
 417     }
 418 } {{PRAGMA cipher_default_kdf_iter = 4000;} {PRAGMA cipher_default_page_size = 1024;} {PRAGMA cipher_default_use_hmac = 0;} {PRAGMA cipher_default_plaintext_header_size = 0;} {PRAGMA cipher_default_hmac_algorithm = HMAC_SHA1;} {PRAGMA cipher_default_kdf_algorithm = PBKDF2_HMAC_SHA1;}}
 419 db close
 420 file delete -force test.db
 421
 422 do_test verify-cipher_default_settings_default {
 423     sqlite_orig db test.db
 424     execsql {
 425         PRAGMA cipher_default_settings;
 426     }
 427 } {{PRAGMA cipher_default_kdf_iter = 256000;} {PRAGMA cipher_default_page_size = 4096;} {PRAGMA cipher_default_use_hmac = 1;} {PRAGMA cipher_default_plaintext_header_size = 0;} {PRAGMA cipher_default_hmac_algorithm = HMAC_SHA512;} {PRAGMA cipher_default_kdf_algorithm = PBKDF2_HMAC_SHA512;}}
 428 db close
 429 file delete -force test.db
 430
 431
 432
 433 finish_test