14c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley/* ==================================================================== 24c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED. 34c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 44c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * The Elliptic Curve Public-Key Crypto Library (ECC Code) included 54c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * herein is developed by SUN MICROSYSTEMS, INC., and is contributed 64c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * to the OpenSSL project. 74c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 84c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * The ECC Code is licensed pursuant to the OpenSSL open source 94c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * license provided below. 104c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 114c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * The ECDH software is originally written by Douglas Stebila of 124c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * Sun Microsystems Laboratories. 134c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 144c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley */ 154c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley/* ==================================================================== 164c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * Copyright (c) 2000-2002 The OpenSSL Project. All rights reserved. 174c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 184c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * Redistribution and use in source and binary forms, with or without 194c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * modification, are permitted provided that the following conditions 204c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * are met: 214c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 224c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 1. Redistributions of source code must retain the above copyright 234c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * notice, this list of conditions and the following disclaimer. 244c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 254c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 2. Redistributions in binary form must reproduce the above copyright 264c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * notice, this list of conditions and the following disclaimer in 274c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * the documentation and/or other materials provided with the 284c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * distribution. 294c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 304c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 3. All advertising materials mentioning features or use of this 314c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * software must display the following acknowledgment: 324c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * "This product includes software developed by the OpenSSL Project 334c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)" 344c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 354c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to 364c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * endorse or promote products derived from this software without 374c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * prior written permission. For written permission, please contact 384c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * licensing@OpenSSL.org. 394c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 404c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 5. Products derived from this software may not be called "OpenSSL" 414c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * nor may "OpenSSL" appear in their names without prior written 424c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * permission of the OpenSSL Project. 434c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 444c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 6. Redistributions of any form whatsoever must retain the following 454c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * acknowledgment: 464c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * "This product includes software developed by the OpenSSL Project 474c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)" 484c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 494c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY 504c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 514c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 524c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR 534c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 544c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 554c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 564c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 574c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 584c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 594c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 604c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * OF THE POSSIBILITY OF SUCH DAMAGE. 614c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * ==================================================================== 624c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * 634c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * This product includes cryptographic software written by Eric Young 644c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * (eay@cryptsoft.com). This product includes software written by Tim 654c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * Hudson (tjh@cryptsoft.com). */ 664c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 674c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#ifndef OPENSSL_HEADER_ECDH_H 684c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#define OPENSSL_HEADER_ECDH_H 694c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 704c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#include <openssl/base.h> 714c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 724c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#include <openssl/ec_key.h> 734c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 744c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#if defined(__cplusplus) 754c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langleyextern "C" { 764c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#endif 774c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 784c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 794c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley/* ECDH_compute_key calculates the shared key between |pub_key| and |priv_key|. 804c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * If |KDF| is not NULL, then it is called with the bytes of the shared key and 814c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * the parameter |out|. When |KDF| returns, the value of |*outlen| becomes the 824c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * return value. Otherwise, as many bytes of the shared key as will fit are 834c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * copied directly to, at most, |outlen| bytes at |out|. It returns the number 844c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * of bytes written to |out|, or -1 on error. */ 85eb7d2ed1fe8a33b3e3871502ba7e12efaf94360cAdam LangleyOPENSSL_EXPORT int ECDH_compute_key(void *out, size_t outlen, 86eb7d2ed1fe8a33b3e3871502ba7e12efaf94360cAdam Langley const EC_POINT *pub_key, EC_KEY *priv_key, 87eb7d2ed1fe8a33b3e3871502ba7e12efaf94360cAdam Langley void *(*KDF)(const void *in, size_t inlen, 88eb7d2ed1fe8a33b3e3871502ba7e12efaf94360cAdam Langley void *out, size_t *outlen)); 894c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 904c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley/* ECDH_KDF_X9_62 writes |outlen| bytes to |out| using the KDF from X9.62 914c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * applied to |Z| and |sinfo| and using the hash |md|. It returns one on 924c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley * success and zero otherwise. */ 93eb7d2ed1fe8a33b3e3871502ba7e12efaf94360cAdam LangleyOPENSSL_EXPORT int ECDH_KDF_X9_62(uint8_t *out, size_t outlen, const uint8_t *Z, 94eb7d2ed1fe8a33b3e3871502ba7e12efaf94360cAdam Langley size_t Zlen, const uint8_t *sinfo, 95eb7d2ed1fe8a33b3e3871502ba7e12efaf94360cAdam Langley size_t sinfolen, const EVP_MD *md); 964c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 974c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 984c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#if defined(__cplusplus) 994c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley} /* extern C */ 1004c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#endif 1014c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 1024c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#define ECDH_F_ECDH_compute_key 100 1034c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#define ECDH_R_POINT_ARITHMETIC_FAILURE 100 1044c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#define ECDH_R_KDF_FAILED 101 1054c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#define ECDH_R_NO_PRIVATE_VALUE 102 1064c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley 1074c921e1bbcc1d1cd23848e3b11ab2c9f85ee37eaAdam Langley#endif /* OPENSSL_HEADER_ECDH_H */ 108