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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
#ifndef _XSASL_H_INCLUDED_
#define _XSASL_H_INCLUDED_
/*++
/* NAME
/* xsasl 3h
/* SUMMARY
/* Postfix SASL plug-in interface
/* SYNOPSIS
/* #include <xsasl.h>
/* DESCRIPTION
/* .nf
/*
* Utility library.
*/
#include <argv.h>
#include <vstream.h>
#include <vstring.h>
/*
* Generic server object. Specific instances extend this with their own
* private data.
*/
typedef struct XSASL_SERVER {
void (*free) (struct XSASL_SERVER *);
int (*first) (struct XSASL_SERVER *, const char *, const char *, VSTRING *);
int (*next) (struct XSASL_SERVER *, const char *, VSTRING *);
const char *(*get_mechanism_list) (struct XSASL_SERVER *);
const char *(*get_username) (struct XSASL_SERVER *);
} XSASL_SERVER;
#define xsasl_server_free(server) (server)->free(server)
#define xsasl_server_first(server, method, init_resp, reply) \
(server)->first((server), (method), (init_resp), (reply))
#define xsasl_server_next(server, request, reply) \
(server)->next((server), (request), (reply))
#define xsasl_server_get_mechanism_list(server) \
(server)->get_mechanism_list((server))
#define xsasl_server_get_username(server) \
(server)->get_username((server))
/*
* Generic server implementation. Specific instances extend this with their
* own private data.
*/
typedef struct XSASL_SERVER_CREATE_ARGS {
VSTREAM *stream;
int addr_family;
const char *server_addr;
const char *server_port;
const char *client_addr;
const char *client_port;
const char *service;
const char *user_realm;
const char *security_options;
int tls_flag;
} XSASL_SERVER_CREATE_ARGS;
typedef struct XSASL_SERVER_IMPL {
XSASL_SERVER *(*create) (struct XSASL_SERVER_IMPL *, XSASL_SERVER_CREATE_ARGS *);
void (*done) (struct XSASL_SERVER_IMPL *);
} XSASL_SERVER_IMPL;
extern XSASL_SERVER_IMPL *xsasl_server_init(const char *, const char *);
extern ARGV *xsasl_server_types(void);
#define xsasl_server_create(impl, args) \
(impl)->create((impl), (args))
#define XSASL_SERVER_CREATE(impl, args, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10) \
xsasl_server_create((impl), (((args)->a1), ((args)->a2), ((args)->a3), \
((args)->a4), ((args)->a5), ((args)->a6), ((args)->a7), ((args)->a8), \
((args)->a9), ((args)->a10), (args)))
#define xsasl_server_done(impl) (impl)->done((impl));
/*
* Generic client object. Specific instances extend this with their own
* private data.
*/
typedef struct XSASL_CLIENT {
void (*free) (struct XSASL_CLIENT *);
int (*first) (struct XSASL_CLIENT *, const char *, const char *, const char *, const char **, VSTRING *);
int (*next) (struct XSASL_CLIENT *, const char *, VSTRING *);
} XSASL_CLIENT;
#define xsasl_client_free(client) (client)->free(client)
#define xsasl_client_first(client, server, method, user, pass, init_resp) \
(client)->first((client), (server), (method), (user), (pass), (init_resp))
#define xsasl_client_next(client, request, reply) \
(client)->next((client), (request), (reply))
#define xsasl_client_set_password(client, user, pass) \
(client)->set_password((client), (user), (pass))
/*
* Generic client implementation. Specific instances extend this with their
* own private data.
*/
typedef struct XSASL_CLIENT_CREATE_ARGS {
VSTREAM *stream;
const char *service;
const char *server_name;
const char *security_options;
} XSASL_CLIENT_CREATE_ARGS;
typedef struct XSASL_CLIENT_IMPL {
XSASL_CLIENT *(*create) (struct XSASL_CLIENT_IMPL *, XSASL_CLIENT_CREATE_ARGS *);
void (*done) (struct XSASL_CLIENT_IMPL *);
} XSASL_CLIENT_IMPL;
extern XSASL_CLIENT_IMPL *xsasl_client_init(const char *, const char *);
extern ARGV *xsasl_client_types(void);
#define xsasl_client_create(impl, args) \
(impl)->create((impl), (args))
#define XSASL_CLIENT_CREATE(impl, args, a1, a2, a3, a4) \
xsasl_client_create((impl), (((args)->a1), ((args)->a2), ((args)->a3), \
((args)->a4), (args)))
#define xsasl_client_done(impl) (impl)->done((impl));
/*
* Status codes.
*/
#define XSASL_AUTH_OK 1 /* Success */
#define XSASL_AUTH_MORE 2 /* Need another c/s protocol exchange */
#define XSASL_AUTH_DONE 3 /* Authentication completed */
#define XSASL_AUTH_FORM 4 /* Cannot decode response */
#define XSASL_AUTH_FAIL 5 /* Error */
#define XSASL_AUTH_TEMP 6 /* Temporary error condition */
/* LICENSE
/* .ad
/* .fi
/* The Secure Mailer license must be distributed with this software.
/* AUTHOR(S)
/* Wietse Venema
/* IBM T.J. Watson Research
/* P.O. Box 704
/* Yorktown Heights, NY 10598, USA
/*
/* Wietse Venema
/* Google, Inc.
/* 111 8th Avenue
/* New York, NY 10011, USA
/*--*/
#endif
|
