NAME
DESCRIPTION
- Common X25519, X448, ED25519 and ED448 parameters
- ED25519 and ED448 parameters
CONFORMING TO
EXAMPLES
SEE ALSO
COPYRIGHT

NAME

EVP_PKEY-X25519, EVP_PKEY-X448, EVP_PKEY-ED25519, EVP_PKEY-ED448, EVP_KEYMGMT-X25519, EVP_KEYMGMT-X448, EVP_KEYMGMT-ED25519, EVP_KEYMGMT-ED448 - EVP_PKEY X25519, X448, ED25519 and ED448 keytype and algorithm support

DESCRIPTION

The X25519, X448, ED25519 and ED448 keytypes are implemented in OpenSSL's default provider.

Common X25519, X448, ED25519 and ED448 parameters

The following Import/Export types are available for the built-in X25519, X448, ED25519 and X448 algorithms:

"pub" (OSSL_PKEY_PARAM_PUB_KEY) <octet string>: The public key value.
"priv" (OSSL_PKEY_PARAM_PRIV_KEY) <octet string>: The private key value.

ED25519 and ED448 parameters

"mandatory-digest" (OSSL_PKEY_PARAM_MANDATORY_DIGEST) <utf8 string>: The empty string, signifying that no digest may be specified.

CONFORMING TO

RFC 8032

EXAMPLES

An EVP_PKEY context can be obtained by calling:

    EVP_PKEY_CTX *pctx =
        EVP_PKEY_CTX_new_from_name(NULL, "X25519", NULL);

    EVP_PKEY_CTX *pctx =
        EVP_PKEY_CTX_new_from_name(NULL, "X448", NULL);

    EVP_PKEY_CTX *pctx =
        EVP_PKEY_CTX_new_from_name(NULL, "ED25519", NULL);

    EVP_PKEY_CTX *pctx =
        EVP_PKEY_CTX_new_from_name(NULL, "ED448", NULL);

An ED25519 key can be generated like this:

    EVP_PKEY *pkey = NULL;
    EVP_PKEY_CTX *pctx =
        EVP_PKEY_CTX_new_from_name(NULL, "ED25519", NULL);

    EVP_PKEY_keygen_init(pctx);
    EVP_PKEY_gen(pctx, &pkey);
    EVP_PKEY_CTX_free(pctx);

An X25519 key can be generated in a similar way: