1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
#ifndef LOGIN_PROXY_H
#define LOGIN_PROXY_H
#include "net.h"
/* Max. number of embedded proxying connections until proxying fails.
This is intended to avoid an accidental configuration where two proxies
keep connecting to each others, both thinking the other one is supposed to
handle the user. This only works if both proxies support the Dovecot
TTL extension feature. */
#define LOGIN_PROXY_TTL 5
#define LOGIN_PROXY_DEFAULT_HOST_IMMEDIATE_FAILURE_AFTER_SECS 30
#define LOGIN_PROXY_FAILURE_MSG "Account is temporarily unavailable."
struct client;
struct login_proxy;
enum login_proxy_ssl_flags {
/* Use SSL/TLS enabled */
PROXY_SSL_FLAG_YES = 0x01,
/* Don't do SSL handshake immediately after connected */
PROXY_SSL_FLAG_STARTTLS = 0x02,
/* Don't require that the received certificate is valid */
PROXY_SSL_FLAG_ANY_CERT = 0x04
};
enum login_proxy_failure_type {
/* connect() failed or remote disconnected us. */
LOGIN_PROXY_FAILURE_TYPE_CONNECT,
/* Internal error. */
LOGIN_PROXY_FAILURE_TYPE_INTERNAL,
/* Internal configuration error. */
LOGIN_PROXY_FAILURE_TYPE_INTERNAL_CONFIG,
/* Remote command failed unexpectedly. */
LOGIN_PROXY_FAILURE_TYPE_REMOTE,
/* Remote isn't configured as expected (e.g. STARTTLS required, but
no such capability). */
LOGIN_PROXY_FAILURE_TYPE_REMOTE_CONFIG,
/* Remote server is unexpectedly violating the protocol standard. */
LOGIN_PROXY_FAILURE_TYPE_PROTOCOL,
/* Authentication failed to backend. The LOGIN/AUTH command reply was
already sent to the client. */
LOGIN_PROXY_FAILURE_TYPE_AUTH,
/* Authentication failed with a temporary failure code. Attempting it
again might work. */
LOGIN_PROXY_FAILURE_TYPE_AUTH_TEMPFAIL,
};
struct login_proxy_settings {
const char *host;
struct ip_addr ip, source_ip;
in_port_t port;
unsigned int connect_timeout_msecs;
/* send a notification about proxy connection to proxy-notify pipe
every n seconds */
unsigned int notify_refresh_secs;
unsigned int host_immediate_failure_after_secs;
enum login_proxy_ssl_flags ssl_flags;
const char *rawlog_dir;
};
/* Called when new input comes from proxy. */
typedef void login_proxy_input_callback_t(struct client *client);
/* Called when proxying fails. If reconnecting=TRUE, this is just an
intermediate notification that the proxying will attempt to reconnect soon
before failing. */
typedef void login_proxy_failure_callback_t(struct client *client,
enum login_proxy_failure_type type,
const char *reason,
bool reconnecting);
/* Create a proxy to given host. Returns NULL if failed. Given callback is
called when new input is available from proxy. */
int login_proxy_new(struct client *client, struct event *event,
const struct login_proxy_settings *set,
login_proxy_input_callback_t *input_callback,
login_proxy_failure_callback_t *failure_callback);
/* Free the proxy. This should be called if authentication fails. */
void login_proxy_free(struct login_proxy **proxy);
/* Login proxying session has failed. Returns TRUE if the reconnection is
attempted. */
bool login_proxy_failed(struct login_proxy *proxy, struct event *event,
enum login_proxy_failure_type type, const char *reason);
/* Return TRUE if host/port/destuser combination points to same as current
connection. */
bool login_proxy_is_ourself(const struct client *client, const char *host,
in_port_t port, const char *destuser);
/* Detach proxy from client. This is done after the authentication is
successful and all that is left is the dummy proxying. */
void login_proxy_detach(struct login_proxy *proxy);
/* STARTTLS command was issued. */
int login_proxy_starttls(struct login_proxy *proxy);
struct istream *login_proxy_get_istream(struct login_proxy *proxy);
struct ostream *login_proxy_get_ostream(struct login_proxy *proxy);
void login_proxy_append_success_log_info(struct login_proxy *proxy,
string_t *str);
struct event *login_proxy_get_event(struct login_proxy *proxy);
const char *login_proxy_get_source_host(const struct login_proxy *proxy) ATTR_PURE;
const char *login_proxy_get_host(const struct login_proxy *proxy) ATTR_PURE;
const char *login_proxy_get_ip_str(const struct login_proxy *proxy) ATTR_PURE;
in_port_t login_proxy_get_port(const struct login_proxy *proxy) ATTR_PURE;
enum login_proxy_ssl_flags
login_proxy_get_ssl_flags(const struct login_proxy *proxy) ATTR_PURE;
void login_proxy_kill_idle(void);
unsigned int login_proxies_get_detached_count(void);
struct client *login_proxies_get_first_detached_client(void);
void login_proxy_init(const char *proxy_notify_pipe_path);
void login_proxy_deinit(void);
#endif
|
