GNUnet  0.10.x
gnunet_credential_service.h
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet
3  Copyright (C) 2012-2014 GNUnet e.V.
4 
5  GNUnet is free software: you can redistribute it and/or modify it
6  under the terms of the GNU Affero General Public License as published
7  by the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
10  GNUnet is distributed in the hope that it will be useful, but
11  WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  Affero General Public License for more details.
14 
15  You should have received a copy of the GNU Affero General Public License
16  along with this program. If not, see <http://www.gnu.org/licenses/>.
17 
18  SPDX-License-Identifier: AGPL3.0-or-later
19  */
20 
32 #ifndef GNUNET_CREDENTIAL_SERVICE_H
33 #define GNUNET_CREDENTIAL_SERVICE_H
34 
35 #include "gnunet_util_lib.h"
36 #include "gnunet_gns_service.h"
38 
39 #ifdef __cplusplus
40 extern "C"
41 {
42 #if 0 /* keep Emacsens' auto-indent happy */
43 }
44 #endif
45 #endif
46 
47 
52 
57 
58 /*
59  * Enum used for checking whether the issuer has the authority to issue credentials or is just a subject
60  */
62  //Subject had credentials before, but have been revoked now
64 
65  //Subject flag indicates that the subject is a holder of this credential and may present it as such
67 
68  //Issuer flag is used to signify that the subject is allowed to issue this credential and delegate issuance
70 };
71 
80  uint32_t set_count;
81 
85  uint64_t data_size;
90 };
91 
100 
105 };
106 
107 
109 
118 
120 
124  const char *subject_attribute;
125 };
126 
127 
136 
141 
146 
150  const char *issuer_attribute;
151 
156 
160  const char *subject_attribute;
161 };
162 
163 
172 
177 
182 
187 
192 
196  const char *issuer_attribute;
197 };
198 
199 
200 
209 
210 
216 void
218 
219 
230  unsigned int d_count,
231  struct GNUNET_CREDENTIAL_Delegation *delegation_chain,
232  unsigned int c_count,
234 
242 typedef void (*GNUNET_CREDENTIAL_DelegateResultProcessor) (void *cls,
243  uint32_t success);
244 
253  uint32_t success);
254 
255 
277  const char *issuer_attribute,
279  uint32_t credential_count,
280  const struct GNUNET_CREDENTIAL_Credential *credentials,
282  void *proc_cls);
283 
287  const char *issuer_attribute,
290  void *proc_cls);
291 
306  struct GNUNET_IDENTITY_Ego *issuer,
307  const char *attribute,
308  struct GNUNET_CRYPTO_EcdsaPublicKey *subject,
309  const char *delegated_attribute,
311  void *proc_cls);
312 
325  struct GNUNET_IDENTITY_Ego *issuer,
326  const char *attribute,
328  void *proc_cls);
329 
330 
331 
343  struct GNUNET_CRYPTO_EcdsaPublicKey *subject,
344  const char *attribute,
346 
347 
348 
354 void
356 
357 
358 #if 0 /* keep Emacsens' auto-indent happy */
359 {
360 #endif
361 #ifdef __cplusplus
362 }
363 #endif
364 
365 #endif
366  /* end of group */
uint32_t subject_attribute_len
Length of the attribute.
const char * subject_attribute
The attribute.
const char * issuer_attribute
The attribute.
void(* GNUNET_CREDENTIAL_CredentialResultProcessor)(void *cls, unsigned int d_count, struct GNUNET_CREDENTIAL_Delegation *delegation_chain, unsigned int c_count, struct GNUNET_CREDENTIAL_Credential *credential)
Iterator called on obtained result for an attribute verification.
static char * expiration
Credential TTL.
void GNUNET_CREDENTIAL_request_cancel(struct GNUNET_CREDENTIAL_Request *lr)
Cancel pending lookup request.
static struct GNUNET_CREDENTIAL_Handle * credential
Handle to Credential service.
static struct GNUNET_GNS_LookupWithTldRequest * lr
Handle to lookup request.
Definition: gnunet-gns.c:75
static char * subject_key
Subject pubkey string.
Private ECC key encoded for transmission.
uint32_t set_count
Number of delegation sets in this record.
#define GNUNET_NETWORK_STRUCT_BEGIN
Define as empty, GNUNET_PACKED should suffice, but this won&#39;t work on W32.
void(* GNUNET_CREDENTIAL_RemoveDelegateResultProcessor)(void *cls, uint32_t success)
Iterator called on obtained result for an attribute delegation removal.
void GNUNET_CREDENTIAL_disconnect(struct GNUNET_CREDENTIAL_Handle *handle)
Shutdown connection with the Credentail service.
Handle for an ego.
Definition: identity.h:237
uint32_t subject_attribute_len
Length of attribute, may be 0.
uint32_t issuer_attribute_len
Length of the attribute.
struct GNUNET_CREDENTIAL_Handle * GNUNET_CREDENTIAL_connect(const struct GNUNET_CONFIGURATION_Handle *cfg)
Initialize the connection with the Credential service.
an ECC signature using ECDSA
GNUNET_CREDENTIAL_CredentialFlags
static struct GNUNET_DNS_Handle * handle
Handle to transport service.
Connection to the CREDENTIAL service.
const char * subject_attribute
The subject attribute.
struct GNUNET_CREDENTIAL_Request * GNUNET_CREDENTIAL_collect(struct GNUNET_CREDENTIAL_Handle *handle, const struct GNUNET_CRYPTO_EcdsaPublicKey *issuer_key, const char *issuer_attribute, const struct GNUNET_CRYPTO_EcdsaPrivateKey *subject_key, GNUNET_CREDENTIAL_CredentialResultProcessor proc, void *proc_cls)
Performs attribute collection.
static struct GNUNET_CONFIGURATION_Handle * cfg
Our configuration.
Definition: gnunet-arm.c:104
Handle to a verify request.
uint64_t data_size
Length of delegation sets.
struct GNUNET_CREDENTIAL_Request * GNUNET_CREDENTIAL_remove_delegation(struct GNUNET_CREDENTIAL_Handle *handle, struct GNUNET_IDENTITY_Ego *issuer, const char *attribute, GNUNET_CREDENTIAL_RemoveDelegateResultProcessor proc, void *proc_cls)
Remove a delegation.
static char * issuer_key
Issuer pubkey string.
struct GNUNET_CREDENTIAL_Request * GNUNET_CREDENTIAL_add_delegation(struct GNUNET_CREDENTIAL_Handle *handle, struct GNUNET_IDENTITY_Ego *issuer, const char *attribute, struct GNUNET_CRYPTO_EcdsaPublicKey *subject, const char *delegated_attribute, GNUNET_CREDENTIAL_DelegateResultProcessor proc, void *proc_cls)
Delegate an attribute.
#define GNUNET_NETWORK_STRUCT_END
Define as empty, GNUNET_PACKED should suffice, but this won&#39;t work on W32;.
const char * issuer_attribute
The attribute.
configuration data
Definition: configuration.c:83
The attribute delegation record.
Public ECC key (always for Curve25519) encoded in a format suitable for network transmission and ECDS...
struct GNUNET_CREDENTIAL_Credential * GNUNET_CREDENTIAL_credential_issue(const struct GNUNET_CRYPTO_EcdsaPrivateKey *issuer, struct GNUNET_CRYPTO_EcdsaPublicKey *subject, const char *attribute, struct GNUNET_TIME_Absolute *expiration)
Issue an attribute to a subject.
void * proc_cls
verify_proc closure
Time for absolute times used by GNUnet, in microseconds.
struct GNUNET_CREDENTIAL_Request * GNUNET_CREDENTIAL_verify(struct GNUNET_CREDENTIAL_Handle *handle, const struct GNUNET_CRYPTO_EcdsaPublicKey *issuer_key, const char *issuer_attribute, const struct GNUNET_CRYPTO_EcdsaPublicKey *subject_key, uint32_t credential_count, const struct GNUNET_CREDENTIAL_Credential *credentials, GNUNET_CREDENTIAL_CredentialResultProcessor proc, void *proc_cls)
Performs attribute verification.
void(* GNUNET_CREDENTIAL_DelegateResultProcessor)(void *cls, uint32_t success)
Iterator called on obtained result for an attribute delegation.
The attribute delegation record.
The attribute delegation record.
uint32_t issuer_attribute_len
Length of the attribute.