gnunet_identity_service.h File Reference

Identity service; implements identity management for GNUnet. More...

#include "gnunet_common.h"
#include "gnunet_util_lib.h"

Include dependency graph for gnunet_identity_service.h:

Go to the source code of this file.

Data Structures
struct	GNUNET_IDENTITY_PrivateKey
	A private key for an identity as per LSD0001. More...
struct	GNUNET_IDENTITY_PublicKey
	An identity key as per LSD0001. More...
struct	GNUNET_IDENTITY_Signature
	An identity signature as per LSD0001. More...

Macros
#define	GNUNET_IDENTITY_VERSION   0x00000100
	Version number of GNUnet Identity API. More...
#define	GNUNET_IDENTITY_sign(priv, ps, sig)
	Sign a given block with GNUNET_IDENTITY_PrivateKey. More...
#define	GNUNET_IDENTITY_signature_verify(purp, ps, sig, pub)
	Verify a given signature with GNUNET_IDENTITY_PublicKey. More...
#define	GNUNET_IDENTITY_ENCRYPT_OVERHEAD_BYTES

Typedefs
typedef void(*	GNUNET_IDENTITY_Callback) (void *cls, struct GNUNET_IDENTITY_Ego *ego, void **ctx, const char *name)
	Method called to inform about the egos of this peer. More...
typedef void(*	GNUNET_IDENTITY_Continuation) (void *cls, enum GNUNET_ErrorCode ec)
	Function called once the requested operation has been completed. More...
typedef void(*	GNUNET_IDENTITY_CreateContinuation) (void *cls, const struct GNUNET_IDENTITY_PrivateKey *pk, enum GNUNET_ErrorCode ec)
	Function called once the requested operation has been completed. More...
typedef void(*	GNUNET_IDENTITY_EgoCallback) (void *cls, struct GNUNET_IDENTITY_Ego *ego)
	Function called with the result. More...
typedef void(*	GNUNET_IDENTITY_EgoSuffixCallback) (void *cls, const struct GNUNET_IDENTITY_PrivateKey *priv, const char *ego_name)
	Function called with the result. More...

Enumerations
enum	GNUNET_IDENTITY_KeyType { GNUNET_IDENTITY_TYPE_ECDSA = 65536 , GNUNET_IDENTITY_TYPE_EDDSA = 65556 }

Functions
const struct GNUNET_IDENTITY_PrivateKey *	GNUNET_IDENTITY_ego_get_private_key (const struct GNUNET_IDENTITY_Ego *ego)
	Obtain the ECC key associated with a ego. More...
struct GNUNET_IDENTITY_Ego *	GNUNET_IDENTITY_ego_get_anonymous (void)
	Obtain the ego representing 'anonymous' users. More...
void	GNUNET_IDENTITY_ego_get_public_key (struct GNUNET_IDENTITY_Ego *ego, struct GNUNET_IDENTITY_PublicKey *pk)
	Get the identifier (public key) of an ego. More...
struct GNUNET_IDENTITY_Handle *	GNUNET_IDENTITY_connect (const struct GNUNET_CONFIGURATION_Handle *cfg, GNUNET_IDENTITY_Callback cb, void *cb_cls)
	Connect to the identity service. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_get (struct GNUNET_IDENTITY_Handle *id, const char *service_name, GNUNET_IDENTITY_Callback cb, void *cb_cls)
	Obtain the ego that is currently preferred/default for a service. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_set (struct GNUNET_IDENTITY_Handle *id, const char *service_name, struct GNUNET_IDENTITY_Ego *ego, GNUNET_IDENTITY_Continuation cont, void *cont_cls)
	Set the preferred/default ego for a service. More...
void	GNUNET_IDENTITY_disconnect (struct GNUNET_IDENTITY_Handle *h)
	Disconnect from identity service. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_create (struct GNUNET_IDENTITY_Handle *id, const char *name, const struct GNUNET_IDENTITY_PrivateKey *privkey, enum GNUNET_IDENTITY_KeyType ktype, GNUNET_IDENTITY_CreateContinuation cont, void *cont_cls)
	Create a new ego with the given name. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_rename (struct GNUNET_IDENTITY_Handle *id, const char *old_name, const char *new_name, GNUNET_IDENTITY_Continuation cb, void *cb_cls)
	Renames an existing ego. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_delete (struct GNUNET_IDENTITY_Handle *id, const char *name, GNUNET_IDENTITY_Continuation cb, void *cb_cls)
	Delete an existing ego. More...
void	GNUNET_IDENTITY_cancel (struct GNUNET_IDENTITY_Operation *op)
	Cancel an identity operation. More...
ssize_t	GNUNET_IDENTITY_public_key_get_length (const struct GNUNET_IDENTITY_PublicKey *key)
	Get the compacted length of a GNUNET_IDENTITY_PublicKey. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_read_public_key_from_buffer (const void *buffer, size_t len, struct GNUNET_IDENTITY_PublicKey *key, size_t *read)
	Reads a GNUNET_IDENTITY_PublicKey from a compact buffer. More...
ssize_t	GNUNET_IDENTITY_private_key_get_length (const struct GNUNET_IDENTITY_PrivateKey *key)
	Get the compacted length of a GNUNET_IDENTITY_PrivateKey. More...
ssize_t	GNUNET_IDENTITY_write_public_key_to_buffer (const struct GNUNET_IDENTITY_PublicKey *key, void *buffer, size_t len)
	Writes a GNUNET_IDENTITY_PublicKey to a compact buffer. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_read_private_key_from_buffer (const void *buffer, size_t len, struct GNUNET_IDENTITY_PrivateKey *key, size_t *read)
	Reads a GNUNET_IDENTITY_PrivateKey from a compact buffer. More...
