servconf.h revision 1.24
1/* $NetBSD: servconf.h,v 1.24 2021/03/05 17:47:16 christos Exp $ */ 2/* $OpenBSD: servconf.h,v 1.151 2021/01/26 05:32:21 dtucker Exp $ */ 3 4/* 5 * Author: Tatu Ylonen <ylo@cs.hut.fi> 6 * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland 7 * All rights reserved 8 * Definitions for server configuration data and for the functions reading it. 9 * 10 * As far as I am concerned, the code I have written for this software 11 * can be used freely for any purpose. Any derived versions of this 12 * software must be clearly marked as such, and if the derived work is 13 * incompatible with the protocol description in the RFC file, it must be 14 * called by a name other than "ssh" or "Secure Shell". 15 */ 16 17#ifndef SERVCONF_H 18#define SERVCONF_H 19 20#ifdef WITH_LDAP_PUBKEY 21#include "ldapauth.h" 22#endif 23 24#include <sys/queue.h> 25 26#define MAX_PORTS 256 /* Max # ports. */ 27 28#define MAX_SUBSYSTEMS 256 /* Max # subsystems. */ 29 30/* permit_root_login */ 31#define PERMIT_NOT_SET -1 32#define PERMIT_NO 0 33#define PERMIT_FORCED_ONLY 1 34#define PERMIT_NO_PASSWD 2 35#define PERMIT_YES 3 36 37/* use_privsep */ 38#define PRIVSEP_OFF 0 39#define PRIVSEP_ON 1 40#define PRIVSEP_NOSANDBOX 2 41 42/* PermitOpen */ 43#define PERMITOPEN_ANY 0 44#define PERMITOPEN_NONE -2 45 46/* IgnoreRhosts */ 47#define IGNORE_RHOSTS_NO 0 48#define IGNORE_RHOSTS_YES 1 49#define IGNORE_RHOSTS_SHOSTS 2 50 51#define DEFAULT_AUTH_FAIL_MAX 6 /* Default for MaxAuthTries */ 52#define DEFAULT_SESSIONS_MAX 10 /* Default for MaxSessions */ 53 54/* Magic name for internal sftp-server */ 55#define INTERNAL_SFTP_NAME "internal-sftp" 56 57/* PubkeyAuthOptions flags */ 58#define PUBKEYAUTH_TOUCH_REQUIRED (1) 59#define PUBKEYAUTH_VERIFY_REQUIRED (1<<1) 60 61struct ssh; 62struct fwd_perm_list; 63 64/* 65 * Used to store addresses from ListenAddr directives. These may be 66 * incomplete, as they may specify addresses that need to be merged 67 * with any ports requested by ListenPort. 68 */ 69struct queued_listenaddr { 70 char *addr; 71 int port; /* <=0 if unspecified */ 72 char *rdomain; 73}; 74 75/* Resolved listen addresses, grouped by optional routing domain */ 76struct listenaddr { 77 char *rdomain; 78 struct addrinfo *addrs; 79}; 80 81typedef struct { 82 u_int num_ports; 83 u_int ports_from_cmdline; 84 int ports[MAX_PORTS]; /* Port number to listen on. */ 85 struct queued_listenaddr *queued_listen_addrs; 86 u_int num_queued_listens; 87 struct listenaddr *listen_addrs; 88 u_int num_listen_addrs; 89 int address_family; /* Address family used by the server. */ 90 91 char *routing_domain; /* Bind session to routing domain */ 92 93 char **host_key_files; /* Files containing host keys. */ 94 int *host_key_file_userprovided; /* Key was specified by user. */ 95 u_int num_host_key_files; /* Number of files for host keys. */ 96 char **host_cert_files; /* Files containing host certs. */ 97 u_int num_host_cert_files; /* Number of files for host certs. */ 98 99 char *host_key_agent; /* ssh-agent socket for host keys. */ 100 char *pid_file; /* Where to put our pid */ 101 int login_grace_time; /* Disconnect if no auth in this time 102 * (sec). */ 103 int permit_root_login; /* PERMIT_*, see above */ 104 int ignore_rhosts; /* Ignore .rhosts and .shosts. */ 105 int ignore_root_rhosts; /* Ignore .rhosts and .shosts for root; 106 defaults to ignore_rhosts if not 107 given. */ 108 int ignore_user_known_hosts; /* Ignore ~/.ssh/known_hosts 109 * for RhostsRsaAuth */ 110 int print_motd; /* If true, print /etc/motd. */ 111 int print_lastlog; /* If true, print lastlog */ 112 int x11_forwarding; /* If true, permit inet (spoofing) X11 fwd. */ 113 int x11_display_offset; /* What DISPLAY number to start 114 * searching at */ 115 int x11_use_localhost; /* If true, use localhost for fake X11 server. */ 116 char *xauth_location; /* Location of xauth program */ 117 int permit_tty; /* If false, deny pty allocation */ 118 int permit_user_rc; /* If false, deny ~/.ssh/rc execution */ 119 int strict_modes; /* If true, require string home dir modes. */ 120 int tcp_keep_alive; /* If true, set SO_KEEPALIVE. */ 121 int ip_qos_interactive; /* IP ToS/DSCP/class for interactive */ 122 int ip_qos_bulk; /* IP ToS/DSCP/class for bulk traffic */ 123 char *ciphers; /* Supported SSH2 ciphers. */ 124 char *macs; /* Supported SSH2 macs. */ 125 char *kex_algorithms; /* SSH2 kex methods in order of preference. */ 126 struct ForwardOptions fwd_opts; /* forwarding options */ 127 SyslogFacility log_facility; /* Facility for system logging. */ 128 LogLevel log_level; /* Level for system logging. */ 129 u_int num_log_verbose; /* Verbose log overrides */ 130 char **log_verbose; 131 int hostbased_authentication; /* If true, permit ssh2 hostbased auth */ 132 int hostbased_uses_name_from_packet_only; /* experimental */ 133 char *hostbased_accepted_algos; /* Algos allowed for hostbased */ 134 char *hostkeyalgorithms; /* SSH2 server key types */ 135 char *ca_sign_algorithms; /* Allowed CA signature algorithms */ 136 int pubkey_authentication; /* If true, permit ssh2 pubkey authentication. */ 137 char *pubkey_accepted_algos; /* Signature algos allowed for pubkey */ 138 int pubkey_auth_options; /* -1 or mask of PUBKEYAUTH_* flags */ 139 int kerberos_authentication; /* If true, permit Kerberos 140 * authentication. */ 141 int kerberos_or_local_passwd; /* If true, permit kerberos 142 * and any other password 143 * authentication mechanism, 144 * such as SecurID or 145 * /etc/passwd */ 146 int kerberos_ticket_cleanup; /* If true, destroy ticket 147 * file on logout. */ 148 int kerberos_tgt_passing; /* If true, permit Kerberos TGT 149 * passing. */ 150 int kerberos_get_afs_token; /* If true, try to get AFS token if 151 * authenticated with Kerberos. */ 152#ifdef AFS 153 int afs_token_passing; /* If true, permit AFS token passing. */ 154#endif 155 int gss_authentication; /* If true, permit GSSAPI authentication */ 156 int gss_cleanup_creds; /* If true, destroy cred cache on logout */ 157 int gss_strict_acceptor; /* If true, restrict the GSSAPI acceptor name */ 158 int password_authentication; /* If true, permit password 159 * authentication. */ 160 int kbd_interactive_authentication; /* If true, permit */ 161 int challenge_response_authentication; 162 int permit_empty_passwd; /* If false, do not permit empty 163 * passwords. */ 164 int permit_user_env; /* If true, read ~/.ssh/environment */ 165 char *permit_user_env_allowlist; /* pattern-list of allowed env names */ 166 int compression; /* If true, compression is allowed */ 167 int allow_tcp_forwarding; /* One of FORWARD_* */ 168 int allow_streamlocal_forwarding; /* One of FORWARD_* */ 169 int allow_agent_forwarding; 170 int disable_forwarding; 171 u_int num_allow_users; 172 char **allow_users; 173 u_int num_deny_users; 174 char **deny_users; 175 u_int num_allow_groups; 176 char **allow_groups; 177 u_int num_deny_groups; 178 char **deny_groups; 179 180 u_int num_subsystems; 181 char *subsystem_name[MAX_SUBSYSTEMS]; 182 char *subsystem_command[MAX_SUBSYSTEMS]; 183 char *subsystem_args[MAX_SUBSYSTEMS]; 184 185 u_int num_accept_env; 186 char **accept_env; 187 u_int num_setenv; 188 char **setenv; 189 190 int max_startups_begin; 191 int max_startups_rate; 192 int max_startups; 193 int per_source_max_startups; 194 int per_source_masklen_ipv4; 195 int per_source_masklen_ipv6; 196 int max_authtries; 197 int max_sessions; 198 char *banner; /* SSH-2 banner message */ 199 int use_dns; 200 int client_alive_interval; /* 201 * poke the client this often to 202 * see if it's still there 203 */ 204 int client_alive_count_max; /* 205 * If the client is unresponsive 206 * for this many intervals above, 207 * disconnect the session 208 */ 209 210 u_int num_authkeys_files; /* Files containing public keys */ 211 char **authorized_keys_files; 212 213 int use_pam; /* Enable auth via PAM */ 214 int none_enabled; /* enable NONE cipher switch */ 215 int tcp_rcv_buf_poll; /* poll tcp rcv window in autotuning kernels*/ 216 int hpn_disabled; /* disable hpn functionality. false by default */ 217 int hpn_buffer_size; /* set the hpn buffer size - default 3MB */ 218 219 char *adm_forced_command; 220 221 int permit_tun; 222#ifdef WITH_LDAP_PUBKEY 223 ldap_opt_t lpk; 224#endif 225 226 char **permitted_opens; /* May also be one of PERMITOPEN_* */ 227 u_int num_permitted_opens; 228 char **permitted_listens; /* May also be one of PERMITOPEN_* */ 229 u_int num_permitted_listens; 230 231 char *chroot_directory; 232 char *revoked_keys_file; 233 char *trusted_user_ca_keys; 234 char *authorized_keys_command; 235 char *authorized_keys_command_user; 236 char *authorized_principals_file; 237 char *authorized_principals_command; 238 char *authorized_principals_command_user; 239 240 int64_t rekey_limit; 241 int rekey_interval; 242 243 char *version_addendum; /* Appended to SSH banner */ 244 245 u_int num_auth_methods; 246 char **auth_methods; 247 248 int fingerprint_hash; 249 int expose_userauth_info; 250 u_int64_t timing_secret; 251 char *sk_provider; 252} ServerOptions; 253 254/* Information about the incoming connection as used by Match */ 255struct connection_info { 256 const char *user; 257 const char *host; /* possibly resolved hostname */ 258 const char *address; /* remote address */ 259 const char *laddress; /* local address */ 260 int lport; /* local port */ 261 const char *rdomain; /* routing domain if available */ 262 int test; /* test mode, allow some attributes to be 263 * unspecified */ 264}; 265 266/* List of included files for re-exec from the parsed configuration */ 267struct include_item { 268 char *selector; 269 char *filename; 270 struct sshbuf *contents; 271 TAILQ_ENTRY(include_item) entry; 272}; 273TAILQ_HEAD(include_list, include_item); 274 275 276/* 277 * These are string config options that must be copied between the 278 * Match sub-config and the main config, and must be sent from the 279 * privsep child to the privsep master. We use a macro to ensure all 280 * the options are copied and the copies are done in the correct order. 281 * 282 * NB. an option must appear in servconf.c:copy_set_server_options() or 283 * COPY_MATCH_STRING_OPTS here but never both. 284 */ 285#define COPY_MATCH_STRING_OPTS() do { \ 286 M_CP_STROPT(banner); \ 287 M_CP_STROPT(trusted_user_ca_keys); \ 288 M_CP_STROPT(revoked_keys_file); \ 289 M_CP_STROPT(authorized_keys_command); \ 290 M_CP_STROPT(authorized_keys_command_user); \ 291 M_CP_STROPT(authorized_principals_file); \ 292 M_CP_STROPT(authorized_principals_command); \ 293 M_CP_STROPT(authorized_principals_command_user); \ 294 M_CP_STROPT(hostbased_accepted_algos); \ 295 M_CP_STROPT(pubkey_accepted_algos); \ 296 M_CP_STROPT(ca_sign_algorithms); \ 297 M_CP_STROPT(routing_domain); \ 298 M_CP_STROPT(permit_user_env_allowlist); \ 299 M_CP_STRARRAYOPT(authorized_keys_files, num_authkeys_files); \ 300 M_CP_STRARRAYOPT(allow_users, num_allow_users); \ 301 M_CP_STRARRAYOPT(deny_users, num_deny_users); \ 302 M_CP_STRARRAYOPT(allow_groups, num_allow_groups); \ 303 M_CP_STRARRAYOPT(deny_groups, num_deny_groups); \ 304 M_CP_STRARRAYOPT(accept_env, num_accept_env); \ 305 M_CP_STRARRAYOPT(setenv, num_setenv); \ 306 M_CP_STRARRAYOPT(auth_methods, num_auth_methods); \ 307 M_CP_STRARRAYOPT(permitted_opens, num_permitted_opens); \ 308 M_CP_STRARRAYOPT(permitted_listens, num_permitted_listens); \ 309 M_CP_STRARRAYOPT(log_verbose, num_log_verbose); \ 310 } while (0) 311 312struct connection_info *get_connection_info(struct ssh *, int, int); 313void initialize_server_options(ServerOptions *); 314void fill_default_server_options(ServerOptions *); 315int process_server_config_line(ServerOptions *, char *, const char *, int, 316 int *, struct connection_info *, struct include_list *includes); 317void process_permitopen(struct ssh *ssh, ServerOptions *options); 318void load_server_config(const char *, struct sshbuf *); 319void parse_server_config(ServerOptions *, const char *, struct sshbuf *, 320 struct include_list *includes, struct connection_info *); 321void parse_server_match_config(ServerOptions *, 322 struct include_list *includes, struct connection_info *); 323int parse_server_match_testspec(struct connection_info *, char *); 324int server_match_spec_complete(struct connection_info *); 325void copy_set_server_options(ServerOptions *, ServerOptions *, int); 326void dump_config(ServerOptions *); 327char *derelativise_path(const char *); 328void servconf_add_hostkey(const char *, const int, 329 ServerOptions *, const char *path, int); 330void servconf_add_hostcert(const char *, const int, 331 ServerOptions *, const char *path); 332 333#endif /* SERVCONF_H */ 334