pace.h

Go to the documentation of this file.

/*
 * Copyright (c) 2010-2012 Frank Morgner and Dominik Oepen
 *
 * This file is part of OpenPACE.
 *
 * OpenPACE is free software: you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free
 * Software Foundation, either version 3 of the License, or (at your option)
 * any later version.
 *
 * OpenPACE is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * OpenPACE.  If not, see <http://www.gnu.org/licenses/>.
 *
 * Additional permission under GNU GPL version 3 section 7
 *
 * If you modify this Program, or any covered work, by linking or combining it
 * with OpenSSL (or a modified version of that library), containing
 * parts covered by the terms of OpenSSL's license, the licensors of
 * this Program grant you additional permission to convey the resulting work.
 * Corresponding Source for a non-source form of such a combination shall include
 * the source code for the parts of OpenSSL used as well as that of the
 * covered work.
 *
 * If you modify this Program, or any covered work, by linking or combining it
 * with OpenSC (or a modified version of that library), containing
 * parts covered by the terms of OpenSC's license, the licensors of
 * this Program grant you additional permission to convey the resulting work. 
 * Corresponding Source for a non-source form of such a combination shall include
 * the source code for the parts of OpenSC used as well as that of the
 * covered work.
 */
 
#ifndef PACE_H_
#define PACE_H_
 
#include "eac.h"
#include <openssl/bn.h>
#include <openssl/buffer.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum s_type {
    PACE_MRZ = 1,
    PACE_CAN,
    PACE_PIN,
    PACE_PUK,
    PACE_RAW,
    PACE_SEC_UNDEF
};
 
typedef struct pace_sec {
    enum s_type type;
    BUF_MEM *mem;
    BUF_MEM *encoded;
} PACE_SEC;
 
void PACE_SEC_clear_free(PACE_SEC * s);
PACE_SEC *
PACE_SEC_new(const char *sec, size_t sec_len, enum s_type type);
 
int
PACE_SEC_print_private(BIO *out, const PACE_SEC *sec, int indent);
BUF_MEM * PACE_STEP1_enc_nonce(const EAC_CTX * ctx, const PACE_SEC * pi);
int PACE_STEP2_dec_nonce(const EAC_CTX * ctx, const PACE_SEC * pi,
        const BUF_MEM * enc_nonce);
BUF_MEM *
PACE_STEP3A_generate_mapping_data(const EAC_CTX * ctx);
int
PACE_STEP3A_map_generator(const EAC_CTX * ctx, const BUF_MEM * in);
BUF_MEM * PACE_STEP3B_generate_ephemeral_key(EAC_CTX * ctx);
int
PACE_STEP3B_compute_shared_secret(const EAC_CTX * ctx, const BUF_MEM * in);
int PACE_STEP3C_derive_keys(const EAC_CTX *ctx);
BUF_MEM * PACE_STEP3D_compute_authentication_token(const EAC_CTX *ctx,
        const BUF_MEM *pub);
int PACE_STEP3D_verify_authentication_token(const EAC_CTX * ctx,
        const BUF_MEM * token);
 
#ifdef  __cplusplus
}
#endif
#endif