cipher.h

Go to the documentation of this file.

/*
 * Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not use
 * this file except in compliance with the License. A copy of the License is
 * located at
 *
 *     http://aws.amazon.com/apache2.0/
 *
 * or in the "license" file accompanying this file. This file is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
 * implied. See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef AWS_CRYPTOSDK_CIPHER_H
#define AWS_CRYPTOSDK_CIPHER_H
 
#include <aws/common/byte_buf.h>
#include <aws/common/string.h>
#include <aws/cryptosdk/exports.h>
#include <aws/cryptosdk/header.h>

 
#ifdef __cplusplus
extern "C" {
#endif

enum aws_cryptosdk_aes_key_len {
    AWS_CRYPTOSDK_AES128 = 128 / 8,
    AWS_CRYPTOSDK_AES192 = 192 / 8,
    AWS_CRYPTOSDK_AES256 = 256 / 8
};

enum aws_cryptosdk_rsa_padding_mode {
    AWS_CRYPTOSDK_RSA_PKCS1,
    AWS_CRYPTOSDK_RSA_OAEP_SHA1_MGF1,
    AWS_CRYPTOSDK_RSA_OAEP_SHA256_MGF1,
};

struct aws_cryptosdk_alg_properties {
    const char *md_name;
    const char *cipher_name;
    const char *alg_name;

    const struct aws_cryptosdk_alg_impl *impl;

    size_t data_key_len;
    size_t content_key_len;
    size_t iv_len;
    size_t tag_len;
    size_t signature_len;

    enum aws_cryptosdk_alg_id alg_id;

    enum aws_cryptosdk_hdr_version msg_format_version;

    size_t alg_suite_data_len;

    size_t commitment_len;

    const char *sig_md_name;
};

AWS_CRYPTOSDK_API
const struct aws_cryptosdk_alg_properties *aws_cryptosdk_alg_props(enum aws_cryptosdk_alg_id alg_id);

AWS_CRYPTOSDK_API
bool aws_cryptosdk_alg_properties_is_valid(const struct aws_cryptosdk_alg_properties *const alg_props);

struct aws_cryptosdk_sig_ctx;

AWS_CRYPTOSDK_API
bool aws_cryptosdk_sig_ctx_is_valid(const struct aws_cryptosdk_sig_ctx *sig_ctx);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_get_privkey(
    const struct aws_cryptosdk_sig_ctx *ctx, struct aws_allocator *alloc, struct aws_string **priv_key_buf);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_get_pubkey(
    const struct aws_cryptosdk_sig_ctx *ctx, struct aws_allocator *alloc, struct aws_string **pub_key_buf);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_sign_start_keygen(
    struct aws_cryptosdk_sig_ctx **ctx,
    struct aws_allocator *alloc,
    struct aws_string **pub_key_buf,
    const struct aws_cryptosdk_alg_properties *props);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_sign_start(
    struct aws_cryptosdk_sig_ctx **ctx,
    struct aws_allocator *alloc,
    struct aws_string **pub_key_buf,
    const struct aws_cryptosdk_alg_properties *props,
    const struct aws_string *priv_key);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_verify_start(
    struct aws_cryptosdk_sig_ctx **ctx,
    struct aws_allocator *alloc,
    const struct aws_string *pub_key,
    const struct aws_cryptosdk_alg_properties *props);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_update(struct aws_cryptosdk_sig_ctx *ctx, const struct aws_byte_cursor buf);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_verify_finish(struct aws_cryptosdk_sig_ctx *ctx, const struct aws_string *signature);

AWS_CRYPTOSDK_API
int aws_cryptosdk_sig_sign_finish(
    struct aws_cryptosdk_sig_ctx *ctx, struct aws_allocator *alloc, struct aws_string **signature);

AWS_CRYPTOSDK_API
void aws_cryptosdk_sig_abort(struct aws_cryptosdk_sig_ctx *ctx);
 
#ifdef __cplusplus
}
#endif
  // doxygen group hazmat
 
#endif  // AWS_CRYPTOSDK_CIPHER_H