mirror of
https://github.com/RetroShare/RetroShare.git
synced 2024-10-01 02:35:48 -04:00
131 lines
4.7 KiB
C++
131 lines
4.7 KiB
C++
#ifndef GXSSECURITY_H
|
|
#define GXSSECURITY_H
|
|
|
|
/*
|
|
* libretroshare/src/gxs: gxssecurity.h
|
|
*
|
|
* Security functions for Gxs
|
|
*
|
|
* Copyright 2008-2010 by Robert Fernie
|
|
* 2011-2012 Christopher Evi-Parker
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License Version 2 as published by the Free Software Foundation.
|
|
*
|
|
* This library 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
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
|
|
* USA.
|
|
*
|
|
* Please report all bugs and problems to "retroshare@lunamutt.com".
|
|
*
|
|
*/
|
|
|
|
#include "serialiser/rstlvkeys.h"
|
|
#include "serialiser/rsnxsitems.h"
|
|
|
|
#include <openssl/ssl.h>
|
|
#include <openssl/evp.h>
|
|
|
|
|
|
/*!
|
|
* This contains functionality for performing security
|
|
* operations needed to validate data received in RsGenExchange
|
|
* Also has routine for creating security objects around msgs and groups
|
|
*/
|
|
class GxsSecurity
|
|
{
|
|
public:
|
|
/*!
|
|
* Extracts a public key from a private key.
|
|
*/
|
|
static bool extractPublicKey(const RsTlvSecurityKey& private_key,RsTlvSecurityKey& public_key) ;
|
|
|
|
/*!
|
|
* Generates a public/private RSA keypair. To be used for all GXS purposes.
|
|
* @param RsTlvSecurityKey public RSA key
|
|
* @param RsTlvSecurityKey private RSA key
|
|
* @return true if the generate was successful, false otherwise.
|
|
*/
|
|
static bool generateKeyPair(RsTlvSecurityKey& public_key,RsTlvSecurityKey& private_key) ;
|
|
|
|
/*!
|
|
* Encrypts data using envelope encryption (taken from open ssl's evp_sealinit )
|
|
* only full publish key holders can encrypt data for given group
|
|
*@param out
|
|
*@param outlen
|
|
*@param in
|
|
*@param inlen
|
|
*/
|
|
static bool encrypt(uint8_t *&out, uint32_t &outlen, const uint8_t *in, uint32_t inlen, const RsTlvSecurityKey& key) ;
|
|
static bool encrypt(uint8_t *&out, uint32_t &outlen, const uint8_t *in, uint32_t inlen, const std::vector<RsTlvSecurityKey>& keys) ;
|
|
|
|
/**
|
|
* Decrypts data using evelope decryption (taken from open ssl's evp_sealinit )
|
|
* only full publish key holders can decrypt data for a group
|
|
* @param out where decrypted data is written to
|
|
* @param outlen
|
|
* @param in
|
|
* @param inlen
|
|
* @return false if encryption failed
|
|
*/
|
|
static bool decrypt(uint8_t *&out, uint32_t &outlen, const uint8_t *in, uint32_t inlen, const RsTlvSecurityKey& key) ;
|
|
static bool decrypt(uint8_t *& out, uint32_t & outlen, const uint8_t *in, uint32_t inlen, const std::vector<RsTlvSecurityKey>& keys);
|
|
|
|
/*!
|
|
* uses grp signature to check if group has been
|
|
* tampered with
|
|
* @param newGrp the Nxs group to be validated
|
|
* @param sign the signature to validdate against
|
|
* @param key the public key to use to check signature
|
|
* @return true if group valid false otherwise
|
|
*/
|
|
static bool validateNxsGrp(const RsNxsGrp& grp, const RsTlvKeySignature& sign, const RsTlvSecurityKey& key);
|
|
|
|
/*!
|
|
* Validate a msg's signature using the given public key
|
|
* @param msg the Nxs message to be validated
|
|
* @param sign the signature to validdate against
|
|
* @param key the public key to use to check signature
|
|
* @return false if verfication of signature is not passed
|
|
*/
|
|
static bool validateNxsMsg(const RsNxsMsg& msg, const RsTlvKeySignature& sign, const RsTlvSecurityKey& key);
|
|
|
|
|
|
/*!
|
|
* @param data data to be signed
|
|
* @param data_len length of data to be signed
|
|
* @param privKey private key to used to make signature
|
|
* @param sign the signature is stored here
|
|
* @return false if signature creation failed, true is signature created
|
|
*/
|
|
static bool getSignature(const char *data, uint32_t data_len, const RsTlvSecurityKey& privKey, RsTlvKeySignature& sign);
|
|
|
|
/*!
|
|
* @param data data that has been signed
|
|
* @param data_len length of signed data
|
|
* @param privKey public key to used to check signature
|
|
* @param sign Signature for the data
|
|
* @return true if signature checks
|
|
*/
|
|
static bool validateSignature(const char *data, uint32_t data_len, const RsTlvSecurityKey& pubKey, const RsTlvKeySignature& sign);
|
|
|
|
/*!
|
|
* Checks that the public key has correct fingerprint and correct flags.
|
|
* @brief checkPublicKey
|
|
* @param key
|
|
* @return false if the key is invalid.
|
|
*/
|
|
|
|
static bool checkPublicKey(const RsTlvSecurityKey &key);
|
|
static bool checkPrivateKey(const RsTlvSecurityKey &key);
|
|
};
|
|
|
|
#endif // GXSSECURITY_H
|