ssize_t	GNUNET_IDENTITY_write_private_key_to_buffer (const struct GNUNET_IDENTITY_PrivateKey *key, void *buffer, size_t len)
	Writes a GNUNET_IDENTITY_PrivateKey to a compact buffer. More...
ssize_t	GNUNET_IDENTITY_signature_get_length (const struct GNUNET_IDENTITY_Signature *sig)
	Get the compacted length of a GNUNET_IDENTITY_Signature. More...
ssize_t	GNUNET_IDENTITY_signature_get_raw_length_by_type (uint32_t type)
	Get the compacted length of a signature by type. More...
ssize_t	GNUNET_IDENTITY_read_signature_from_buffer (struct GNUNET_IDENTITY_Signature *sig, const void *buffer, size_t len)
	Reads a GNUNET_IDENTITY_Signature from a compact buffer. More...
ssize_t	GNUNET_IDENTITY_write_signature_to_buffer (const struct GNUNET_IDENTITY_Signature *sig, void *buffer, size_t len)
	Writes a GNUNET_IDENTITY_Signature to a compact buffer. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_sign_ (const struct GNUNET_IDENTITY_PrivateKey *priv, const struct GNUNET_CRYPTO_EccSignaturePurpose *purpose, struct GNUNET_IDENTITY_Signature *sig)
	Sign a given block. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_sign_raw_ (const struct GNUNET_IDENTITY_PrivateKey *priv, const struct GNUNET_CRYPTO_EccSignaturePurpose *purpose, unsigned char *sig)
	Sign a given block. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_signature_verify_ (uint32_t purpose, const struct GNUNET_CRYPTO_EccSignaturePurpose *validate, const struct GNUNET_IDENTITY_Signature *sig, const struct GNUNET_IDENTITY_PublicKey *pub)
	Verify a given signature. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_signature_verify_raw_ (uint32_t purpose, const struct GNUNET_CRYPTO_EccSignaturePurpose *validate, const unsigned char *sig, const struct GNUNET_IDENTITY_PublicKey *pub)
	Verify a given signature. More...
ssize_t	GNUNET_IDENTITY_encrypt_old (const void *block, size_t size, const struct GNUNET_IDENTITY_PublicKey *pub, struct GNUNET_CRYPTO_EcdhePublicKey *ecc, void *result)
	Encrypt a block with GNUNET_IDENTITY_PublicKey and derives a GNUNET_CRYPTO_EcdhePublicKey which is required for decryption using ecdh to derive a symmetric key. More...
ssize_t	GNUNET_IDENTITY_decrypt_old (const void *block, size_t size, const struct GNUNET_IDENTITY_PrivateKey *priv, const struct GNUNET_CRYPTO_EcdhePublicKey *ecc, void *result)
	Decrypt a given block with GNUNET_IDENTITY_PrivateKey and a given GNUNET_CRYPTO_EcdhePublicKey using ecdh to derive a symmetric key. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_encrypt (const void *block, size_t size, const struct GNUNET_IDENTITY_PublicKey *pub, void *result, size_t result_size)
	Encrypt a block with GNUNET_IDENTITY_PublicKey and derives a GNUNET_CRYPTO_EcdhePublicKey which is required for decryption using ecdh to derive a symmetric key. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_decrypt (const void *block, size_t size, const struct GNUNET_IDENTITY_PrivateKey *priv, void *result, size_t result_size)
	Decrypt a given block with GNUNET_IDENTITY_PrivateKey and a given GNUNET_CRYPTO_EcdhePublicKey using ecdh to derive a symmetric key. More...
char *	GNUNET_IDENTITY_public_key_to_string (const struct GNUNET_IDENTITY_PublicKey *key)
	Creates a (Base32) string representation of the public key. More...
char *	GNUNET_IDENTITY_private_key_to_string (const struct GNUNET_IDENTITY_PrivateKey *key)
	Creates a (Base32) string representation of the private key. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_public_key_from_string (const char *str, struct GNUNET_IDENTITY_PublicKey *key)
	Parses a (Base32) string representation of the public key. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_private_key_from_string (const char *str, struct GNUNET_IDENTITY_PrivateKey *key)
	Parses a (Base32) string representation of the private key. More...
enum GNUNET_GenericReturnValue	GNUNET_IDENTITY_key_get_public (const struct GNUNET_IDENTITY_PrivateKey *privkey, struct GNUNET_IDENTITY_PublicKey *key)
	Retrieves the public key representation of a private key. More...
struct GNUNET_IDENTITY_EgoLookup *	GNUNET_IDENTITY_ego_lookup (const struct GNUNET_CONFIGURATION_Handle *cfg, const char *name, GNUNET_IDENTITY_EgoCallback cb, void *cb_cls)
	Lookup an ego by name. More...
void	GNUNET_IDENTITY_ego_lookup_cancel (struct GNUNET_IDENTITY_EgoLookup *el)
	Abort ego lookup attempt. More...
struct GNUNET_IDENTITY_EgoSuffixLookup *	GNUNET_IDENTITY_ego_lookup_by_suffix (const struct GNUNET_CONFIGURATION_Handle *cfg, const char *suffix, GNUNET_IDENTITY_EgoSuffixCallback cb, void *cb_cls)
	Obtain the ego with the maximum suffix match between the ego's name and the given domain name suffix. More...
void	GNUNET_IDENTITY_ego_lookup_by_suffix_cancel (struct GNUNET_IDENTITY_EgoSuffixLookup *el)
	Abort ego suffix lookup attempt. More...

Detailed Description

Identity service; implements identity management for GNUnet.

Definition in file gnunet_identity_service.h.