author | Michael Krelin <hacker@klever.net> | 2007-12-27 00:08:36 (UTC) |
---|---|---|
committer | Michael Krelin <hacker@klever.net> | 2008-01-04 18:17:46 (UTC) |
commit | ed6883769a03b36402c2c78b1dcee0c7efeb70bc (patch) (unidiff) | |
tree | ec96f9c7feeb02d2822ec9872b937b54ab82fb8a /include | |
parent | e63de16a9885641b5070ec834225cb562bc2042f (diff) | |
download | libopkele-ed6883769a03b36402c2c78b1dcee0c7efeb70bc.zip libopkele-ed6883769a03b36402c2c78b1dcee0c7efeb70bc.tar.gz libopkele-ed6883769a03b36402c2c78b1dcee0c7efeb70bc.tar.bz2 |
changed auto_ptr to shared_ptr
Signed-off-by: Michael Krelin <hacker@klever.net>
-rw-r--r-- | include/Makefile.am | 3 | ||||
-rw-r--r-- | include/opkele/consumer.h | 6 | ||||
-rw-r--r-- | include/opkele/server.h | 4 | ||||
-rw-r--r-- | include/opkele/types.h | 7 |
4 files changed, 10 insertions, 10 deletions
diff --git a/include/Makefile.am b/include/Makefile.am index 078c6dc..26cb614 100644 --- a/include/Makefile.am +++ b/include/Makefile.am | |||
@@ -1,19 +1,20 @@ | |||
1 | nobase_include_HEADERS = \ | 1 | nobase_include_HEADERS = \ |
2 | opkele/acconfig.h \ | 2 | opkele/acconfig.h \ |
3 | opkele/opkele-config.h \ | 3 | opkele/opkele-config.h \ |
4 | opkele/types.h \ | 4 | opkele/types.h \ |
5 | opkele/association.h \ | 5 | opkele/association.h \ |
6 | opkele/exception.h \ | 6 | opkele/exception.h \ |
7 | opkele/server.h \ | 7 | opkele/server.h \ |
8 | opkele/consumer.h \ | 8 | opkele/consumer.h \ |
9 | opkele/extension.h \ | 9 | opkele/extension.h \ |
10 | opkele/sreg.h \ | 10 | opkele/sreg.h \ |
11 | opkele/extension_chain.h \ | 11 | opkele/extension_chain.h \ |
12 | opkele/xconsumer.h \ | 12 | opkele/xconsumer.h \ |
13 | opkele/xserver.h \ | 13 | opkele/xserver.h \ |
14 | opkele/discovery.h \ | 14 | opkele/discovery.h \ |
15 | opkele/uris.h | 15 | opkele/uris.h \ |
16 | opkele/tr1-mem.h | ||
16 | EXTRA_DIST = \ | 17 | EXTRA_DIST = \ |
17 | opkele/data.h \ | 18 | opkele/data.h \ |
18 | opkele/curl.h opkele/expat.h \ | 19 | opkele/curl.h opkele/expat.h \ |
19 | opkele/util.h | 20 | opkele/util.h |
diff --git a/include/opkele/consumer.h b/include/opkele/consumer.h index c463787..3c1d318 100644 --- a/include/opkele/consumer.h +++ b/include/opkele/consumer.h | |||
@@ -1,144 +1,144 @@ | |||
1 | #ifndef __OPKELE_CONSUMER_H | 1 | #ifndef __OPKELE_CONSUMER_H |
2 | #define __OPKELE_CONSUMER_H | 2 | #define __OPKELE_CONSUMER_H |
3 | 3 | ||
4 | #include <opkele/types.h> | 4 | #include <opkele/types.h> |
5 | #include <opkele/extension.h> | 5 | #include <opkele/extension.h> |
6 | 6 | ||
7 | /** | 7 | /** |
8 | * @file | 8 | * @file |
9 | * @brief OpenID consumer-side functionality | 9 | * @brief OpenID consumer-side functionality |
10 | */ | 10 | */ |
11 | 11 | ||
12 | namespace opkele { | 12 | namespace opkele { |
13 | 13 | ||
14 | /** | 14 | /** |
15 | * implementation of basic consumer functionality | 15 | * implementation of basic consumer functionality |
16 | * | 16 | * |
17 | * @note | 17 | * @note |
18 | * The consumer uses libcurl internally, which means that if you're using | 18 | * The consumer uses libcurl internally, which means that if you're using |
19 | * libopkele in multithreaded environment you should call curl_global_init | 19 | * libopkele in multithreaded environment you should call curl_global_init |
20 | * yourself before spawning any threads. | 20 | * yourself before spawning any threads. |
21 | */ | 21 | */ |
22 | class consumer_t { | 22 | class consumer_t { |
23 | public: | 23 | public: |
24 | 24 | ||
25 | virtual ~consumer_t() { } | 25 | virtual ~consumer_t() { } |
26 | 26 | ||
27 | /** | 27 | /** |
28 | * store association. The function should be overridden in the real | 28 | * store association. The function should be overridden in the real |
29 | * implementation to provide persistent associations store. | 29 | * implementation to provide persistent associations store. |
30 | * @param server the OpenID server | 30 | * @param server the OpenID server |
31 | * @param handle association handle | 31 | * @param handle association handle |
32 | * @param secret the secret associated with the server and handle | 32 | * @param secret the secret associated with the server and handle |
33 | * @param expires_in the number of seconds until the handle is expired | 33 | * @param expires_in the number of seconds until the handle is expired |
34 | * @return the auto_ptr<> for the newly allocated association_t object | 34 | * @return the assoc_t for the newly allocated association_t object |
35 | */ | 35 | */ |
36 | virtual assoc_t store_assoc(const string& server,const string& handle,const secret_t& secret,int expires_in) = 0; | 36 | virtual assoc_t store_assoc(const string& server,const string& handle,const secret_t& secret,int expires_in) = 0; |
37 | /** | 37 | /** |
38 | * retrieve stored association. The function should be overridden | 38 | * retrieve stored association. The function should be overridden |
39 | * in the real implementation to provide persistent assocations | 39 | * in the real implementation to provide persistent assocations |
40 | * store. | 40 | * store. |
41 | * | 41 | * |
42 | * @note | 42 | * @note |
43 | * The user is responsible for handling associations expiry and | 43 | * The user is responsible for handling associations expiry and |
44 | * this function should never return an expired or invalidated | 44 | * this function should never return an expired or invalidated |
45 | * association. | 45 | * association. |
46 | * | 46 | * |
47 | * @param server the OpenID server | 47 | * @param server the OpenID server |
48 | * @param handle association handle | 48 | * @param handle association handle |
49 | * @return the autho_ptr<> for the newly allocated association_t object | 49 | * @return the autho_ptr<> for the newly allocated association_t object |
50 | * @throw failed_lookup if no unexpired association found | 50 | * @throw failed_lookup if no unexpired association found |
51 | */ | 51 | */ |
52 | virtual assoc_t retrieve_assoc(const string& server,const string& handle) = 0; | 52 | virtual assoc_t retrieve_assoc(const string& server,const string& handle) = 0; |
53 | /** | 53 | /** |
54 | * invalidate stored association. The function should be overridden | 54 | * invalidate stored association. The function should be overridden |
55 | * in the real implementation of the consumer. | 55 | * in the real implementation of the consumer. |
56 | * @param server the OpenID server | 56 | * @param server the OpenID server |
57 | * @param handle association handle | 57 | * @param handle association handle |
58 | */ | 58 | */ |
59 | virtual void invalidate_assoc(const string& server,const string& handle) = 0; | 59 | virtual void invalidate_assoc(const string& server,const string& handle) = 0; |
60 | /** | 60 | /** |
61 | * retrieve any unexpired association for the server. If the | 61 | * retrieve any unexpired association for the server. If the |
62 | * function is not overridden in the real implementation, the new | 62 | * function is not overridden in the real implementation, the new |
63 | * association will be established for each request. | 63 | * association will be established for each request. |
64 | * | 64 | * |
65 | * @note | 65 | * @note |
66 | * The user is responsible for handling associations and this | 66 | * The user is responsible for handling associations and this |
67 | * function should never return an expired or invalidated | 67 | * function should never return an expired or invalidated |
68 | * association. | 68 | * association. |
69 | * | 69 | * |
70 | * @note | 70 | * @note |
71 | * It may be a good idea to pre-expire associations shortly before | 71 | * It may be a good idea to pre-expire associations shortly before |
72 | * their time is really up to avoid association expiry in the | 72 | * their time is really up to avoid association expiry in the |
73 | * middle of negotiations. | 73 | * middle of negotiations. |
74 | * | 74 | * |
75 | * @param server the OpenID server | 75 | * @param server the OpenID server |
76 | * @return the auto_ptr<> for the newly allocated association_t object | 76 | * @return the assoc_t for the newly allocated association_t object |
77 | * @throw failed_lookup in case of absence of the handle | 77 | * @throw failed_lookup in case of absence of the handle |
78 | */ | 78 | */ |
79 | virtual assoc_t find_assoc(const string& server); | 79 | virtual assoc_t find_assoc(const string& server); |
80 | 80 | ||
81 | /** | 81 | /** |
82 | * retrieve the metainformation contained in link tags from the | 82 | * retrieve the metainformation contained in link tags from the |
83 | * page pointed by url. the function may implement caching of the | 83 | * page pointed by url. the function may implement caching of the |
84 | * information. | 84 | * information. |
85 | * @param url url to harvest for link tags | 85 | * @param url url to harvest for link tags |
86 | * @param server reference to the string object where to put | 86 | * @param server reference to the string object where to put |
87 | * openid.server value | 87 | * openid.server value |
88 | * @param delegate reference to the string object where to put the | 88 | * @param delegate reference to the string object where to put the |
89 | * openid.delegate value (if any) | 89 | * openid.delegate value (if any) |
90 | */ | 90 | */ |
91 | virtual void retrieve_links(const string& url,string& server,string& delegate); | 91 | virtual void retrieve_links(const string& url,string& server,string& delegate); |
92 | 92 | ||
93 | /** | 93 | /** |
94 | * perform the associate request to OpenID server. | 94 | * perform the associate request to OpenID server. |
95 | * @param server the OpenID server | 95 | * @param server the OpenID server |
96 | * @return the auto_ptr<> for the newly allocated association_t | 96 | * @return the assoc_t for the newly allocated association_t |
97 | * object, representing established association | 97 | * object, representing established association |
98 | * @throw exception in case of error | 98 | * @throw exception in case of error |
99 | */ | 99 | */ |
100 | assoc_t associate(const string& server); | 100 | assoc_t associate(const string& server); |
101 | /** | 101 | /** |
102 | * prepare the parameters for the checkid_immediate | 102 | * prepare the parameters for the checkid_immediate |
103 | * request. | 103 | * request. |
104 | * @param identity the identity to verify | 104 | * @param identity the identity to verify |
105 | * @param return_to the return_to url to pass with the request | 105 | * @param return_to the return_to url to pass with the request |
106 | * @param trust_root the trust root to advertise with the request | 106 | * @param trust_root the trust root to advertise with the request |
107 | * @param ext pointer to an extension(s) hooks object | 107 | * @param ext pointer to an extension(s) hooks object |
108 | * @return the location string | 108 | * @return the location string |
109 | * @throw exception in case of error | 109 | * @throw exception in case of error |
110 | */ | 110 | */ |
111 | virtual string checkid_immediate(const string& identity,const string& return_to,const string& trust_root="",extension_t *ext=0); | 111 | virtual string checkid_immediate(const string& identity,const string& return_to,const string& trust_root="",extension_t *ext=0); |
112 | /** | 112 | /** |
113 | * prepare the parameters for the checkid_setup | 113 | * prepare the parameters for the checkid_setup |
114 | * request. | 114 | * request. |
115 | * @param identity the identity to verify | 115 | * @param identity the identity to verify |
116 | * @param return_to the return_to url to pass with the request | 116 | * @param return_to the return_to url to pass with the request |
117 | * @param trust_root the trust root to advertise with the request | 117 | * @param trust_root the trust root to advertise with the request |
118 | * @param ext pointer to an extension(s) hooks object | 118 | * @param ext pointer to an extension(s) hooks object |
119 | * @return the location string | 119 | * @return the location string |
120 | * @throw exception in case of error | 120 | * @throw exception in case of error |
121 | */ | 121 | */ |
122 | virtual string checkid_setup(const string& identity,const string& return_to,const string& trust_root="",extension_t *ext=0); | 122 | virtual string checkid_setup(const string& identity,const string& return_to,const string& trust_root="",extension_t *ext=0); |
123 | /** | 123 | /** |
124 | * the actual implementation behind checkid_immediate() and | 124 | * the actual implementation behind checkid_immediate() and |
125 | * checkid_setup() functions. | 125 | * checkid_setup() functions. |
126 | * @param mode checkid_* mode - either mode_checkid_immediate or mode_checkid_setup | 126 | * @param mode checkid_* mode - either mode_checkid_immediate or mode_checkid_setup |
127 | * @param identity the identity to verify | 127 | * @param identity the identity to verify |
128 | * @param return_to the return_to url to pass with the request | 128 | * @param return_to the return_to url to pass with the request |
129 | * @param trust_root the trust root to advertise with the request | 129 | * @param trust_root the trust root to advertise with the request |
130 | * @param ext pointer to an extension(s) hooks object | 130 | * @param ext pointer to an extension(s) hooks object |
131 | * @return the location string | 131 | * @return the location string |
132 | * @throw exception in case of error | 132 | * @throw exception in case of error |
133 | */ | 133 | */ |
134 | virtual string checkid_(mode_t mode,const string& identity,const string& return_to,const string& trust_root="",extension_t *ext=0); | 134 | virtual string checkid_(mode_t mode,const string& identity,const string& return_to,const string& trust_root="",extension_t *ext=0); |
135 | /** | 135 | /** |
136 | * verify the id_res response | 136 | * verify the id_res response |
137 | * @param pin the response parameters | 137 | * @param pin the response parameters |
138 | * @param identity the identity being checked (if not specified, | 138 | * @param identity the identity being checked (if not specified, |
139 | * @param ext pointer to an extension(s) hooks object | 139 | * @param ext pointer to an extension(s) hooks object |
140 | * extracted from the openid.identity parameter | 140 | * extracted from the openid.identity parameter |
141 | * @throw id_res_mismatch in case of signature mismatch | 141 | * @throw id_res_mismatch in case of signature mismatch |
142 | * @throw id_res_setup in case of openid.user_setup_url failure | 142 | * @throw id_res_setup in case of openid.user_setup_url failure |
143 | * (supposedly checkid_immediate only) | 143 | * (supposedly checkid_immediate only) |
144 | * @throw id_res_failed in case of failure | 144 | * @throw id_res_failed in case of failure |
diff --git a/include/opkele/server.h b/include/opkele/server.h index dd7fc41..3c25646 100644 --- a/include/opkele/server.h +++ b/include/opkele/server.h | |||
@@ -1,84 +1,84 @@ | |||
1 | #ifndef __OPKELE_SERVER_H | 1 | #ifndef __OPKELE_SERVER_H |
2 | #define __OPKELE_SERVER_H | 2 | #define __OPKELE_SERVER_H |
3 | 3 | ||
4 | /** | 4 | /** |
5 | * @file | 5 | * @file |
6 | * @brief OpenID server-side functionality | 6 | * @brief OpenID server-side functionality |
7 | */ | 7 | */ |
8 | 8 | ||
9 | #include <opkele/types.h> | 9 | #include <opkele/types.h> |
10 | #include <opkele/extension.h> | 10 | #include <opkele/extension.h> |
11 | 11 | ||
12 | namespace opkele { | 12 | namespace opkele { |
13 | 13 | ||
14 | /** | 14 | /** |
15 | * implementation of basic server functionality | 15 | * implementation of basic server functionality |
16 | */ | 16 | */ |
17 | class server_t { | 17 | class server_t { |
18 | public: | 18 | public: |
19 | 19 | ||
20 | virtual ~server_t() { } | 20 | virtual ~server_t() { } |
21 | 21 | ||
22 | /** | 22 | /** |
23 | * allocate the new association. The function should be overridden | 23 | * allocate the new association. The function should be overridden |
24 | * in the real implementation to provide persistent assocations | 24 | * in the real implementation to provide persistent assocations |
25 | * store. | 25 | * store. |
26 | * @param mode the mode of request being processed to base the | 26 | * @param mode the mode of request being processed to base the |
27 | * statelessness of the association upon | 27 | * statelessness of the association upon |
28 | * @return the auto_ptr<> for the newly allocated association_t object | 28 | * @return the assoc_t for the newly allocated association_t object |
29 | */ | 29 | */ |
30 | virtual assoc_t alloc_assoc(mode_t mode) = 0; | 30 | virtual assoc_t alloc_assoc(mode_t mode) = 0; |
31 | /** | 31 | /** |
32 | * retrieve the association. The function should be overridden in | 32 | * retrieve the association. The function should be overridden in |
33 | * the reqal implementation to provide persistent assocations | 33 | * the reqal implementation to provide persistent assocations |
34 | * store. | 34 | * store. |
35 | * @param h association handle | 35 | * @param h association handle |
36 | * @return the auto_ptr<> for the newly allocated association_t object | 36 | * @return the assoc_t for the newly allocated association_t object |
37 | * @throw failed_lookup in case of failure | 37 | * @throw failed_lookup in case of failure |
38 | */ | 38 | */ |
39 | virtual assoc_t retrieve_assoc(const string& h) = 0; | 39 | virtual assoc_t retrieve_assoc(const string& h) = 0; |
40 | 40 | ||
41 | /** | 41 | /** |
42 | * validate the identity. | 42 | * validate the identity. |
43 | * @param assoc association object | 43 | * @param assoc association object |
44 | * @param pin incoming request parameters | 44 | * @param pin incoming request parameters |
45 | * @param identity being verified | 45 | * @param identity being verified |
46 | * @param trust_root presented in the request | 46 | * @param trust_root presented in the request |
47 | * @throw exception if identity can not be confirmed | 47 | * @throw exception if identity can not be confirmed |
48 | */ | 48 | */ |
49 | virtual void validate(const association_t& assoc,const params_t& pin,const string& identity,const string& trust_root) = 0; | 49 | virtual void validate(const association_t& assoc,const params_t& pin,const string& identity,const string& trust_root) = 0; |
50 | 50 | ||
51 | 51 | ||
52 | /** | 52 | /** |
53 | * process the associate request. | 53 | * process the associate request. |
54 | * @param pin the incoming request parameters | 54 | * @param pin the incoming request parameters |
55 | * @param pout the store for the response parameters | 55 | * @param pout the store for the response parameters |
56 | */ | 56 | */ |
57 | void associate(const params_t& pin,params_t& pout); | 57 | void associate(const params_t& pin,params_t& pout); |
58 | /** | 58 | /** |
59 | * process the checkid_immediate request. | 59 | * process the checkid_immediate request. |
60 | * @param pin the incoming request parameters | 60 | * @param pin the incoming request parameters |
61 | * @param return_to reference to the object to store return_to url to | 61 | * @param return_to reference to the object to store return_to url to |
62 | * @param pout the response parameters | 62 | * @param pout the response parameters |
63 | * @param ext pointer to the extension hooks object | 63 | * @param ext pointer to the extension hooks object |
64 | * @throw exception in case of errors or negative reply | 64 | * @throw exception in case of errors or negative reply |
65 | */ | 65 | */ |
66 | virtual void checkid_immediate(const params_t& pin,string& return_to,params_t& pout,extension_t *ext=0); | 66 | virtual void checkid_immediate(const params_t& pin,string& return_to,params_t& pout,extension_t *ext=0); |
67 | /** | 67 | /** |
68 | * process the checkid_setup request. | 68 | * process the checkid_setup request. |
69 | * @param pin the incoming request parameters | 69 | * @param pin the incoming request parameters |
70 | * @param return_to reference to the object to store return_to url to | 70 | * @param return_to reference to the object to store return_to url to |
71 | * @param pout the response parameters | 71 | * @param pout the response parameters |
72 | * @param ext pointer to the extension hooks object | 72 | * @param ext pointer to the extension hooks object |
73 | * @throw exception in case of errors or negative reply | 73 | * @throw exception in case of errors or negative reply |
74 | */ | 74 | */ |
75 | virtual void checkid_setup(const params_t& pin,string& return_to,params_t& pout,extension_t *ext=0); | 75 | virtual void checkid_setup(const params_t& pin,string& return_to,params_t& pout,extension_t *ext=0); |
76 | /** | 76 | /** |
77 | * the actual functionality behind checkid_immediate() and | 77 | * the actual functionality behind checkid_immediate() and |
78 | * checkid_setup() | 78 | * checkid_setup() |
79 | * @param mode the request being processed (either | 79 | * @param mode the request being processed (either |
80 | * mode_checkid_immediate or mode_checkid_setup) | 80 | * mode_checkid_immediate or mode_checkid_setup) |
81 | * @param pin the incoming request parameters | 81 | * @param pin the incoming request parameters |
82 | * @param return_to reference to the object to store return_to url to | 82 | * @param return_to reference to the object to store return_to url to |
83 | * @param pout the response parameters | 83 | * @param pout the response parameters |
84 | * @param ext pointer to the extension hooks object | 84 | * @param ext pointer to the extension hooks object |
diff --git a/include/opkele/types.h b/include/opkele/types.h index ca07df5..d959021 100644 --- a/include/opkele/types.h +++ b/include/opkele/types.h | |||
@@ -1,161 +1,160 @@ | |||
1 | #ifndef __OPKELE_TYPES_H | 1 | #ifndef __OPKELE_TYPES_H |
2 | #define __OPKELE_TYPES_H | 2 | #define __OPKELE_TYPES_H |
3 | 3 | ||
4 | /** | 4 | /** |
5 | * @file | 5 | * @file |
6 | * @brief various types declarations | 6 | * @brief various types declarations |
7 | */ | 7 | */ |
8 | 8 | ||
9 | #include <ostream> | 9 | #include <ostream> |
10 | #include <vector> | 10 | #include <vector> |
11 | #include <string> | 11 | #include <string> |
12 | #include <map> | 12 | #include <map> |
13 | #include <memory> | ||
14 | #include <set> | 13 | #include <set> |
14 | #include <opkele/tr1-mem.h> | ||
15 | 15 | ||
16 | namespace opkele { | 16 | namespace opkele { |
17 | using std::vector; | 17 | using std::vector; |
18 | using std::string; | 18 | using std::string; |
19 | using std::map; | 19 | using std::map; |
20 | using std::ostream; | 20 | using std::ostream; |
21 | using std::auto_ptr; | ||
22 | using std::multimap; | 21 | using std::multimap; |
23 | using std::set; | 22 | using std::set; |
24 | 23 | ||
25 | /** | 24 | /** |
26 | * the OpenID operation mode | 25 | * the OpenID operation mode |
27 | */ | 26 | */ |
28 | typedef enum _mode_t { | 27 | typedef enum _mode_t { |
29 | mode_associate, | 28 | mode_associate, |
30 | mode_checkid_immediate, | 29 | mode_checkid_immediate, |
31 | mode_checkid_setup, | 30 | mode_checkid_setup, |
32 | mode_check_association | 31 | mode_check_association |
33 | } mode_t; | 32 | } mode_t; |
34 | 33 | ||
35 | /** | 34 | /** |
36 | * the association secret container | 35 | * the association secret container |
37 | */ | 36 | */ |
38 | class secret_t : public vector<unsigned char> { | 37 | class secret_t : public vector<unsigned char> { |
39 | public: | 38 | public: |
40 | 39 | ||
41 | /** | 40 | /** |
42 | * xor the secret and hmac together and encode, using base64 | 41 | * xor the secret and hmac together and encode, using base64 |
43 | * @param key_d pointer to the message digest | 42 | * @param key_d pointer to the message digest |
44 | * @param rv reference to the return value | 43 | * @param rv reference to the return value |
45 | */ | 44 | */ |
46 | void enxor_to_base64(const unsigned char *key_d,string& rv) const; | 45 | void enxor_to_base64(const unsigned char *key_d,string& rv) const; |
47 | /** | 46 | /** |
48 | * decode base64-encoded secret and xor it with the message digest | 47 | * decode base64-encoded secret and xor it with the message digest |
49 | * @param key_d pointer to the message digest | 48 | * @param key_d pointer to the message digest |
50 | * @param b64 base64-encoded secret value | 49 | * @param b64 base64-encoded secret value |
51 | */ | 50 | */ |
52 | void enxor_from_base64(const unsigned char *key_d,const string& b64); | 51 | void enxor_from_base64(const unsigned char *key_d,const string& b64); |
53 | /** | 52 | /** |
54 | * plainly encode to base64 representation | 53 | * plainly encode to base64 representation |
55 | * @param rv reference to the return value | 54 | * @param rv reference to the return value |
56 | */ | 55 | */ |
57 | void to_base64(string& rv) const; | 56 | void to_base64(string& rv) const; |
58 | /** | 57 | /** |
59 | * decode cleartext secret from base64 | 58 | * decode cleartext secret from base64 |
60 | * @param b64 base64-encoded representation of the secret value | 59 | * @param b64 base64-encoded representation of the secret value |
61 | */ | 60 | */ |
62 | void from_base64(const string& b64); | 61 | void from_base64(const string& b64); |
63 | }; | 62 | }; |
64 | 63 | ||
65 | /** | 64 | /** |
66 | * Interface to the association. | 65 | * Interface to the association. |
67 | */ | 66 | */ |
68 | class association_t { | 67 | class association_t { |
69 | public: | 68 | public: |
70 | 69 | ||
71 | virtual ~association_t() { } | 70 | virtual ~association_t() { } |
72 | 71 | ||
73 | /** | 72 | /** |
74 | * retrieve the server with which association was established. | 73 | * retrieve the server with which association was established. |
75 | * @return server name | 74 | * @return server name |
76 | */ | 75 | */ |
77 | virtual string server() const = 0; | 76 | virtual string server() const = 0; |
78 | /** | 77 | /** |
79 | * retrieve the association handle. | 78 | * retrieve the association handle. |
80 | * @return handle | 79 | * @return handle |
81 | */ | 80 | */ |
82 | virtual string handle() const = 0; | 81 | virtual string handle() const = 0; |
83 | /** | 82 | /** |
84 | * retrieve the association type. | 83 | * retrieve the association type. |
85 | * @return association type | 84 | * @return association type |
86 | */ | 85 | */ |
87 | virtual string assoc_type() const = 0; | 86 | virtual string assoc_type() const = 0; |
88 | /** | 87 | /** |
89 | * retrieve the association secret. | 88 | * retrieve the association secret. |
90 | * @return association secret | 89 | * @return association secret |
91 | */ | 90 | */ |
92 | virtual secret_t secret() const = 0; | 91 | virtual secret_t secret() const = 0; |
93 | /** | 92 | /** |
94 | * retrieve the number of seconds the association expires in. | 93 | * retrieve the number of seconds the association expires in. |
95 | * @return seconds till expiration | 94 | * @return seconds till expiration |
96 | */ | 95 | */ |
97 | virtual int expires_in() const = 0; | 96 | virtual int expires_in() const = 0; |
98 | /** | 97 | /** |
99 | * check whether the association is stateless. | 98 | * check whether the association is stateless. |
100 | * @return true if stateless | 99 | * @return true if stateless |
101 | */ | 100 | */ |
102 | virtual bool stateless() const = 0; | 101 | virtual bool stateless() const = 0; |
103 | /** | 102 | /** |
104 | * check whether the association is expired. | 103 | * check whether the association is expired. |
105 | * @return true if expired | 104 | * @return true if expired |
106 | */ | 105 | */ |
107 | virtual bool is_expired() const = 0; | 106 | virtual bool is_expired() const = 0; |
108 | }; | 107 | }; |
109 | 108 | ||
110 | /** | 109 | /** |
111 | * the auto_ptr<> for association_t object type | 110 | * the shared_ptr<> for association_t object type |
112 | */ | 111 | */ |
113 | typedef auto_ptr<association_t> assoc_t; | 112 | typedef tr1mem::shared_ptr<association_t> assoc_t; |
114 | 113 | ||
115 | /** | 114 | /** |
116 | * request/response parameters map | 115 | * request/response parameters map |
117 | */ | 116 | */ |
118 | class params_t : public map<string,string> { | 117 | class params_t : public map<string,string> { |
119 | public: | 118 | public: |
120 | 119 | ||
121 | /** | 120 | /** |
122 | * check whether the parameter is present. | 121 | * check whether the parameter is present. |
123 | * @param n the parameter name | 122 | * @param n the parameter name |
124 | * @return true if yes | 123 | * @return true if yes |
125 | */ | 124 | */ |
126 | bool has_param(const string& n) const; | 125 | bool has_param(const string& n) const; |
127 | /** | 126 | /** |
128 | * retrieve the parameter (const version) | 127 | * retrieve the parameter (const version) |
129 | * @param n the parameter name | 128 | * @param n the parameter name |
130 | * @return the parameter value | 129 | * @return the parameter value |
131 | * @throw failed_lookup if there is no such parameter | 130 | * @throw failed_lookup if there is no such parameter |
132 | */ | 131 | */ |
133 | const string& get_param(const string& n) const; | 132 | const string& get_param(const string& n) const; |
134 | /** | 133 | /** |
135 | * retrieve the parameter. | 134 | * retrieve the parameter. |
136 | * @param n the parameter name | 135 | * @param n the parameter name |
137 | * @return the parameter value | 136 | * @return the parameter value |
138 | * @throw failed_lookup if there is no such parameter | 137 | * @throw failed_lookup if there is no such parameter |
139 | */ | 138 | */ |
140 | string& get_param(const string& n); | 139 | string& get_param(const string& n); |
141 | 140 | ||
142 | /** | 141 | /** |
143 | * parse the OpenID key/value data. | 142 | * parse the OpenID key/value data. |
144 | * @param kv the OpenID key/value data | 143 | * @param kv the OpenID key/value data |
145 | */ | 144 | */ |
146 | void parse_keyvalues(const string& kv); | 145 | void parse_keyvalues(const string& kv); |
147 | /** | 146 | /** |
148 | * sign the fields. | 147 | * sign the fields. |
149 | * @param secret the secret used for signing | 148 | * @param secret the secret used for signing |
150 | * @param sig reference to the string, containing base64-encoded | 149 | * @param sig reference to the string, containing base64-encoded |
151 | * result | 150 | * result |
152 | * @param slist the comma-separated list of fields to sign | 151 | * @param slist the comma-separated list of fields to sign |
153 | * @param prefix the string to prepend to parameter names | 152 | * @param prefix the string to prepend to parameter names |
154 | */ | 153 | */ |
155 | void sign(secret_t secret,string& sig,const string& slist,const char *prefix=0) const; | 154 | void sign(secret_t secret,string& sig,const string& slist,const char *prefix=0) const; |
156 | 155 | ||
157 | /** | 156 | /** |
158 | * append parameters to the URL as a GET-request parameters. | 157 | * append parameters to the URL as a GET-request parameters. |
159 | * @param url the base URL | 158 | * @param url the base URL |
160 | * @param prefix the string to prepend to parameter names | 159 | * @param prefix the string to prepend to parameter names |
161 | * @return the ready-to-use location | 160 | * @return the ready-to-use location |