crypto/ffc/ffc_params.c

   1 /*
   2  * Copyright 2019-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 #include <string.h> /* memset */
  11 #include <openssl/core_names.h>
  12 #include "internal/ffc.h"
  13 #include "internal/param_build_set.h"
  14 #include "internal/nelem.h"
  15 #include "internal/e_os.h" /* strcasecmp */
  16
  17 #ifndef FIPS_MODULE
  18 # include <openssl/asn1.h> /* ossl_ffc_params_print */
  19 #endif
  20
  21 void ossl_ffc_params_init(FFC_PARAMS *params)
  22 {
  23     memset(params, 0, sizeof(*params));
  24     params->pcounter = -1;
  25     params->gindex = FFC_UNVERIFIABLE_GINDEX;
  26     params->flags = FFC_PARAM_FLAG_VALIDATE_PQG;
  27 }
  28
  29 void ossl_ffc_params_cleanup(FFC_PARAMS *params)
  30 {
  31     BN_free(params->p);
  32     BN_free(params->q);
  33     BN_free(params->g);
  34     BN_free(params->j);
  35     OPENSSL_free(params->seed);
  36     ossl_ffc_params_init(params);
  37 }
  38
  39 void ossl_ffc_params_set0_pqg(FFC_PARAMS *d, BIGNUM *p, BIGNUM *q, BIGNUM *g)
  40 {
  41     if (p != NULL && p != d->p) {
  42         BN_free(d->p);
  43         d->p = p;
  44     }
  45     if (q != NULL && q != d->q) {
  46         BN_free(d->q);
  47         d->q = q;
  48     }
  49     if (g != NULL && g != d->g) {
  50         BN_free(d->g);
  51         d->g = g;
  52     }
  53 }
  54
  55 void ossl_ffc_params_get0_pqg(const FFC_PARAMS *d, const BIGNUM **p,
  56                               const BIGNUM **q, const BIGNUM **g)
  57 {
  58     if (p != NULL)
  59         *p = d->p;
  60     if (q != NULL)
  61         *q = d->q;
  62     if (g != NULL)
  63         *g = d->g;
  64 }
  65
  66
  67 /* j is the 'cofactor' that is optionally output for ASN1. */
  68 void ossl_ffc_params_set0_j(FFC_PARAMS *d, BIGNUM *j)
  69 {
  70     BN_free(d->j);
  71     d->j = NULL;
  72     if (j != NULL)
  73         d->j = j;
  74 }
  75
  76 int ossl_ffc_params_set_seed(FFC_PARAMS *params,
  77                              const unsigned char *seed, size_t seedlen)
  78 {
  79     if (params == NULL)
  80         return 0;
  81
  82     if (params->seed != NULL) {
  83         if (params->seed == seed)
  84             return 1;
  85         OPENSSL_free(params->seed);
  86     }
  87
  88     if (seed != NULL && seedlen > 0) {
  89         params->seed = OPENSSL_memdup(seed, seedlen);
  90         if (params->seed == NULL)
  91             return 0;
  92         params->seedlen = seedlen;
  93     } else {
  94         params->seed = NULL;
  95         params->seedlen = 0;
  96     }
  97     return 1;
  98 }
  99
 100 void ossl_ffc_params_set_gindex(FFC_PARAMS *params, int index)
 101 {
 102     params->gindex = index;
 103 }
 104
 105 void ossl_ffc_params_set_pcounter(FFC_PARAMS *params, int index)
 106 {
 107     params->pcounter = index;
 108 }
 109
 110 void ossl_ffc_params_set_h(FFC_PARAMS *params, int index)
 111 {
 112     params->h = index;
 113 }
 114
 115 void ossl_ffc_params_set_flags(FFC_PARAMS *params, unsigned int flags)
 116 {
 117     params->flags = flags;
 118 }
 119
 120 void ossl_ffc_params_enable_flags(FFC_PARAMS *params, unsigned int flags,
 121                                   int enable)
 122 {
 123     if (enable)
 124         params->flags |= flags;
 125     else
 126         params->flags &= ~flags;
 127 }
 128
 129 int ossl_ffc_set_digest(FFC_PARAMS *params, const char *alg, const char *props)
 130 {
 131     params->mdname = alg;
 132     params->mdprops = props;
 133     return 1;
 134 }
 135
 136 int ossl_ffc_params_set_validate_params(FFC_PARAMS *params,
 137                                         const unsigned char *seed,
 138                                         size_t seedlen, int counter)
 139 {
 140     if (!ossl_ffc_params_set_seed(params, seed, seedlen))
 141         return 0;
 142     params->pcounter = counter;
 143     return 1;
 144 }
 145
 146 void ossl_ffc_params_get_validate_params(const FFC_PARAMS *params,
 147                                          unsigned char **seed, size_t *seedlen,
 148                                          int *pcounter)
 149 {
 150     if (seed != NULL)
 151         *seed = params->seed;
 152     if (seedlen != NULL)
 153         *seedlen = params->seedlen;
 154     if (pcounter != NULL)
 155         *pcounter = params->pcounter;
 156 }
 157
 158 static int ffc_bn_cpy(BIGNUM **dst, const BIGNUM *src)
 159 {
 160     BIGNUM *a;
 161
 162     /*
 163      * If source is read only just copy the pointer, so
 164      * we don't have to reallocate it.
 165      */
 166     if (src == NULL)
 167         a = NULL;
 168     else if (BN_get_flags(src, BN_FLG_STATIC_DATA)
 169              && !BN_get_flags(src, BN_FLG_MALLOCED))
 170         a = (BIGNUM *)src;
 171     else if ((a = BN_dup(src)) == NULL)
 172         return 0;
 173     BN_clear_free(*dst);
 174     *dst = a;
 175     return 1;
 176 }
 177
 178 int ossl_ffc_params_copy(FFC_PARAMS *dst, const FFC_PARAMS *src)
 179 {
 180     if (!ffc_bn_cpy(&dst->p, src->p)
 181         || !ffc_bn_cpy(&dst->g, src->g)
 182         || !ffc_bn_cpy(&dst->q, src->q)
 183         || !ffc_bn_cpy(&dst->j, src->j))
 184         return 0;
 185
 186     OPENSSL_free(dst->seed);
 187     dst->seedlen = src->seedlen;
 188     if (src->seed != NULL) {
 189         dst->seed = OPENSSL_memdup(src->seed, src->seedlen);
 190         if  (dst->seed == NULL)
 191             return 0;
 192     } else {
 193         dst->seed = NULL;
 194     }
 195     dst->nid = src->nid;
 196     dst->pcounter = src->pcounter;
 197     dst->h = src->h;
 198     dst->gindex = src->gindex;
 199     dst->flags = src->flags;
 200     return 1;
 201 }
 202
 203 int ossl_ffc_params_cmp(const FFC_PARAMS *a, const FFC_PARAMS *b, int ignore_q)
 204 {
 205     return BN_cmp(a->p, b->p) == 0
 206            && BN_cmp(a->g, b->g) == 0
 207            && (ignore_q || BN_cmp(a->q, b->q) == 0); /* Note: q may be NULL */
 208 }
 209
 210 int ossl_ffc_params_todata(const FFC_PARAMS *ffc, OSSL_PARAM_BLD *bld,
 211                       OSSL_PARAM params[])
 212 {
 213     int test_flags;
 214
 215     if (ffc == NULL)
 216         return 0;
 217
 218     if (ffc->p != NULL
 219         && !ossl_param_build_set_bn(bld, params, OSSL_PKEY_PARAM_FFC_P, ffc->p))
 220         return 0;
 221     if (ffc->q != NULL
 222         && !ossl_param_build_set_bn(bld, params, OSSL_PKEY_PARAM_FFC_Q, ffc->q))
 223         return 0;
 224     if (ffc->g != NULL
 225         && !ossl_param_build_set_bn(bld, params, OSSL_PKEY_PARAM_FFC_G, ffc->g))
 226         return 0;
 227     if (ffc->j != NULL
 228         && !ossl_param_build_set_bn(bld, params, OSSL_PKEY_PARAM_FFC_COFACTOR,
 229                                     ffc->j))
 230         return 0;
 231     if (!ossl_param_build_set_int(bld, params, OSSL_PKEY_PARAM_FFC_GINDEX,
 232                                   ffc->gindex))
 233         return 0;
 234     if (!ossl_param_build_set_int(bld, params, OSSL_PKEY_PARAM_FFC_PCOUNTER,
 235                                   ffc->pcounter))
 236         return 0;
 237     if (!ossl_param_build_set_int(bld, params, OSSL_PKEY_PARAM_FFC_H, ffc->h))
 238         return 0;
 239     if (ffc->seed != NULL
 240         && !ossl_param_build_set_octet_string(bld, params,
 241                                               OSSL_PKEY_PARAM_FFC_SEED,
 242                                               ffc->seed, ffc->seedlen))
 243         return 0;
 244     if (ffc->nid != NID_undef) {
 245         const DH_NAMED_GROUP *group = ossl_ffc_uid_to_dh_named_group(ffc->nid);
 246         const char *name = ossl_ffc_named_group_get_name(group);
 247
 248         if (name == NULL
 249             || !ossl_param_build_set_utf8_string(bld, params,
 250                                                  OSSL_PKEY_PARAM_GROUP_NAME,
 251                                                  name))
 252             return 0;
 253     }
 254     test_flags = ((ffc->flags & FFC_PARAM_FLAG_VALIDATE_PQ) != 0);
 255     if (!ossl_param_build_set_int(bld, params,
 256                                   OSSL_PKEY_PARAM_FFC_VALIDATE_PQ, test_flags))
 257         return 0;
 258     test_flags = ((ffc->flags & FFC_PARAM_FLAG_VALIDATE_G) != 0);
 259     if (!ossl_param_build_set_int(bld, params,
 260                                   OSSL_PKEY_PARAM_FFC_VALIDATE_G, test_flags))
 261         return 0;
 262     test_flags = ((ffc->flags & FFC_PARAM_FLAG_VALIDATE_LEGACY) != 0);
 263     if (!ossl_param_build_set_int(bld, params,
 264                                   OSSL_PKEY_PARAM_FFC_VALIDATE_LEGACY,
 265                                   test_flags))
 266         return 0;
 267
 268     if (ffc->mdname != NULL
 269         && !ossl_param_build_set_utf8_string(bld, params,
 270                                              OSSL_PKEY_PARAM_FFC_DIGEST,
 271                                              ffc->mdname))
 272        return 0;
 273     if (ffc->mdprops != NULL
 274         && !ossl_param_build_set_utf8_string(bld, params,
 275                                              OSSL_PKEY_PARAM_FFC_DIGEST_PROPS,
 276                                              ffc->mdprops))
 277         return 0;
 278     return 1;
 279 }
 280
 281 #ifndef FIPS_MODULE
 282 int ossl_ffc_params_print(BIO *bp, const FFC_PARAMS *ffc, int indent)
 283 {
 284     if (!ASN1_bn_print(bp, "prime P:", ffc->p, NULL, indent))
 285         goto err;
 286     if (!ASN1_bn_print(bp, "generator G:", ffc->g, NULL, indent))
 287         goto err;
 288     if (ffc->q != NULL
 289         && !ASN1_bn_print(bp, "subgroup order Q:", ffc->q, NULL, indent))
 290         goto err;
 291     if (ffc->j != NULL
 292         && !ASN1_bn_print(bp, "subgroup factor:", ffc->j, NULL, indent))
 293         goto err;
 294     if (ffc->seed != NULL) {
 295         size_t i;
 296
 297         if (!BIO_indent(bp, indent, 128)
 298             || BIO_puts(bp, "seed:") <= 0)
 299             goto err;
 300         for (i = 0; i < ffc->seedlen; i++) {
 301             if ((i % 15) == 0) {
 302                 if (BIO_puts(bp, "\n") <= 0
 303                     || !BIO_indent(bp, indent + 4, 128))
 304                     goto err;
 305             }
 306             if (BIO_printf(bp, "%02x%s", ffc->seed[i],
 307                            ((i + 1) == ffc->seedlen) ? "" : ":") <= 0)
 308                 goto err;
 309         }
 310         if (BIO_write(bp, "\n", 1) <= 0)
 311             return 0;
 312     }
 313     if (ffc->pcounter != -1) {
 314         if (!BIO_indent(bp, indent, 128)
 315             || BIO_printf(bp, "counter: %d\n", ffc->pcounter) <= 0)
 316             goto err;
 317     }
 318     return 1;
 319 err:
 320     return 0;
 321 }
 322 #endif /* FIPS_MODULE */