-rw-r--r-- | include/opkele/extension.h | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/include/opkele/extension.h b/include/opkele/extension.h index 513672f..3ee25ee 100644 --- a/include/opkele/extension.h +++ b/include/opkele/extension.h | |||
@@ -1,65 +1,66 @@ | |||
1 | #ifndef __OPKELE_EXTENSION_H | 1 | #ifndef __OPKELE_EXTENSION_H |
2 | #define __OPKELE_EXTENSION_H | 2 | #define __OPKELE_EXTENSION_H |
3 | 3 | ||
4 | /** | 4 | /** |
5 | * @file | 5 | * @file |
6 | * @brief extensions framework basics | 6 | * @brief extensions framework basics |
7 | */ | 7 | */ |
8 | 8 | ||
9 | #include <opkele/types.h> | 9 | #include <opkele/types.h> |
10 | 10 | ||
11 | namespace opkele { | 11 | namespace opkele { |
12 | 12 | ||
13 | /** | 13 | /** |
14 | * OpenID extension hooks base class | 14 | * OpenID extension hooks base class |
15 | */ | 15 | */ |
16 | class extension_t { | 16 | class extension_t { |
17 | public: | 17 | public: |
18 | 18 | ||
19 | virtual ~extension_t() { } | 19 | virtual ~extension_t() { } |
20 | |||
20 | /** | 21 | /** |
21 | * hook called by consumer before submitting data to OpenID server. | 22 | * hook called by consumer before submitting data to OpenID server. |
22 | * It is supposed to manipulate parameters list. | 23 | * It is supposed to manipulate parameters list. |
23 | * @param p parameters about to be submitted to server | 24 | * @param p parameters about to be submitted to server |
24 | * @param identity identity being verified. It may differ from the | 25 | * @param identity identity being verified. It may differ from the |
25 | * one available in parameters list in case of delegation | 26 | * one available in parameters list in case of delegation |
26 | * @see consumer_t::checkid_ | 27 | * @see consumer_t::checkid_ |
27 | * @see consumer_t::checkid_immediate | 28 | * @see consumer_t::checkid_immediate |
28 | * @see consumer_t::checkid_setup | 29 | * @see consumer_t::checkid_setup |
29 | */ | 30 | */ |
30 | virtual void checkid_hook(params_t& p,const string& identity); | 31 | virtual void checkid_hook(basic_openid_message& om); |
31 | /** | 32 | /** |
32 | * hook called by consumer after identity information received from | 33 | * hook called by consumer after identity information received from |
33 | * OpenID server is verified. | 34 | * OpenID server is verified. |
34 | * @param p parameters received from server | 35 | * @param p parameters received from server |
35 | * @param sp signed parameters received from server with 'openid.' | 36 | * @param sp signed parameters received from server with 'openid.' |
36 | * leader stripped | 37 | * leader stripped |
37 | * @param identity identity confirmed. May differ from the one | 38 | * @param identity identity confirmed. May differ from the one |
38 | * available in parameters list in case of delegation. May also be | 39 | * available in parameters list in case of delegation. May also be |
39 | * empty which means - extract one from parameters | 40 | * empty which means - extract one from parameters |
40 | * @see consumer_t::id_res | 41 | * @see consumer_t::id_res |
41 | */ | 42 | */ |
42 | virtual void id_res_hook(const params_t& p,const params_t& sp,const string& identity); | 43 | virtual void id_res_hook(const basic_openid_message& om,const basic_openid_message& sp); |
43 | 44 | ||
44 | /** | 45 | /** |
45 | * hook called by server before returning information to consumer. | 46 | * hook called by server before returning information to consumer. |
46 | * The hook may manipulate output parameters. It is important to | 47 | * The hook may manipulate output parameters. It is important to |
47 | * note that modified pout["signed"] is used for signing response. | 48 | * note that modified pout["signed"] is used for signing response. |
48 | * @param pin request parameters list with "openid." prefix | 49 | * @param pin request parameters list with "openid." prefix |
49 | * @param pout response parameters list without "openid." prefix | 50 | * @param pout response parameters list without "openid." prefix |
50 | * @see server_t::checkid_ | 51 | * @see server_t::checkid_ |
51 | * @see server_t::checkid_immediate | 52 | * @see server_t::checkid_immediate |
52 | * @see server_t::checkid_setup | 53 | * @see server_t::checkid_setup |
53 | */ | 54 | */ |
54 | virtual void checkid_hook(const params_t& pin,params_t& pout); | 55 | virtual void checkid_hook(const basic_openid_message& inm,basic_openid_message& oum); |
55 | 56 | ||
56 | /** | 57 | /** |
57 | * Casts the object to pointer to itself. For convenient passing | 58 | * Casts the object to pointer to itself. For convenient passing |
58 | * of pointer. | 59 | * of pointer. |
59 | */ | 60 | */ |
60 | operator extension_t*(void) { return this; } | 61 | operator extension_t*(void) { return this; } |
61 | }; | 62 | }; |
62 | 63 | ||
63 | } | 64 | } |
64 | 65 | ||
65 | #endif /* __OPKELE_EXTENSION_H */ | 66 | #endif /* __OPKELE_EXTENSION_H */ |