ctap.h

Go to the documentation of this file.

/*
 * Copyright (C) 2021 Freie Universität Berlin
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#ifndef FIDO2_CTAP_H
#define FIDO2_CTAP_H
 
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define CTAP_MAX_MSG_SIZE                   0x400
 
typedef enum {
    CTAP2_OK                            = 0x00,
    CTAP1_ERR_INVALID_COMMAND           = 0x01,
    CTAP1_ERR_INVALID_PARAMETER         = 0x02,
    CTAP1_ERR_INVALID_LENGTH            = 0x03,
    CTAP1_ERR_INVALID_SEQ               = 0x04,
    CTAP1_ERR_TIMEOUT                   = 0x05,
    CTAP1_ERR_CHANNEL_BUSY              = 0x06,
    CTAP1_ERR_LOCK_REQUIRED             = 0x0A,
    CTAP1_ERR_INVALID_CHANNEL           = 0x0B,
    CTAP2_ERR_CBOR_PARSING              = 0x10,
    CTAP2_ERR_CBOR_UNEXPECTED_TYPE      = 0x11,
    CTAP2_ERR_INVALID_CBOR              = 0x12,
    CTAP2_ERR_INVALID_CBOR_TYPE         = 0x13,
    CTAP2_ERR_MISSING_PARAMETER         = 0x14,
    CTAP2_ERR_LIMIT_EXCEEDED            = 0x15,
    CTAP2_ERR_UNSUPPORTED_EXTENSION     = 0x16,
    CTAP2_ERR_TOO_MANY_ELEMENTS         = 0x17,
    CTAP2_ERR_EXTENSION_NOT_SUPPORTED   = 0x18,
    CTAP2_ERR_CREDENTIAL_EXCLUDED       = 0x19,
    CTAP2_ERR_CREDENTIAL_NOT_VALID      = 0x20,
    CTAP2_ERR_PROCESSING                = 0x21,
    CTAP2_ERR_INVALID_CREDENTIAL        = 0x22,
    CTAP2_ERR_USER_ACTION_PENDING       = 0x23,
    CTAP2_ERR_OPERATION_PENDING         = 0x24,
    CTAP2_ERR_NO_OPERATIONS             = 0x25,
    CTAP2_ERR_UNSUPPORTED_ALGORITHM     = 0x26,
    CTAP2_ERR_OPERATION_DENIED          = 0x27,
    CTAP2_ERR_KEY_STORE_FULL            = 0x28,
    CTAP2_ERR_NOT_BUSY                  = 0x29,
    CTAP2_ERR_NO_OPERATION_PENDING      = 0x2A,
    CTAP2_ERR_UNSUPPORTED_OPTION        = 0x2B,
    CTAP2_ERR_INVALID_OPTION            = 0x2C,
    CTAP2_ERR_KEEPALIVE_CANCEL          = 0x2D,
    CTAP2_ERR_NO_CREDENTIALS            = 0x2E,
    CTAP2_ERR_USER_ACTION_TIMEOUT       = 0x2F,
    CTAP2_ERR_NOT_ALLOWED               = 0x30,
    CTAP2_ERR_PIN_INVALID               = 0x31,
    CTAP2_ERR_PIN_BLOCKED               = 0x32,
    CTAP2_ERR_PIN_AUTH_INVALID          = 0x33,
    CTAP2_ERR_PIN_AUTH_BLOCKED          = 0x34,
    CTAP2_ERR_PIN_NOT_SET               = 0x35,
    CTAP2_ERR_PIN_REQUIRED              = 0x36,
    CTAP2_ERR_PIN_POLICY_VIOLATION      = 0x37,
    CTAP2_ERR_PIN_TOKEN_EXPIRED         = 0x38,
    CTAP2_ERR_REQUEST_TOO_LARGE         = 0x39,
    CTAP2_ERR_ACTION_TIMEOUT            = 0x3A,
    CTAP2_ERR_UP_REQUIRED               = 0x3B,
    CTAP1_ERR_OTHER                     = 0x7F,
    CTAP2_ERR_SPEC_LAST                 = 0xDF,
    CTAP2_ERR_EXTENSION_FIRST           = 0xE0,
    CTAP2_ERR_EXTENSION_LAST            = 0xEF,
    CTAP2_ERR_VENDOR_FIRST              = 0xF0,
    CTAP2_ERR_VENDOR_LAST               = 0xFF
} ctap_status_code_t;
typedef enum {
    CTAP_MAKE_CREDENTIAL    =   0x01,
    CTAP_GET_ASSERTION      =   0x02,
    CTAP_GET_INFO           =   0x04,
    CTAP_CLIENT_PIN         =   0x06,
    CTAP_RESET              =   0x07,
    CTAP_GET_NEXT_ASSERTION =   0x08
} ctap_method_t;
typedef struct {
    uint8_t *buf;   
    size_t len;     
    uint8_t method; 
} ctap_req_t;
 
typedef struct {
    ctap_status_code_t status;          
    uint8_t data[CTAP_MAX_MSG_SIZE];    
    size_t len;                         
} ctap_resp_t;
 
ctap_status_code_t fido2_ctap_init(void);
 
ctap_status_code_t fido2_ctap_handle_request(ctap_req_t *req, ctap_resp_t *resp);
 
ctap_status_code_t fido2_ctap_make_credential(ctap_req_t *req, ctap_resp_t *resp);
 
ctap_status_code_t fido2_ctap_get_assertion(ctap_req_t *req, ctap_resp_t *resp);
 
ctap_status_code_t fido2_ctap_get_next_assertion(ctap_resp_t *resp);
 
ctap_status_code_t fido2_ctap_get_info(ctap_resp_t *resp);
 
ctap_status_code_t fido2_ctap_client_pin(ctap_req_t *req, ctap_resp_t *resp);
 
ctap_status_code_t fido2_ctap_reset(ctap_resp_t *resp);
 
#ifdef __cplusplus
}
#endif
#endif /* FIDO2_CTAP_H */