openssl
Clés

Syntaxe

• EVP_PKEY * EVP_PKEY_new (void);
• RSA * RSA_new (void);
• int RSA_generate_key_ex (RSA * rsa, bits int, BIGNUM * e, BN_GENCB * cb);
• int EVP_PKEY_assign_RSA (clé EVP_PKEY *, clé RSA *);
• int PEM_write_PrivateKey (FILE * fp, EVP_PKEY * x, const EVP_CIPHER * enc, unsigned char * kstr, int klen, pem_password_cb * cb, void * u);
• int PEM_write_bio_PrivateKey (BIO * bp, EVP_PKEY * x, const EVP_CIPHER * enc, unsigned char * kstr, int klen, pem_password_cb * cb, void * u);
• EVP_PKEY * PEM_read_PrivateKey (FILE * fp, EVP_PKEY ** x, pem_password_cb * cb, void * u);
• EVP_PKEY * PEM_read_bio_PrivateKey (BIO * bp, EVP_PKEY ** x, pem_password_cb * cb, void * u);
• annuler EVP_PKEY_free (clé EVP_PKEY *);

Générer une clé RSA

Pour générer une clé RSA, un EVP_PKEY doit d'abord être alloué avec EVP_PKEY_new :

EVP_PKEY *pkey;
pkey = EVP_PKEY_new();

Un exposant pour la clé est également nécessaire, ce qui nécessitera d'allouer un BIGNUM avec BN_new puis d'affecter avec BN_set_word :

BIGNUM *bn;
bn = BN_new();
BN_set_word(bn, RSA_F4);

Pour générer la clé, créez un nouveau RSA avec RSA_new et appelez RSA_generate_key_ex :

RSA *rsa;
rsa = RSA_new();
RSA_generate_key_ex(
    rsa,  /* pointer to the RSA structure */
    2048, /* number of bits for the key - 2048 is a good value */
    bn,   /* exponent allocated earlier */
    NULL, /* callback - can be NULL if progress isn't needed */
);

Pour affecter la clé nouvellement générée à la structure EVP_PKEY , appelez EVP_PKEY_assign_RSA :

EVP_PKEY_assign_RSA(pkey, rsa);

La structure RSA sera automatiquement libérée lorsque la structure EVP_PKEY sera libérée. Ceci est fait avec EVP_PKEY_free :

EVP_PKEY_free(pkey);

Enregistrer la clé privée

Un EVP_PKEY peut être enregistré directement sur le disque dans plusieurs formats. PEM_write_PrivateKey est utilisé pour enregistrer EVP_PKEY dans un format PEM:

FILE *f;
f = fopen("key.pem", "wb");
PEM_write_PrivateKey(
    f,                  /* use the FILE* that was opened */
    pkey,               /* EVP_PKEY structure */
    EVP_des_ede3_cbc(), /* default cipher for encrypting the key on disk */
    "replace_me",       /* passphrase required for decrypting the key on disk */
    10,                 /* length of the passphrase string */
    NULL,               /* callback for requesting a password */
    NULL                /* data to pass to the callback */
);

Pour enregistrer une clé privée dans un BIO , utilisez PEM_write_bio_PrivateKey :

BIO *bio;
bio = BIO_new(BIO_s_mem());
PEM_write_bio_PrivateKey(
    bio,                /* BIO to write the private key to */
    pkey,               /* EVP_PKEY structure */
    EVP_des_ede3_cbc(), /* default cipher for encrypting the key on disk */
    "replace_me",       /* passphrase required for decrypting the key on disk */
    10,                 /* length of the passphrase string */
    NULL,               /* callback for requesting a password */
    NULL                /* data to pass to the callback */
);

Charger une clé privée

Pour charger une clé privée directement à partir du disque, utilisez la fonction PEM_read_PrivateKey :

FILE *f;
EVP_PKEY *pkey;
f = fopen("key.pem", "rb");
PEM_read_PrivateKey(
    f,     /* use the FILE* that was opened */
    &pkey, /* pointer to EVP_PKEY structure */
    NULL,  /* password callback - can be NULL */
    NULL   /* parameter passed to callback or password if callback is NULL */
);

Pour charger une clé privée depuis un BIO , utilisez PEM_read_bio_PrivateKey :

BIO *bio;
bio = BIO_new_mem_buf((void *)input, input_len);
PEM_read_bio_PrivateKey(
    bio,   /* BIO to read the private key from */
    &pkey, /* pointer to EVP_PKEY structure */
    NULL,  /* password callback - can be NULL */
    NULL   /* parameter passed to callback or password if callback is NULL */
);