blob: 68fcdb76414fbcbfda9c48b9d7201f28a939227e [file] [log] [blame]
Damien Millera6e3f012012-11-04 23:21:40 +11001/* $OpenBSD: servconf.h,v 1.105 2012/11/04 11:09:15 djm Exp $ */
Ben Lindstrom05764b92002-03-05 01:53:02 +00002
Damien Millerd4a8b7e1999-10-27 13:42:43 +10003/*
Damien Miller95def091999-11-25 00:26:21 +11004 * Author: Tatu Ylonen <ylo@cs.hut.fi>
Damien Miller95def091999-11-25 00:26:21 +11005 * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
6 * All rights reserved
Damien Miller95def091999-11-25 00:26:21 +11007 * Definitions for server configuration data and for the functions reading it.
Damien Miller4af51302000-04-16 11:18:38 +10008 *
Damien Millere4340be2000-09-16 13:29:08 +11009 * As far as I am concerned, the code I have written for this software
10 * can be used freely for any purpose. Any derived versions of this
11 * software must be clearly marked as such, and if the derived work is
12 * incompatible with the protocol description in the RFC file, it must be
13 * called by a name other than "ssh" or "Secure Shell".
Damien Miller95def091999-11-25 00:26:21 +110014 */
Damien Millerd4a8b7e1999-10-27 13:42:43 +100015
Damien Millerd4a8b7e1999-10-27 13:42:43 +100016#ifndef SERVCONF_H
17#define SERVCONF_H
18
Damien Miller34132e52000-01-14 15:45:46 +110019#define MAX_PORTS 256 /* Max # ports. */
20
Damien Miller95def091999-11-25 00:26:21 +110021#define MAX_ALLOW_USERS 256 /* Max # users on allow list. */
22#define MAX_DENY_USERS 256 /* Max # users on deny list. */
23#define MAX_ALLOW_GROUPS 256 /* Max # groups on allow list. */
24#define MAX_DENY_GROUPS 256 /* Max # groups on deny list. */
Damien Millerf6d9e222000-06-18 14:50:44 +100025#define MAX_SUBSYSTEMS 256 /* Max # subsystems. */
Damien Miller0bc1bd82000-11-13 22:57:25 +110026#define MAX_HOSTKEYS 256 /* Max # hostkeys. */
Damien Miller0a80ca12010-02-27 07:55:05 +110027#define MAX_HOSTCERTS 256 /* Max # host certificates. */
Darren Tucker46bc0752004-05-02 22:11:30 +100028#define MAX_ACCEPT_ENV 256 /* Max # of env vars. */
Damien Miller565ca3f2006-08-19 00:23:15 +100029#define MAX_MATCH_GROUPS 256 /* Max # of groups for Match. */
Damien Millerd8478b62011-05-29 21:39:36 +100030#define MAX_AUTHKEYS_FILES 256 /* Max # of authorized_keys files. */
Damien Millera6e3f012012-11-04 23:21:40 +110031#define MAX_AUTH_METHODS 256 /* Max # of AuthenticationMethods. */
Damien Millerd4a8b7e1999-10-27 13:42:43 +100032
Ben Lindstromd8a90212001-02-15 03:08:27 +000033/* permit_root_login */
34#define PERMIT_NOT_SET -1
35#define PERMIT_NO 0
36#define PERMIT_FORCED_ONLY 1
37#define PERMIT_NO_PASSWD 2
38#define PERMIT_YES 3
39
Damien Miller69ff1df2011-06-23 08:30:03 +100040/* use_privsep */
41#define PRIVSEP_OFF 0
42#define PRIVSEP_ON 1
Damien Miller5a5c2b92012-07-31 12:21:34 +100043#define PRIVSEP_NOSANDBOX 2
Damien Miller69ff1df2011-06-23 08:30:03 +100044
Darren Tucker89413db2004-05-24 10:36:23 +100045#define DEFAULT_AUTH_FAIL_MAX 6 /* Default for MaxAuthTries */
Damien Miller7207f642008-05-19 15:34:50 +100046#define DEFAULT_SESSIONS_MAX 10 /* Default for MaxSessions */
Ben Lindstromd8a90212001-02-15 03:08:27 +000047
Damien Miller76e95da2008-03-07 18:31:24 +110048/* Magic name for internal sftp-server */
49#define INTERNAL_SFTP_NAME "internal-sftp"
50
Damien Miller95def091999-11-25 00:26:21 +110051typedef struct {
Damien Miller3dc71ad2009-01-28 16:31:22 +110052 u_int num_ports;
53 u_int ports_from_cmdline;
54 int ports[MAX_PORTS]; /* Port number to listen on. */
Damien Miller34132e52000-01-14 15:45:46 +110055 char *listen_addr; /* Address on which the server listens. */
56 struct addrinfo *listen_addrs; /* Addresses on which the server listens. */
Darren Tucker0f383232005-01-20 10:57:56 +110057 int address_family; /* Address family used by the server. */
Damien Miller0bc1bd82000-11-13 22:57:25 +110058 char *host_key_files[MAX_HOSTKEYS]; /* Files containing host keys. */
59 int num_host_key_files; /* Number of files for host keys. */
Damien Miller0a80ca12010-02-27 07:55:05 +110060 char *host_cert_files[MAX_HOSTCERTS]; /* Files containing host certs. */
61 int num_host_cert_files; /* Number of files for host certs. */
Damien Miller6f83b8e2000-05-02 09:23:45 +100062 char *pid_file; /* Where to put our pid */
Damien Miller95def091999-11-25 00:26:21 +110063 int server_key_bits;/* Size of the server key. */
64 int login_grace_time; /* Disconnect if no auth in this time
65 * (sec). */
66 int key_regeneration_time; /* Server key lifetime (seconds). */
Ben Lindstromd8a90212001-02-15 03:08:27 +000067 int permit_root_login; /* PERMIT_*, see above */
Damien Miller95def091999-11-25 00:26:21 +110068 int ignore_rhosts; /* Ignore .rhosts and .shosts. */
69 int ignore_user_known_hosts; /* Ignore ~/.ssh/known_hosts
70 * for RhostsRsaAuth */
71 int print_motd; /* If true, print /etc/motd. */
Ben Lindstrom7bfff362001-03-26 05:45:53 +000072 int print_lastlog; /* If true, print lastlog */
Damien Miller95def091999-11-25 00:26:21 +110073 int x11_forwarding; /* If true, permit inet (spoofing) X11 fwd. */
74 int x11_display_offset; /* What DISPLAY number to start
75 * searching at */
Damien Miller95c249f2002-02-05 12:11:34 +110076 int x11_use_localhost; /* If true, use localhost for fake X11 server. */
Damien Millerd3a18572000-06-07 19:55:44 +100077 char *xauth_location; /* Location of xauth program */
Damien Miller95def091999-11-25 00:26:21 +110078 int strict_modes; /* If true, require string home dir modes. */
Damien Miller12c150e2003-12-17 16:31:10 +110079 int tcp_keep_alive; /* If true, set SO_KEEPALIVE. */
Damien Miller0dac6fb2010-11-20 15:19:38 +110080 int ip_qos_interactive; /* IP ToS/DSCP/class for interactive */
81 int ip_qos_bulk; /* IP ToS/DSCP/class for bulk traffic */
Ben Lindstrom06b33aa2001-02-15 03:01:59 +000082 char *ciphers; /* Supported SSH2 ciphers. */
83 char *macs; /* Supported SSH2 macs. */
Damien Millerd5f62bf2010-09-24 22:11:14 +100084 char *kex_algorithms; /* SSH2 kex methods in order of preference. */
Ben Lindstrom06b33aa2001-02-15 03:01:59 +000085 int protocol; /* Supported protocol versions. */
Damien Millere247cc42000-05-07 12:03:14 +100086 int gateway_ports; /* If true, allow remote connects to forwarded ports. */
Damien Miller95def091999-11-25 00:26:21 +110087 SyslogFacility log_facility; /* Facility for system logging. */
88 LogLevel log_level; /* Level for system logging. */
Damien Miller95def091999-11-25 00:26:21 +110089 int rhosts_rsa_authentication; /* If true, permit rhosts RSA
90 * authentication. */
Ben Lindstrom5eabda32001-04-12 23:34:34 +000091 int hostbased_authentication; /* If true, permit ssh2 hostbased auth */
92 int hostbased_uses_name_from_packet_only; /* experimental */
Damien Miller95def091999-11-25 00:26:21 +110093 int rsa_authentication; /* If true, permit RSA authentication. */
Damien Miller0bc1bd82000-11-13 22:57:25 +110094 int pubkey_authentication; /* If true, permit ssh2 pubkey authentication. */
Damien Miller95def091999-11-25 00:26:21 +110095 int kerberos_authentication; /* If true, permit Kerberos
96 * authentication. */
97 int kerberos_or_local_passwd; /* If true, permit kerberos
98 * and any other password
99 * authentication mechanism,
100 * such as SecurID or
101 * /etc/passwd */
102 int kerberos_ticket_cleanup; /* If true, destroy ticket
103 * file on logout. */
Darren Tucker22ef5082003-12-31 11:37:34 +1100104 int kerberos_get_afs_token; /* If true, try to get AFS token if
105 * authenticated with Kerberos. */
Darren Tucker0efd1552003-08-26 11:49:55 +1000106 int gss_authentication; /* If true, permit GSSAPI authentication */
107 int gss_cleanup_creds; /* If true, destroy cred cache on logout */
Damien Miller95def091999-11-25 00:26:21 +1100108 int password_authentication; /* If true, permit password
109 * authentication. */
Damien Miller874d77b2000-10-14 16:23:11 +1100110 int kbd_interactive_authentication; /* If true, permit */
Ben Lindstrom551ea372001-06-05 18:56:16 +0000111 int challenge_response_authentication;
Damien Miller01ed2272008-11-05 16:20:46 +1100112 int zero_knowledge_password_authentication;
113 /* If true, permit jpake auth */
Damien Miller95def091999-11-25 00:26:21 +1100114 int permit_empty_passwd; /* If false, do not permit empty
115 * passwords. */
Ben Lindstrom5d860f02002-08-01 01:28:38 +0000116 int permit_user_env; /* If true, read ~/.ssh/environment */
Damien Miller95def091999-11-25 00:26:21 +1100117 int use_login; /* If true, login(1) is used */
Ben Lindstrom23e0f662002-06-21 01:09:47 +0000118 int compression; /* If true, compression is allowed */
Damien Miller50a41ed2000-10-16 12:14:42 +1100119 int allow_tcp_forwarding;
Damien Miller4f755cd2008-05-19 14:57:41 +1000120 int allow_agent_forwarding;
Ben Lindstrom46c16222000-12-22 01:43:59 +0000121 u_int num_allow_users;
Damien Miller95def091999-11-25 00:26:21 +1100122 char *allow_users[MAX_ALLOW_USERS];
Ben Lindstrom46c16222000-12-22 01:43:59 +0000123 u_int num_deny_users;
Damien Miller95def091999-11-25 00:26:21 +1100124 char *deny_users[MAX_DENY_USERS];
Ben Lindstrom46c16222000-12-22 01:43:59 +0000125 u_int num_allow_groups;
Damien Miller95def091999-11-25 00:26:21 +1100126 char *allow_groups[MAX_ALLOW_GROUPS];
Ben Lindstrom46c16222000-12-22 01:43:59 +0000127 u_int num_deny_groups;
Damien Miller95def091999-11-25 00:26:21 +1100128 char *deny_groups[MAX_DENY_GROUPS];
Damien Millerf6d9e222000-06-18 14:50:44 +1000129
Ben Lindstrom46c16222000-12-22 01:43:59 +0000130 u_int num_subsystems;
Damien Millerf6d9e222000-06-18 14:50:44 +1000131 char *subsystem_name[MAX_SUBSYSTEMS];
132 char *subsystem_command[MAX_SUBSYSTEMS];
Damien Miller917f9b62006-07-10 20:36:47 +1000133 char *subsystem_args[MAX_SUBSYSTEMS];
Damien Miller37023962000-07-11 17:31:38 +1000134
Darren Tucker46bc0752004-05-02 22:11:30 +1000135 u_int num_accept_env;
136 char *accept_env[MAX_ACCEPT_ENV];
137
Damien Miller942da032000-08-18 13:59:06 +1000138 int max_startups_begin;
139 int max_startups_rate;
Damien Miller37023962000-07-11 17:31:38 +1000140 int max_startups;
Darren Tucker89413db2004-05-24 10:36:23 +1000141 int max_authtries;
Damien Miller7207f642008-05-19 15:34:50 +1000142 int max_sessions;
Ben Lindstrom48bd7c12001-01-09 00:35:42 +0000143 char *banner; /* SSH-2 banner message */
Damien Miller3a961dc2003-06-03 10:25:48 +1000144 int use_dns;
Ben Lindstrom5744dc42001-04-13 23:28:01 +0000145 int client_alive_interval; /*
Damien Miller9f0f5c62001-12-21 14:45:46 +1100146 * poke the client this often to
147 * see if it's still there
Ben Lindstrom5744dc42001-04-13 23:28:01 +0000148 */
149 int client_alive_count_max; /*
Ben Lindstrom7bb37b22001-09-12 16:40:05 +0000150 * If the client is unresponsive
151 * for this many intervals above,
Damien Miller9f0f5c62001-12-21 14:45:46 +1100152 * disconnect the session
Ben Lindstrom5744dc42001-04-13 23:28:01 +0000153 */
Kevin Stevese468de62001-07-04 18:37:20 +0000154
Damien Millerd8478b62011-05-29 21:39:36 +1000155 u_int num_authkeys_files; /* Files containing public keys */
156 char *authorized_keys_files[MAX_AUTHKEYS_FILES];
Damien Millerd27b9472005-12-13 19:29:02 +1100157
Damien Millere2754432006-07-24 14:06:47 +1000158 char *adm_forced_command;
159
Damien Miller4e448a32003-05-14 15:11:48 +1000160 int use_pam; /* Enable auth via PAM */
Damien Millerd27b9472005-12-13 19:29:02 +1100161
162 int permit_tun;
Damien Millera765cf42006-07-24 14:08:13 +1000163
164 int num_permitted_opens;
Damien Millerd8cb1f12008-02-10 22:40:12 +1100165
166 char *chroot_directory;
Damien Miller1aed65e2010-03-04 21:53:35 +1100167 char *revoked_keys_file;
168 char *trusted_user_ca_keys;
Damien Miller30da3442010-05-10 11:58:03 +1000169 char *authorized_principals_file;
Damien Miller09d3e122012-10-31 08:58:58 +1100170 char *authorized_keys_command;
171 char *authorized_keys_command_user;
Damien Miller23528812012-04-22 11:24:43 +1000172
173 char *version_addendum; /* Appended to SSH banner */
Damien Millera6e3f012012-11-04 23:21:40 +1100174
175 u_int num_auth_methods;
176 char *auth_methods[MAX_AUTH_METHODS];
Damien Miller95def091999-11-25 00:26:21 +1100177} ServerOptions;
Damien Millerd4a8b7e1999-10-27 13:42:43 +1000178
Darren Tuckerfbcf8272012-05-19 19:37:01 +1000179/* Information about the incoming connection as used by Match */
180struct connection_info {
181 const char *user;
182 const char *host; /* possibly resolved hostname */
183 const char *address; /* remote address */
184 const char *laddress; /* local address */
185 int lport; /* local port */
186};
187
188
Damien Millerf2e407e2011-05-20 19:04:14 +1000189/*
190 * These are string config options that must be copied between the
191 * Match sub-config and the main config, and must be sent from the
192 * privsep slave to the privsep master. We use a macro to ensure all
193 * the options are copied and the copies are done in the correct order.
194 */
195#define COPY_MATCH_STRING_OPTS() do { \
196 M_CP_STROPT(banner); \
197 M_CP_STROPT(trusted_user_ca_keys); \
198 M_CP_STROPT(revoked_keys_file); \
Damien Millerf2e407e2011-05-20 19:04:14 +1000199 M_CP_STROPT(authorized_principals_file); \
Damien Millerd8478b62011-05-29 21:39:36 +1000200 M_CP_STRARRAYOPT(authorized_keys_files, num_authkeys_files); \
Damien Millerc24da772012-06-20 21:53:58 +1000201 M_CP_STRARRAYOPT(allow_users, num_allow_users); \
202 M_CP_STRARRAYOPT(deny_users, num_deny_users); \
203 M_CP_STRARRAYOPT(allow_groups, num_allow_groups); \
204 M_CP_STRARRAYOPT(deny_groups, num_deny_groups); \
205 M_CP_STRARRAYOPT(accept_env, num_accept_env); \
Damien Millera6e3f012012-11-04 23:21:40 +1100206 M_CP_STRARRAYOPT(auth_methods, num_auth_methods); \
Damien Millerf2e407e2011-05-20 19:04:14 +1000207 } while (0)
208
Darren Tuckerfbcf8272012-05-19 19:37:01 +1000209struct connection_info *get_connection_info(int, int);
Ben Lindstrom4cc240d2001-07-04 04:46:56 +0000210void initialize_server_options(ServerOptions *);
Ben Lindstrom4cc240d2001-07-04 04:46:56 +0000211void fill_default_server_options(ServerOptions *);
Darren Tucker45150472006-07-12 22:34:17 +1000212int process_server_config_line(ServerOptions *, char *, const char *, int,
Darren Tuckerfbcf8272012-05-19 19:37:01 +1000213 int *, struct connection_info *);
Darren Tucker645ab752004-06-25 13:33:20 +1000214void load_server_config(const char *, Buffer *);
Darren Tucker45150472006-07-12 22:34:17 +1000215void parse_server_config(ServerOptions *, const char *, Buffer *,
Darren Tuckerfbcf8272012-05-19 19:37:01 +1000216 struct connection_info *);
217void parse_server_match_config(ServerOptions *, struct connection_info *);
218int parse_server_match_testspec(struct connection_info *, char *);
219int server_match_spec_complete(struct connection_info *);
Darren Tucker1629c072007-02-19 22:25:37 +1100220void copy_set_server_options(ServerOptions *, ServerOptions *, int);
Darren Tuckere7140f22008-06-10 23:01:51 +1000221void dump_config(ServerOptions *);
Darren Tucker88b6fb22010-01-13 22:44:29 +1100222char *derelativise_path(const char *);
Damien Millerd4a8b7e1999-10-27 13:42:43 +1000223
Damien Miller95def091999-11-25 00:26:21 +1100224#endif /* SERVCONF_H */