jwk.h

Go to the documentation of this file.

/*
 * Copyrights
 *
 * Portions created or assigned to Cisco Systems, Inc. are
 * Copyright (c) 2014-2016 Cisco Systems, Inc.  All Rights Reserved.
 */
#ifndef CJOSE_JWK_H
#define CJOSE_JWK_H

#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>
#include <openssl/obj_mac.h>
#include "cjose/error.h"
#include "cjose/header.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef enum {
    CJOSE_JWK_KTY_RSA = 1,
    CJOSE_JWK_KTY_EC,
    CJOSE_JWK_KTY_OCT
} cjose_jwk_kty_t;

const char *cjose_jwk_name_for_kty(cjose_jwk_kty_t kty, cjose_err *err);

typedef struct _cjose_jwk_int cjose_jwk_t;

cjose_jwk_t *cjose_jwk_retain(cjose_jwk_t *jwk, cjose_err *err);

bool cjose_jwk_release(cjose_jwk_t *jwk);

cjose_jwk_kty_t cjose_jwk_get_kty(const cjose_jwk_t *jwk, cjose_err *err);

size_t cjose_jwk_get_keysize(const cjose_jwk_t *jwk, cjose_err *err);

void *cjose_jwk_get_keydata(const cjose_jwk_t *jwk, cjose_err *err);

const char *cjose_jwk_get_kid(const cjose_jwk_t *jwk, cjose_err *err);

bool cjose_jwk_set_kid(cjose_jwk_t *jwk, const char *kid, size_t len, cjose_err *err);

char *cjose_jwk_to_json(const cjose_jwk_t *jwk, bool priv, cjose_err *err);

typedef struct
{
    uint8_t *e;
    size_t elen;
    uint8_t *n;
    size_t nlen;
    uint8_t *d;
    size_t dlen;
    uint8_t *p;
    size_t plen;
    uint8_t *q;
    size_t qlen;
    uint8_t *dp;
    size_t dplen;
    uint8_t *dq;
    size_t dqlen;
    uint8_t *qi;
    size_t qilen;
} cjose_jwk_rsa_keyspec;

cjose_jwk_t *cjose_jwk_create_RSA_random(size_t keysize, const uint8_t *e, size_t elen, cjose_err *err);

cjose_jwk_t *cjose_jwk_create_RSA_spec(const cjose_jwk_rsa_keyspec *spec, cjose_err *err);

typedef enum {
    CJOSE_JWK_EC_P_256 = NID_X9_62_prime256v1,
    CJOSE_JWK_EC_P_384 = NID_secp384r1,
    CJOSE_JWK_EC_P_521 = NID_secp521r1,
    CJOSE_JWK_EC_INVALID = -1
} cjose_jwk_ec_curve;

typedef struct
{
    cjose_jwk_ec_curve crv;
    uint8_t *d;
    size_t dlen;
    uint8_t *x;
    size_t xlen;
    uint8_t *y;
    size_t ylen;
} cjose_jwk_ec_keyspec;

cjose_jwk_t *cjose_jwk_create_EC_random(cjose_jwk_ec_curve crv, cjose_err *err);

cjose_jwk_t *cjose_jwk_create_EC_spec(const cjose_jwk_ec_keyspec *spec, cjose_err *err);

const cjose_jwk_ec_curve cjose_jwk_EC_get_curve(const cjose_jwk_t *jwk, cjose_err *err);

cjose_jwk_t *cjose_jwk_create_oct_random(size_t size, cjose_err *err);

cjose_jwk_t *cjose_jwk_create_oct_spec(const uint8_t *data, size_t len, cjose_err *err);

cjose_jwk_t *cjose_jwk_import(const char *json, size_t len, cjose_err *err);

cjose_jwk_t *cjose_jwk_import_json(cjose_header_t *json, cjose_err *err);

cjose_jwk_t *cjose_jwk_derive_ecdh_ephemeral_key(const cjose_jwk_t *jwk_self, const cjose_jwk_t *jwk_peer, cjose_err *err);

cjose_jwk_t *cjose_jwk_derive_ecdh_secret(const cjose_jwk_t *jwk_self, const cjose_jwk_t *jwk_peer, cjose_err *err);

#ifdef __cplusplus
}
#endif

#endif // CJOSE_JWK_H