1323ec5712
Release notes are available at https://www.openssh.com/txt/release-8.9 Some highlights: * ssh(1), sshd(8), ssh-add(1), ssh-agent(1): add a system for restricting forwarding and use of keys added to ssh-agent(1) * ssh(1), sshd(8): add the sntrup761x25519-sha512@openssh.com hybrid ECDH/x25519 + Streamlined NTRU Prime post-quantum KEX to the default KEXAlgorithms list (after the ECDH methods but before the prime-group DH ones). The next release of OpenSSH is likely to make this key exchange the default method. * sshd(8), portable OpenSSH only: this release removes in-built support for MD5-hashed passwords. If you require these on your system then we recommend linking against libxcrypt or similar. Future deprecation notice ========================= A near-future release of OpenSSH will switch scp(1) from using the legacy scp/rcp protocol to using SFTP by default. Legacy scp/rcp performs wildcard expansion of remote filenames (e.g. "scp host:* .") through the remote shell. This has the side effect of requiring double quoting of shell meta-characters in file names included on scp(1) command-lines, otherwise they could be interpreted as shell commands on the remote side. MFC after: 1 month Relnotes: Yes Sponsored by: The FreeBSD Foundation
112 lines
4.0 KiB
C
112 lines
4.0 KiB
C
/* $OpenBSD: sshsig.h,v 1.11 2021/11/27 07:14:46 djm Exp $ */
|
|
/*
|
|
* Copyright (c) 2019 Google LLC
|
|
*
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#ifndef SSHSIG_H
|
|
#define SSHSIG_H
|
|
|
|
struct sshbuf;
|
|
struct sshkey;
|
|
struct sshsigopt;
|
|
struct sshkey_sig_details;
|
|
|
|
typedef int sshsig_signer(struct sshkey *, u_char **, size_t *,
|
|
const u_char *, size_t, const char *, const char *, const char *,
|
|
u_int, void *);
|
|
|
|
/* Buffer-oriented API */
|
|
|
|
/*
|
|
* Creates a detached SSH signature for a given buffer.
|
|
* Returns 0 on success or a negative SSH_ERR_* error code on failure.
|
|
* out is populated with the detached signature, or NULL on failure.
|
|
*/
|
|
int sshsig_signb(struct sshkey *key, const char *hashalg,
|
|
const char *sk_provider, const char *sk_pin, const struct sshbuf *message,
|
|
const char *sig_namespace, struct sshbuf **out,
|
|
sshsig_signer *signer, void *signer_ctx);
|
|
|
|
/*
|
|
* Verifies that a detached signature is valid and optionally returns key
|
|
* used to sign via argument.
|
|
* Returns 0 on success or a negative SSH_ERR_* error code on failure.
|
|
*/
|
|
int sshsig_verifyb(struct sshbuf *signature,
|
|
const struct sshbuf *message, const char *sig_namespace,
|
|
struct sshkey **sign_keyp, struct sshkey_sig_details **sig_details);
|
|
|
|
/* File/FD-oriented API */
|
|
|
|
/*
|
|
* Creates a detached SSH signature for a given file.
|
|
* Returns 0 on success or a negative SSH_ERR_* error code on failure.
|
|
* out is populated with the detached signature, or NULL on failure.
|
|
*/
|
|
int sshsig_sign_fd(struct sshkey *key, const char *hashalg,
|
|
const char *sk_provider, const char *sk_pin,
|
|
int fd, const char *sig_namespace,
|
|
struct sshbuf **out, sshsig_signer *signer, void *signer_ctx);
|
|
|
|
/*
|
|
* Verifies that a detached signature over a file is valid and optionally
|
|
* returns key used to sign via argument.
|
|
* Returns 0 on success or a negative SSH_ERR_* error code on failure.
|
|
*/
|
|
int sshsig_verify_fd(struct sshbuf *signature, int fd,
|
|
const char *sig_namespace, struct sshkey **sign_keyp,
|
|
struct sshkey_sig_details **sig_details);
|
|
|
|
/* Utility functions */
|
|
|
|
/*
|
|
* Return a base64 encoded "ASCII armoured" version of a raw signature.
|
|
*/
|
|
int sshsig_armor(const struct sshbuf *blob, struct sshbuf **out);
|
|
|
|
/*
|
|
* Decode a base64 encoded armoured signature to a raw signature.
|
|
*/
|
|
int sshsig_dearmor(struct sshbuf *sig, struct sshbuf **out);
|
|
|
|
/*
|
|
* Checks whether a particular key/principal/namespace is permitted by
|
|
* an allowed_keys file. Returns 0 on success.
|
|
*/
|
|
int sshsig_check_allowed_keys(const char *path, const struct sshkey *sign_key,
|
|
const char *principal, const char *ns, uint64_t verify_time);
|
|
|
|
/* Parse zero or more allowed_keys signature options */
|
|
struct sshsigopt *sshsigopt_parse(const char *opts,
|
|
const char *path, u_long linenum, const char **errstrp);
|
|
|
|
/* Free signature options */
|
|
void sshsigopt_free(struct sshsigopt *opts);
|
|
|
|
/* Get public key from signature */
|
|
int sshsig_get_pubkey(struct sshbuf *signature, struct sshkey **pubkey);
|
|
|
|
/* Find principal in allowed_keys file, given a sshkey. Returns
|
|
* 0 on success.
|
|
*/
|
|
int sshsig_find_principals(const char *path, const struct sshkey *sign_key,
|
|
uint64_t verify_time, char **principal);
|
|
|
|
/* Find all principals in allowed_keys file matching *principal */
|
|
int sshsig_match_principals(const char *path,
|
|
const char *principal, char ***principalsp, size_t *nprincipalsp);
|
|
|
|
#endif /* SSHSIG_H */
|