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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include "wocky-auth-handler.h"
#include "wocky-auth-registry.h"
GType
wocky_auth_handler_get_type (void)
{
static volatile gsize g_define_type_id__volatile = 0;
if (g_once_init_enter (&g_define_type_id__volatile))
{
const GTypeInfo info =
{
/* class_size */ sizeof (WockyAuthHandlerIface),
/* base_init */ NULL,
/* base_finalize */ NULL,
/* class_init */ NULL,
/* class_finalize */ NULL,
/* class_data */ NULL,
/* instance_size */ 0,
/* n_preallocs */ 0,
/* instance_init */ NULL,
/* value_table */ NULL
};
GType g_define_type_id = g_type_register_static (
G_TYPE_INTERFACE, "WockyAuthHandler", &info, 0);
g_type_interface_add_prerequisite (g_define_type_id, G_TYPE_OBJECT);
g_once_init_leave (&g_define_type_id__volatile, g_define_type_id);
}
return g_define_type_id__volatile;
}
/**
* wocky_auth_handler_get_mechanism:
* @handler: a handler for a SASL mechanism.
*
* Returns the name of the SASL mechanism @handler implements.
*
* Returns: the name of the SASL mechanism @handler implements.
*/
const gchar *
wocky_auth_handler_get_mechanism (WockyAuthHandler *handler)
{
return WOCKY_AUTH_HANDLER_GET_IFACE (handler)->mechanism;
}
/**
* wocky_auth_handler_is_plain:
* @handler: a handler for a SASL mechanism.
*
* Checks whether @handler sends secrets in plaintext. This may be used to
* decide whether to use @handler on an insecure XMPP connection.
*
* Returns: %TRUE if @handler sends secrets in plaintext.
*/
gboolean
wocky_auth_handler_is_plain (WockyAuthHandler *handler)
{
return WOCKY_AUTH_HANDLER_GET_IFACE (handler)->plain;
}
/**
* wocky_auth_handler_get_initial_response:
* @handler: a handler for a SASL mechanism
* @initial_data: (out) (transfer full): initial data to send to the server, if
* any
* @error: an optional location for a #GError to fill, or %NULL
*
* Called when authentication begins to fetch the initial data to send to the
* server in the <code><auth/></code> stanza.
*
* If this function returns %TRUE, @initial_data will be non-%NULL if @handler
* provides an initial response, and %NULL otherwise.
*
* Returns: %TRUE on success; %FALSE otherwise.
*/
gboolean
wocky_auth_handler_get_initial_response (WockyAuthHandler *handler,
GString **initial_data,
GError **error)
{
WockyAuthInitialResponseFunc func =
WOCKY_AUTH_HANDLER_GET_IFACE (handler)->initial_response_func;
g_assert (initial_data != NULL);
*initial_data = NULL;
if (func == NULL)
return TRUE;
return func (handler, initial_data, error);
}
/**
* wocky_auth_handler_handle_auth_data:
* @handler: a #WockyAuthHandler object
* @data: the challenge string
* @response: (out) (transfer full): a location to fill with a challenge
* response in a #GString
* @error: an optional location for a #GError to fill, or %NULL
*
* Asks @handler to respond to a <code><challenge/></code> stanza or a
* <code><success/></code> with data. On success, @handler will put
* response data into @response, Base64-encoding it if appropriate.
*
* Returns: %TRUE on success, otherwise %FALSE
*/
gboolean
wocky_auth_handler_handle_auth_data (
WockyAuthHandler *handler,
const GString *data,
GString **response,
GError **error)
{
WockyAuthAuthDataFunc func =
WOCKY_AUTH_HANDLER_GET_IFACE (handler)->auth_data_func;
g_assert (response != NULL);
*response = NULL;
if (func == NULL)
{
g_set_error (error, WOCKY_AUTH_ERROR,
WOCKY_AUTH_ERROR_INVALID_REPLY,
"Server send a challenge, but the mechanism didn't expect any");
return FALSE;
}
return func (handler, data, response, error);
}
/**
* wocky_auth_handler_handle_success:
* @handler: a #WockyAuthHandler object
* @error: an optional location for a #GError to fill, or %NULL
*
* Called when a <code><success/></code> stanza is received
* during authentication. If no error is returned, then authentication
* is considered finished. (Typically, an error is only raised if the
* <code><success/></code> stanza was received earlier than
* expected)
*
* Returns: %TRUE on success, otherwise %FALSE
*/
gboolean
wocky_auth_handler_handle_success (
WockyAuthHandler *handler,
GError **error)
{
WockyAuthSuccessFunc func =
WOCKY_AUTH_HANDLER_GET_IFACE (handler)->success_func;
if (func == NULL)
return TRUE;
else
return func (handler, error);
}
|
