Couchbase C Client  3.3.12
Asynchronous C Client for Couchbase
Go to the documentation of this file.
1/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
3 * Copyright 2018-2020 Couchbase, Inc.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 *
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
18#ifndef LCB_CRYPTO_H
19#define LCB_CRYPTO_H
28#ifdef __cplusplus
29extern "C" {
51typedef struct lcbcrypto_SIGV {
52 const uint8_t *data;
53 size_t len;
67typedef struct lcbcrypto_PROVIDER {
68 uint16_t version;
69 int16_t _refcnt;
70 uint64_t flags;
71 void *cookie;
72 void (*destructor)(struct lcbcrypto_PROVIDER *provider);
73 union {
74 struct {
76 void (*release_bytes)(struct lcbcrypto_PROVIDER *provider, void *bytes);
78 lcb_STATUS (*generate_iv)(struct lcbcrypto_PROVIDER *provider, uint8_t **iv, size_t *iv_len);
80 lcb_STATUS (*sign)(struct lcbcrypto_PROVIDER *provider, const lcbcrypto_SIGV *inputs, size_t input_num,
81 uint8_t **sig, size_t *sig_len);
83 lcb_STATUS (*verify_signature)(struct lcbcrypto_PROVIDER *provider, const lcbcrypto_SIGV *inputs,
84 size_t input_num, uint8_t *sig, size_t sig_len);
86 lcb_STATUS (*encrypt)(struct lcbcrypto_PROVIDER *provider, const uint8_t *input, size_t input_len,
87 const uint8_t *iv, size_t iv_len, uint8_t **output, size_t *output_len);
89 lcb_STATUS (*decrypt)(struct lcbcrypto_PROVIDER *provider, const uint8_t *input, size_t input_len,
90 const uint8_t *iv, size_t iv_len, uint8_t **output, size_t *output_len);
92 const char *(*get_key_id)(struct lcbcrypto_PROVIDER *provider);
93 } v1;
94 } v;
105typedef struct lcbcrypto_FIELDSPEC {
106 const char *name;
107 const char *alg;
108 LCB_DEPRECATED2(const char *kid,
109 "Do not use kid field. Encryption keys have to be part of the provider implementation");
118typedef struct lcbcrypto_CMDENCRYPT {
119 uint16_t version;
120 const char *prefix;
121 const char *doc;
122 size_t ndoc;
123 char *out;
124 size_t nout;
126 size_t nfields;
135typedef struct lcbcrypto_CMDDECRYPT {
136 uint16_t version;
137 const char *prefix;
138 const char *doc;
139 size_t ndoc;
140 char *out;
141 size_t nout;
143 size_t nfields;
170LIBCOUCHBASE_API void lcbcrypto_register(lcb_INSTANCE *instance, const char *name, lcbcrypto_PROVIDER *provider);
180LIBCOUCHBASE_API void lcbcrypto_unregister(lcb_INSTANCE *instance, const char *name);
187LIBCOUCHBASE_API void lcbcrypto_ref(lcbcrypto_PROVIDER *provider);
196LIBCOUCHBASE_API void lcbcrypto_unref(lcbcrypto_PROVIDER *provider);
278#ifdef __cplusplus
281#endif /* LCB_CRYPTO_H */
lcbcrypto_FIELDSPEC * fields
list of field specs
Definition crypto.h:125
char * out
pointer to output JSON document.
Definition crypto.h:123
size_t ndoc
size of the input JSON document
Definition crypto.h:122
const char * doc
pointer to the input JSON document
Definition crypto.h:121
const uint8_t * data
pointer to data
Definition crypto.h:52
const char * prefix
prefix to encrypted field.
Definition crypto.h:120
void * cookie
opaque pointer (e.g.
Definition crypto.h:71
size_t len
length of the data in bytes
Definition crypto.h:53
uint64_t flags
provider-specific flags
Definition crypto.h:70
void(* destructor)(struct lcbcrypto_PROVIDER *provider)
destructor function, or NULL
Definition crypto.h:72
const char * name
field name (NUL-terminated)
Definition crypto.h:106
uint16_t version
version of the structure, current value is 1
Definition crypto.h:68
int16_t _refcnt
reference counter
Definition crypto.h:69
size_t nout
size of the output JSON document
Definition crypto.h:124
const char * alg
crypto provider alias (NUL-terminated)
Definition crypto.h:107
size_t nfields
number of field specs
Definition crypto.h:126
lcb_STATUS lcbcrypto_encrypt_fields(lcb_INSTANCE *instance, lcbcrypto_CMDENCRYPT *cmd)
Encrypt all specified fields in the JSON encoded object.
void lcbcrypto_unref(lcbcrypto_PROVIDER *provider)
Decrement reference counter for crypto-provider.
void lcbcrypto_unregister(lcb_INSTANCE *instance, const char *name)
Unregister crypto-provider for specified alias.
lcb_STATUS lcbcrypto_decrypt_fields(lcb_INSTANCE *instance, lcbcrypto_CMDDECRYPT *cmd)
Decrypt all specified fields in the JSON encoded object.
void lcbcrypto_register(lcb_INSTANCE *instance, const char *name, lcbcrypto_PROVIDER *provider)
Register crypto-provider for specified alias.
void lcbcrypto_ref(lcbcrypto_PROVIDER *provider)
Increment reference counter for crypto-provider.
Command to decrypt JSON fields.
Definition crypto.h:135
Command to encrypt JSON fields.
Definition crypto.h:118
Structure for JSON field specification for encrypt/decrypt API.
Definition crypto.h:105
Crypto-provider interface.
Definition crypto.h:67
IOV-style structure for signing functions of crypto-provider.
Definition crypto.h:51
Error codes returned by the library.
Definition error.h:212
struct lcb_st lcb_INSTANCE
Library handle representing a connection to a cluster and its data buckets.
Definition couchbase.h:35