blob: 843eb2ff06f2d37ab20a21790fcf3521017a3ebc (
plain)
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
|
/*
* Copyright (C) 2010 Andreas Steffen
* Hochschule fuer Technik Rapperswil
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the
* Free Software Foundation; either version 2 of the License, or (at your
* option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* for more details.
*/
/**
* @defgroup xauth_manager xauth_manager
* @{ @ingroup xauth
*/
#ifndef XAUTH_MANAGER_H_
#define XAUTH_MANAGER_H_
#include "xauth_provider.h"
#include "xauth_verifier.h"
typedef struct xauth_manager_t xauth_manager_t;
/**
* An xauth_manager registers xauth_providers and xauth_verifiers.
*/
struct xauth_manager_t {
/**
* Register an xauth_provider
*
* @param provider xauth_provider to be registered
*/
void (*add_provider)(xauth_manager_t *this, xauth_provider_t *provider);
/**
* Register an xauth_verifier
*
* @param verifier xauth_verifier to be registered
*/
void (*add_verifier)(xauth_manager_t *this, xauth_verifier_t *verifier);
/**
* Use registered providers to retrieve an XAUTH user secret
* based on connection information.
*
* @param c connection information
* @param secret secret if found, chunk_empty otherwise
* @return TRUE if a matching secret was found
*/
bool (*get_secret)(xauth_manager_t *this, connection_t *c, chunk_t *secret);
/**
* Use registered verifiers to verify an XAUTH user secret
* based on connection information
*
* @param c connection information
* @param secret secret to be compared
* @return TRUE if secret matches
*/
bool (*verify_secret)(xauth_manager_t *this, connection_t *c, chunk_t secret);
/**
* Destroy an xauth_verifier instance.
*/
void (*destroy)(xauth_manager_t *this);
};
/**
* Create an xauth_manager instance.
*/
xauth_manager_t *xauth_manager_create();
#endif /** XAUTH_MANAGER_H_ @}*/
|
