d5/d6c/jwt_8h_source.html

#ifndef __CWIST_SECURITY_JWT_H__

#define __CWIST_SECURITY_JWT_H__


#include <stdbool.h>

#include <stddef.h>

#include <stdint.h>

#include <time.h>


#ifdef __cplusplus

extern "C" {

#endif


typedef struct cwist_jwt_claims cwist_jwt_claims;


char *cwist_jwt_sign(const char *payload_json, const char *secret, long exp_seconds);


cwist_jwt_claims *cwist_jwt_verify(const char *token, const char *secret);


const char *cwist_jwt_claims_get(const cwist_jwt_claims *claims, const char *key);


void cwist_jwt_claims_destroy(cwist_jwt_claims *claims);


typedef struct cwist_jwt_chunk {

    uint8_t *data;

    size_t len;

} cwist_jwt_chunk_t;


cwist_jwt_chunk_t *cwist_jwt_split_chunks(const char *token, uint16_t chunk_payload_size,

                                          size_t *out_count);


void cwist_jwt_chunks_free(cwist_jwt_chunk_t *chunks, size_t count);


char *cwist_jwt_join_chunks(const cwist_jwt_chunk_t *chunks, size_t count);


cwist_jwt_chunk_t *cwist_jwt_sign_chunks(const char *payload_json, const char *secret,

                                         long exp_seconds, uint16_t chunk_payload_size,

                                         size_t *out_count);


cwist_jwt_claims *cwist_jwt_verify_chunks(const cwist_jwt_chunk_t *chunks, size_t count,

                                          const char *secret);


char *cwist_jwt_sign_es256(const char *payload_json, const char *pem_private_key,

                           const char *kid, long exp_seconds);


cwist_jwt_claims *cwist_jwt_verify_es256(const char *token, const char *pem_key);


char *cwist_jwt_sign_ed25519(const char *payload_json, const char *pem_private_key,

                             const char *kid, long exp_seconds);


cwist_jwt_claims *cwist_jwt_verify_ed25519(const char *token, const char *pem_key);


#ifdef __cplusplus

}

#endif


#endif /* __CWIST_SECURITY_JWT_H__ */

cwist_jwt_claims_get
const char * cwist_jwt_claims_get(const cwist_jwt_claims *claims, const char *key)
Retrieve a claim value by key from decoded claims.
Definition jwt.c:766

cwist_jwt_claims_destroy
void cwist_jwt_claims_destroy(cwist_jwt_claims *claims)
Free a claims object.
Definition jwt.c:779

cwist_jwt_split_chunks
cwist_jwt_chunk_t * cwist_jwt_split_chunks(const char *token, uint16_t chunk_payload_size, size_t *out_count)
Split a JWT token into sequenced chunks.
Definition jwt.c:800

cwist_jwt_claims
struct cwist_jwt_claims cwist_jwt_claims
Opaque JWT claims object returned after successful verification.
Definition jwt.h:25

cwist_jwt_join_chunks
char * cwist_jwt_join_chunks(const cwist_jwt_chunk_t *chunks, size_t count)
Reassemble a JWT token from sequenced chunks.
Definition jwt.c:852

cwist_jwt_verify_es256
cwist_jwt_claims * cwist_jwt_verify_es256(const char *token, const char *pem_key)
Verify an ES256-signed JWT token and return the decoded claims.
Definition jwt.c:752

cwist_jwt_sign
char * cwist_jwt_sign(const char *payload_json, const char *secret, long exp_seconds)
Sign a JWT token with HMAC-SHA256.
Definition jwt.c:620

cwist_jwt_verify
cwist_jwt_claims * cwist_jwt_verify(const char *token, const char *secret)
Verify a JWT token and return the decoded claims.
Definition jwt.c:748

cwist_jwt_sign_chunks
cwist_jwt_chunk_t * cwist_jwt_sign_chunks(const char *payload_json, const char *secret, long exp_seconds, uint16_t chunk_payload_size, size_t *out_count)
Sign a JWT and immediately split it into sequenced chunks.
Definition jwt.c:897

cwist_jwt_sign_es256
char * cwist_jwt_sign_es256(const char *payload_json, const char *pem_private_key, const char *kid, long exp_seconds)
Sign a JWT token with ES256 (ECDSA over P-256 with SHA-256).
Definition jwt.c:624

cwist_jwt_chunk_t
struct cwist_jwt_chunk cwist_jwt_chunk_t
One sequenced JWT chunk produced by cwist_jwt_split_chunks().

cwist_jwt_verify_chunks
cwist_jwt_claims * cwist_jwt_verify_chunks(const cwist_jwt_chunk_t *chunks, size_t count, const char *secret)
Reassemble sequenced JWT chunks and verify the resulting token.
Definition jwt.c:921

cwist_jwt_chunks_free
void cwist_jwt_chunks_free(cwist_jwt_chunk_t *chunks, size_t count)
Free chunk objects returned by cwist_jwt_split_chunks().
Definition jwt.c:837

cwist_jwt_verify_ed25519
cwist_jwt_claims * cwist_jwt_verify_ed25519(const char *token, const char *pem_key)
Verify an Ed25519-signed JWT token and return the decoded claims.
Definition jwt.c:756

cwist_jwt_sign_ed25519
char * cwist_jwt_sign_ed25519(const char *payload_json, const char *pem_private_key, const char *kid, long exp_seconds)
Sign a JWT token with EdDSA (Ed25519, RFC 8037).
Definition jwt.c:629

count
size_t count
Definition otel.c:58

cwist_jwt_chunk
One sequenced JWT chunk produced by cwist_jwt_split_chunks().
Definition jwt.h:80

cwist_jwt_chunk::len
size_t len
Length of data.
Definition jwt.h:82

cwist_jwt_chunk::data
uint8_t * data
Chunk bytes (header + payload).
Definition jwt.h:81