Annotation of src/usr.bin/ssh/ssh-sk.h, Revision 1.4
1.4 ! markus 1: /* $OpenBSD: ssh-sk.h,v 1.3 2019/11/12 19:30:50 markus Exp $ */
1.1 djm 2: /*
3: * Copyright (c) 2019 Google LLC
4: *
5: * Permission to use, copy, modify, and distribute this software for any
6: * purpose with or without fee is hereby granted, provided that the above
7: * copyright notice and this permission notice appear in all copies.
8: *
9: * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16: */
17:
18: #ifndef _SSH_SK_H
19: #define _SSH_SK_H 1
20:
21: struct sshbuf;
22: struct sshkey;
1.2 djm 23:
24: /* Version of protocol between ssh-agent and ssh-sk-helper */
25: #define SSH_SK_HELPER_VERSION 1
1.1 djm 26:
27: /*
28: * Enroll (generate) a new security-key hosted private key via the specified
29: * provider middleware.
30: * If challenge_buf is NULL then a random 256 bit challenge will be used.
31: *
32: * Returns 0 on success or a ssherr.h error code on failure.
33: *
34: * If successful and the attest_data buffer is not NULL then attestation
35: * information is placed there.
36: */
37: int sshsk_enroll(const char *provider_path, const char *application,
38: uint8_t flags, struct sshbuf *challenge_buf, struct sshkey **keyp,
39: struct sshbuf *attest);
40:
41: /*
1.4 ! markus 42: * Calculate an ECDSA_SK or ED25519_SK signature using the specified key
1.3 markus 43: * and provider middleware.
1.1 djm 44: *
45: * Returns 0 on success or a ssherr.h error code on failure.
46: */
1.3 markus 47: int sshsk_sign(const char *provider_path, const struct sshkey *key,
1.1 djm 48: u_char **sigp, size_t *lenp, const u_char *data, size_t datalen,
49: u_int compat);
50:
51: #endif /* _SSH_SK_H */
52: