Home | History | Annotate | Line # | Download | only in fido 
      1 /*
      2  * Copyright (c) 2019-2021 Yubico AB. All rights reserved.
      3  * SPDX-License-Identifier: BSD-2-Clause
      4  *
      5  * Redistribution and use in source and binary forms, with or without
      6  * modification, are permitted provided that the following conditions are
      7  * met:
      8  *
      9  *    1. Redistributions of source code must retain the above copyright
     10  *       notice, this list of conditions and the following disclaimer.
     11  *    2. Redistributions in binary form must reproduce the above copyright
     12  *       notice, this list of conditions and the following disclaimer in
     13  *       the documentation and/or other materials provided with the
     14  *       distribution.
     15  *
     16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     17  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     18  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     19  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     20  * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     21  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     22  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     26  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     27  */
     28 
     29 #ifndef _FIDO_CREDMAN_H
     30 #define _FIDO_CREDMAN_H
     31 
     32 #include <stdint.h>
     33 #include <stdlib.h>
     34 
     35 #ifdef _FIDO_INTERNAL
     36 #include "blob.h"
     37 #include "fido/err.h"
     38 #include "fido/param.h"
     39 #include "fido/types.h"
     40 #else
     41 #include <fido.h>
     42 #include <fido/err.h>
     43 #include <fido/param.h>
     44 #endif
     45 
     46 #ifdef __cplusplus
     47 extern "C" {
     48 #endif /* __cplusplus */
     49 
     50 #ifdef _FIDO_INTERNAL
     51 struct fido_credman_metadata {
     52 	uint64_t rk_existing;
     53 	uint64_t rk_remaining;
     54 };
     55 
     56 struct fido_credman_single_rp {
     57 	fido_rp_t rp_entity;
     58 	fido_blob_t rp_id_hash;
     59 };
     60 
     61 struct fido_credman_rp {
     62 	struct fido_credman_single_rp *ptr;
     63 	size_t n_alloc; /* number of allocated entries */
     64 	size_t n_rx;    /* number of populated entries */
     65 };
     66 
     67 struct fido_credman_rk {
     68 	fido_cred_t *ptr;
     69 	size_t n_alloc; /* number of allocated entries */
     70 	size_t n_rx;    /* number of populated entries */
     71 };
     72 #endif
     73 
     74 typedef struct fido_credman_metadata fido_credman_metadata_t;
     75 typedef struct fido_credman_rk fido_credman_rk_t;
     76 typedef struct fido_credman_rp fido_credman_rp_t;
     77 
     78 const char *fido_credman_rp_id(const fido_credman_rp_t *, size_t);
     79 const char *fido_credman_rp_name(const fido_credman_rp_t *, size_t);
     80 
     81 const fido_cred_t *fido_credman_rk(const fido_credman_rk_t *, size_t);
     82 const unsigned char *fido_credman_rp_id_hash_ptr(const fido_credman_rp_t *,
     83     size_t);
     84 
     85 fido_credman_metadata_t *fido_credman_metadata_new(void);
     86 fido_credman_rk_t *fido_credman_rk_new(void);
     87 fido_credman_rp_t *fido_credman_rp_new(void);
     88 
     89 int fido_credman_del_dev_rk(fido_dev_t *, const unsigned char *, size_t,
     90     const char *);
     91 int fido_credman_get_dev_metadata(fido_dev_t *, fido_credman_metadata_t *,
     92     const char *);
     93 int fido_credman_get_dev_rk(fido_dev_t *, const char *, fido_credman_rk_t *,
     94     const char *);
     95 int fido_credman_get_dev_rp(fido_dev_t *, fido_credman_rp_t *, const char *);
     96 int fido_credman_set_dev_rk(fido_dev_t *, fido_cred_t *, const char *);
     97 
     98 size_t fido_credman_rk_count(const fido_credman_rk_t *);
     99 size_t fido_credman_rp_count(const fido_credman_rp_t *);
    100 size_t fido_credman_rp_id_hash_len(const fido_credman_rp_t *, size_t);
    101 
    102 uint64_t fido_credman_rk_existing(const fido_credman_metadata_t *);
    103 uint64_t fido_credman_rk_remaining(const fido_credman_metadata_t *);
    104 
    105 void fido_credman_metadata_free(fido_credman_metadata_t **);
    106 void fido_credman_rk_free(fido_credman_rk_t **);
    107 void fido_credman_rp_free(fido_credman_rp_t **);
    108 
    109 #ifdef __cplusplus
    110 } /* extern "C" */
    111 #endif /* __cplusplus */
    112 
    113 #endif /* !_FIDO_CREDMAN_H */
    114