Home | History | Annotate | Download | only in keystore-engine
      1 /* Copyright 2014 The Android Open Source Project
      2  *
      3  * Redistribution and use in source and binary forms, with or without
      4  * modification, are permitted provided that the following conditions
      5  * are met:
      6  * 1. Redistributions of source code must retain the above copyright
      7  *    notice, this list of conditions and the following disclaimer.
      8  * 2. Redistributions in binary form must reproduce the above copyright
      9  *    notice, this list of conditions and the following disclaimer in the
     10  *    documentation and/or other materials provided with the distribution.
     11  *
     12  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY
     13  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
     14  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
     15  * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY
     16  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
     17  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
     18  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
     19  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     20  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
     21  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
     22 
     23 #include <UniquePtr.h>
     24 
     25 #include <sys/socket.h>
     26 #include <stdarg.h>
     27 #include <string.h>
     28 #include <unistd.h>
     29 
     30 #include <openssl/bn.h>
     31 #include <openssl/ec.h>
     32 #include <openssl/ec_key.h>
     33 #include <openssl/ecdsa.h>
     34 #include <openssl/engine.h>
     35 #include <openssl/evp.h>
     36 #include <openssl/rsa.h>
     37 #include <openssl/x509.h>
     38 
     39 #include <binder/IServiceManager.h>
     40 #include <keystore/keystore.h>
     41 #include <keystore/IKeystoreService.h>
     42 
     43 using namespace android;
     44 
     45 namespace {
     46 
     47 extern const RSA_METHOD keystore_rsa_method;
     48 extern const ECDSA_METHOD keystore_ecdsa_method;
     49 
     50 /* key_id_dup is called when one of the RSA or EC_KEY objects is duplicated. */
     51 int key_id_dup(CRYPTO_EX_DATA* /* to */,
     52                const CRYPTO_EX_DATA* /* from */,
     53                void** from_d,
     54                int /* index */,
     55                long /* argl */,
     56                void* /* argp */) {
     57     char *key_id = reinterpret_cast<char *>(*from_d);
     58     if (key_id != NULL) {
     59         *from_d = strdup(key_id);
     60     }
     61     return 1;
     62 }
     63 
     64 /* key_id_free is called when one of the RSA, DSA or EC_KEY object is freed. */
     65 void key_id_free(void* /* parent */,
     66                  void* ptr,
     67                  CRYPTO_EX_DATA* /* ad */,
     68                  int /* index */,
     69                  long /* argl */,
     70                  void* /* argp */) {
     71     char *key_id = reinterpret_cast<char *>(ptr);
     72     free(key_id);
     73 }
     74 
     75 /* KeystoreEngine is a BoringSSL ENGINE that implements RSA and ECDSA by
     76  * forwarding the requested operations to Keystore. */
     77 class KeystoreEngine {
     78  public:
     79   KeystoreEngine()
     80       : rsa_index_(RSA_get_ex_new_index(0 /* argl */,
     81                                         NULL /* argp */,
     82                                         NULL /* new_func */,
     83                                         key_id_dup,
     84                                         key_id_free)),
     85         ec_key_index_(EC_KEY_get_ex_new_index(0 /* argl */,
     86                                               NULL /* argp */,
     87                                               NULL /* new_func */,
     88                                               key_id_dup,
     89                                               key_id_free)),
     90         engine_(ENGINE_new()) {
     91     ENGINE_set_RSA_method(
     92         engine_, &keystore_rsa_method, sizeof(keystore_rsa_method));
     93     ENGINE_set_ECDSA_method(
     94         engine_, &keystore_ecdsa_method, sizeof(keystore_ecdsa_method));
     95   }
     96 
     97   int rsa_ex_index() const { return rsa_index_; }
     98   int ec_key_ex_index() const { return ec_key_index_; }
     99 
    100   const ENGINE* engine() const { return engine_; }
    101 
    102  private:
    103   const int rsa_index_;
    104   const int ec_key_index_;
    105   ENGINE* const engine_;
    106 };
    107 
    108 pthread_once_t g_keystore_engine_once = PTHREAD_ONCE_INIT;
    109 KeystoreEngine *g_keystore_engine;
    110 
    111 /* init_keystore_engine is called to initialize |g_keystore_engine|. This
    112  * should only be called by |pthread_once|. */
    113 void init_keystore_engine() {
    114     g_keystore_engine = new KeystoreEngine;
    115 }
    116 
    117 /* ensure_keystore_engine ensures that |g_keystore_engine| is pointing to a
    118  * valid |KeystoreEngine| object and creates one if not. */
    119 void ensure_keystore_engine() {
    120     pthread_once(&g_keystore_engine_once, init_keystore_engine);
    121 }
    122 
    123 /* Many OpenSSL APIs take ownership of an argument on success but don't free
    124  * the argument on failure. This means we need to tell our scoped pointers when
    125  * we've transferred ownership, without triggering a warning by not using the
    126  * result of release(). */
    127 #define OWNERSHIP_TRANSFERRED(obj) \
    128     typeof (obj.release()) _dummy __attribute__((unused)) = obj.release()
    129 
    130 const char* rsa_get_key_id(const RSA* rsa) {
    131   return reinterpret_cast<char*>(
    132       RSA_get_ex_data(rsa, g_keystore_engine->rsa_ex_index()));
    133 }
    134 
    135 /* rsa_private_transform takes a big-endian integer from |in|, calculates the
    136  * d'th power of it, modulo the RSA modulus, and writes the result as a
    137  * big-endian integer to |out|. Both |in| and |out| are |len| bytes long. It
    138  * returns one on success and zero otherwise. */
    139 int rsa_private_transform(RSA *rsa, uint8_t *out, const uint8_t *in, size_t len) {
    140     ALOGV("rsa_private_transform(%p, %p, %p, %u)", rsa, out, in, (unsigned) len);
    141 
    142     const char *key_id = rsa_get_key_id(rsa);
    143     if (key_id == NULL) {
    144         ALOGE("key had no key_id!");
    145         return 0;
    146     }
    147 
    148     sp<IServiceManager> sm = defaultServiceManager();
    149     sp<IBinder> binder = sm->getService(String16("android.security.keystore"));
    150     sp<IKeystoreService> service = interface_cast<IKeystoreService>(binder);
    151 
    152     if (service == NULL) {
    153         ALOGE("could not contact keystore");
    154         return 0;
    155     }
    156 
    157     uint8_t* reply = NULL;
    158     size_t reply_len;
    159     int32_t ret = service->sign(String16(key_id), in, len, &reply, &reply_len);
    160     if (ret < 0) {
    161         ALOGW("There was an error during rsa_decrypt: could not connect");
    162         return 0;
    163     } else if (ret != 0) {
    164         ALOGW("Error during sign from keystore: %d", ret);
    165         return 0;
    166     } else if (reply_len == 0) {
    167         ALOGW("No valid signature returned");
    168         free(reply);
    169         return 0;
    170     }
    171 
    172     if (reply_len > len) {
    173         /* The result of the RSA operation can never be larger than the size of
    174          * the modulus so we assume that the result has extra zeros on the
    175          * left. This provides attackers with an oracle, but there's nothing
    176          * that we can do about it here. */
    177         memcpy(out, reply + reply_len - len, len);
    178     } else if (reply_len < len) {
    179         /* If the Keystore implementation returns a short value we assume that
    180          * it's because it removed leading zeros from the left side. This is
    181          * bad because it provides attackers with an oracle but we cannot do
    182          * anything about a broken Keystore implementation here. */
    183         memset(out, 0, len);
    184         memcpy(out + len - reply_len, reply, reply_len);
    185     } else {
    186         memcpy(out, reply, len);
    187     }
    188 
    189     free(reply);
    190 
    191     ALOGV("rsa=%p keystore_rsa_priv_dec successful", rsa);
    192     return 1;
    193 }
    194 
    195 const struct rsa_meth_st keystore_rsa_method = {
    196   {
    197     0 /* references */,
    198     1 /* is_static */,
    199   },
    200   NULL /* app_data */,
    201 
    202   NULL /* init */,
    203   NULL /* finish */,
    204 
    205   NULL /* size */,
    206 
    207   NULL /* sign */,
    208   NULL /* verify */,
    209 
    210   NULL /* encrypt */,
    211   NULL /* sign_raw */,
    212   NULL /* decrypt */,
    213   NULL /* verify_raw */,
    214 
    215   rsa_private_transform,
    216 
    217   NULL /* mod_exp */,
    218   NULL /* bn_mod_exp */,
    219 
    220   RSA_FLAG_CACHE_PUBLIC | RSA_FLAG_OPAQUE | RSA_FLAG_EXT_PKEY,
    221 
    222   NULL /* keygen */,
    223   NULL /* multi_prime_keygen */,
    224   NULL /* supports_digest */,
    225 };
    226 
    227 const char* ecdsa_get_key_id(const EC_KEY* ec_key) {
    228     return reinterpret_cast<char*>(
    229         EC_KEY_get_ex_data(ec_key, g_keystore_engine->ec_key_ex_index()));
    230 }
    231 
    232 /* ecdsa_sign signs |digest_len| bytes from |digest| with |ec_key| and writes
    233  * the resulting signature (an ASN.1 encoded blob) to |sig|. It returns one on
    234  * success and zero otherwise. */
    235 static int ecdsa_sign(const uint8_t* digest, size_t digest_len, uint8_t* sig,
    236                       unsigned int* sig_len, EC_KEY* ec_key) {
    237     ALOGV("ecdsa_sign(%p, %u, %p)", digest, (unsigned) digest_len, ec_key);
    238 
    239     const char *key_id = ecdsa_get_key_id(ec_key);
    240     if (key_id == NULL) {
    241         ALOGE("key had no key_id!");
    242         return 0;
    243     }
    244 
    245     sp<IServiceManager> sm = defaultServiceManager();
    246     sp<IBinder> binder = sm->getService(String16("android.security.keystore"));
    247     sp<IKeystoreService> service = interface_cast<IKeystoreService>(binder);
    248 
    249     if (service == NULL) {
    250         ALOGE("could not contact keystore");
    251         return 0;
    252     }
    253 
    254     size_t ecdsa_size = ECDSA_size(ec_key);
    255 
    256     uint8_t* reply = NULL;
    257     size_t reply_len;
    258     int32_t ret = service->sign(String16(reinterpret_cast<const char*>(key_id)),
    259                                 digest, digest_len, &reply, &reply_len);
    260     if (ret < 0) {
    261         ALOGW("There was an error during ecdsa_sign: could not connect");
    262         return 0;
    263     } else if (ret != 0) {
    264         ALOGW("Error during sign from keystore: %d", ret);
    265         return 0;
    266     } else if (reply_len == 0) {
    267         ALOGW("No valid signature returned");
    268         free(reply);
    269         return 0;
    270     } else if (reply_len > ecdsa_size) {
    271         ALOGW("Signature is too large");
    272         free(reply);
    273         return 0;
    274     }
    275 
    276     memcpy(sig, reply, reply_len);
    277     *sig_len = reply_len;
    278 
    279     ALOGV("ecdsa_sign(%p, %u, %p) => success", digest, (unsigned)digest_len,
    280           ec_key);
    281     return 1;
    282 }
    283 
    284 const ECDSA_METHOD keystore_ecdsa_method = {
    285     {
    286      0 /* references */,
    287      1 /* is_static */
    288     } /* common */,
    289     NULL /* app_data */,
    290 
    291     NULL /* init */,
    292     NULL /* finish */,
    293     NULL /* group_order_size */,
    294     ecdsa_sign,
    295     NULL /* verify */,
    296     ECDSA_FLAG_OPAQUE,
    297 };
    298 
    299 struct EVP_PKEY_Delete {
    300     void operator()(EVP_PKEY* p) const {
    301         EVP_PKEY_free(p);
    302     }
    303 };
    304 typedef UniquePtr<EVP_PKEY, EVP_PKEY_Delete> Unique_EVP_PKEY;
    305 
    306 struct RSA_Delete {
    307     void operator()(RSA* p) const {
    308         RSA_free(p);
    309     }
    310 };
    311 typedef UniquePtr<RSA, RSA_Delete> Unique_RSA;
    312 
    313 struct EC_KEY_Delete {
    314     void operator()(EC_KEY* ec) const {
    315         EC_KEY_free(ec);
    316     }
    317 };
    318 typedef UniquePtr<EC_KEY, EC_KEY_Delete> Unique_EC_KEY;
    319 
    320 /* wrap_rsa returns an |EVP_PKEY| that contains an RSA key where the public
    321  * part is taken from |public_rsa| and the private operations are forwarded to
    322  * KeyStore and operate on the key named |key_id|. */
    323 static EVP_PKEY *wrap_rsa(const char *key_id, const RSA *public_rsa) {
    324     Unique_RSA rsa(RSA_new_method(g_keystore_engine->engine()));
    325     if (rsa.get() == NULL) {
    326         return NULL;
    327     }
    328 
    329     char *key_id_copy = strdup(key_id);
    330     if (key_id_copy == NULL) {
    331         return NULL;
    332     }
    333 
    334     if (!RSA_set_ex_data(rsa.get(), g_keystore_engine->rsa_ex_index(),
    335                          key_id_copy)) {
    336         free(key_id_copy);
    337         return NULL;
    338     }
    339 
    340     rsa->n = BN_dup(public_rsa->n);
    341     rsa->e = BN_dup(public_rsa->e);
    342     if (rsa->n == NULL || rsa->e == NULL) {
    343         return NULL;
    344     }
    345 
    346     Unique_EVP_PKEY result(EVP_PKEY_new());
    347     if (result.get() == NULL ||
    348         !EVP_PKEY_assign_RSA(result.get(), rsa.get())) {
    349         return NULL;
    350     }
    351     OWNERSHIP_TRANSFERRED(rsa);
    352 
    353     return result.release();
    354 }
    355 
    356 /* wrap_ecdsa returns an |EVP_PKEY| that contains an ECDSA key where the public
    357  * part is taken from |public_rsa| and the private operations are forwarded to
    358  * KeyStore and operate on the key named |key_id|. */
    359 static EVP_PKEY *wrap_ecdsa(const char *key_id, const EC_KEY *public_ecdsa) {
    360     Unique_EC_KEY ec(EC_KEY_new_method(g_keystore_engine->engine()));
    361     if (ec.get() == NULL) {
    362         return NULL;
    363     }
    364 
    365     if (!EC_KEY_set_group(ec.get(), EC_KEY_get0_group(public_ecdsa)) ||
    366         !EC_KEY_set_public_key(ec.get(), EC_KEY_get0_public_key(public_ecdsa))) {
    367         return NULL;
    368     }
    369 
    370     char *key_id_copy = strdup(key_id);
    371     if (key_id_copy == NULL) {
    372         return NULL;
    373     }
    374 
    375     if (!EC_KEY_set_ex_data(ec.get(), g_keystore_engine->ec_key_ex_index(),
    376                             key_id_copy)) {
    377         free(key_id_copy);
    378         return NULL;
    379     }
    380 
    381     Unique_EVP_PKEY result(EVP_PKEY_new());
    382     if (result.get() == NULL ||
    383         !EVP_PKEY_assign_EC_KEY(result.get(), ec.get())) {
    384         return NULL;
    385     }
    386     OWNERSHIP_TRANSFERRED(ec);
    387 
    388     return result.release();
    389 }
    390 
    391 }  /* anonymous namespace */
    392 
    393 extern "C" {
    394 
    395 EVP_PKEY* EVP_PKEY_from_keystore(const char* key_id) __attribute__((visibility("default")));
    396 
    397 /* EVP_PKEY_from_keystore returns an |EVP_PKEY| that contains either an RSA or
    398  * ECDSA key where the public part of the key reflects the value of the key
    399  * named |key_id| in Keystore and the private operations are forwarded onto
    400  * KeyStore. */
    401 EVP_PKEY* EVP_PKEY_from_keystore(const char* key_id) {
    402     ALOGV("EVP_PKEY_from_keystore(\"%s\")", key_id);
    403 
    404     sp<IServiceManager> sm = defaultServiceManager();
    405     sp<IBinder> binder = sm->getService(String16("android.security.keystore"));
    406     sp<IKeystoreService> service = interface_cast<IKeystoreService>(binder);
    407 
    408     if (service == NULL) {
    409         ALOGE("could not contact keystore");
    410         return 0;
    411     }
    412 
    413     uint8_t *pubkey = NULL;
    414     size_t pubkey_len;
    415     int32_t ret = service->get_pubkey(String16(key_id), &pubkey, &pubkey_len);
    416     if (ret < 0) {
    417         ALOGW("could not contact keystore");
    418         return NULL;
    419     } else if (ret != 0) {
    420         ALOGW("keystore reports error: %d", ret);
    421         return NULL;
    422     }
    423 
    424     const uint8_t *inp = pubkey;
    425     Unique_EVP_PKEY pkey(d2i_PUBKEY(NULL, &inp, pubkey_len));
    426     free(pubkey);
    427     if (pkey.get() == NULL) {
    428         ALOGW("Cannot convert pubkey");
    429         return NULL;
    430     }
    431 
    432     ensure_keystore_engine();
    433 
    434     EVP_PKEY *result;
    435     switch (EVP_PKEY_type(pkey->type)) {
    436     case EVP_PKEY_RSA: {
    437         Unique_RSA public_rsa(EVP_PKEY_get1_RSA(pkey.get()));
    438         result = wrap_rsa(key_id, public_rsa.get());
    439         break;
    440     }
    441     case EVP_PKEY_EC: {
    442         Unique_EC_KEY public_ecdsa(EVP_PKEY_get1_EC_KEY(pkey.get()));
    443         result = wrap_ecdsa(key_id, public_ecdsa.get());
    444         break;
    445     }
    446     default:
    447         ALOGE("Unsupported key type %d", EVP_PKEY_type(pkey->type));
    448         result = NULL;
    449     }
    450 
    451     return result;
    452 }
    453 
    454 }  // extern "C"
    455