PageRenderTime 53ms CodeModel.GetById 21ms RepoModel.GetById 0ms app.codeStats 0ms

/plugins/openid/php-openid-2.0.0/doc/OpenID/Auth_OpenID_DumbStore.html

https://github.com/AlexChien/EY_BBS
HTML | 318 lines | 252 code | 57 blank | 9 comment | 0 complexity | cc35dbe11a41efee614613c5cceb283a MD5 | raw file
Possible License(s): Apache-2.0
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <!-- template designed by Marco Von Ballmoos -->
  6. <title>Docs For Class Auth_OpenID_DumbStore</title>
  7. <link rel="stylesheet" href="../media/stylesheet.css" />
  8. <meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
  9. </head>
  10. <body>
  11. <div class="page-body">
  12. <h2 class="class-name">Class Auth_OpenID_DumbStore</h2>
  13. <a name="sec-description"></a>
  14. <div class="info-box">
  15. <div class="info-box-title">Description</div>
  16. <div class="nav-bar">
  17. <span class="disabled">Description</span> |
  18. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  19. </div>
  20. <div class="info-box-body">
  21. <!-- ========== Info from phpDoc block ========= -->
  22. <p class="short-description">This is a store for use in the worst case, when you have no way of saving state on the consumer site. Using this store makes the consumer vulnerable to replay attacks, as it's unable to use nonces. Avoid using this store if it is at all possible.</p>
  23. <p class="description"><p>Most of the methods of this class are implementation details. Users of this class need to worry only about the constructor.</p></p>
  24. <ul class="tags">
  25. <li><span class="field">author:</span> JanRain, Inc. &lt;<a href="mailto:openid@janrain.com">openid@janrain.com</a>&gt;</li>
  26. </ul>
  27. <p class="notes">
  28. Located in <a class="field" href="_Auth---OpenID---DumbStore.php.html">/Auth/OpenID/DumbStore.php</a> (line <span class="field">34</span>)
  29. </p>
  30. <pre><a href="../OpenID/Auth_OpenID_OpenIDStore.html">Auth_OpenID_OpenIDStore</a>
  31. |
  32. --Auth_OpenID_DumbStore</pre>
  33. </div>
  34. </div>
  35. <a name="sec-method-summary"></a>
  36. <div class="info-box">
  37. <div class="info-box-title">Method Summary</span></div>
  38. <div class="nav-bar">
  39. <a href="#sec-description">Description</a> |
  40. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  41. </div>
  42. <div class="info-box-body">
  43. <div class="method-summary">
  44. <div class="method-definition">
  45. <span class="method-result">Auth_OpenID_DumbStore</span>
  46. <a href="#Auth_OpenID_DumbStore" title="details" class="method-name">Auth_OpenID_DumbStore</a>
  47. (<span class="var-type">string</span>&nbsp;<span class="var-name">$secret_phrase</span>)
  48. </div>
  49. <div class="method-definition">
  50. <span class="method-result">void</span>
  51. <a href="#getAssociation" title="details" class="method-name">getAssociation</a>
  52. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, [<span class="var-type"></span>&nbsp;<span class="var-name">$handle</span> = <span class="var-default">null</span>])
  53. </div>
  54. <div class="method-definition">
  55. <span class="method-result">void</span>
  56. <a href="#getAuthKey" title="details" class="method-name">getAuthKey</a>
  57. ()
  58. </div>
  59. <div class="method-definition">
  60. <span class="method-result">void</span>
  61. <a href="#removeAssociation" title="details" class="method-name">removeAssociation</a>
  62. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$handle</span>)
  63. </div>
  64. <div class="method-definition">
  65. <span class="method-result">void</span>
  66. <a href="#storeAssociation" title="details" class="method-name">storeAssociation</a>
  67. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$association</span>)
  68. </div>
  69. <div class="method-definition">
  70. <span class="method-result">void</span>
  71. <a href="#useNonce" title="details" class="method-name">useNonce</a>
  72. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$timestamp</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$salt</span>)
  73. </div>
  74. </div>
  75. </div>
  76. </div>
  77. <a name="sec-methods"></a>
  78. <div class="info-box">
  79. <div class="info-box-title">Methods</div>
  80. <div class="nav-bar">
  81. <a href="#sec-description">Description</a> |
  82. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  83. </div>
  84. <div class="info-box-body">
  85. <A NAME='method_detail'></A>
  86. <a name="methodAuth_OpenID_DumbStore" id="Auth_OpenID_DumbStore"><!-- --></a>
  87. <div class="evenrow">
  88. <div class="method-header">
  89. <span class="method-title">Constructor Auth_OpenID_DumbStore</span> (line <span class="line-number">53</span>)
  90. </div>
  91. <!-- ========== Info from phpDoc block ========= -->
  92. <p class="short-description">Creates a new <a href="../OpenID/Auth_OpenID_DumbStore.html">Auth_OpenID_DumbStore</a> instance. For the security of the tokens generated by the library, this class attempts to at least have a secure implementation of getAuthKey.</p>
  93. <p class="description"><p>When you create an instance of this class, pass in a secret phrase. The phrase is hashed with sha1 to make it the correct length and form for an auth key. That allows you to use a long string as the secret phrase, which means you can make it very difficult to guess.</p><p>Each <a href="../OpenID/Auth_OpenID_DumbStore.html">Auth_OpenID_DumbStore</a> instance that is created for use by your consumer site needs to use the same $secret_phrase.</p></p>
  94. <div class="method-signature">
  95. <span class="method-result">Auth_OpenID_DumbStore</span>
  96. <span class="method-name">
  97. Auth_OpenID_DumbStore
  98. </span>
  99. (<span class="var-type">string</span>&nbsp;<span class="var-name">$secret_phrase</span>)
  100. </div>
  101. <ul class="parameters">
  102. <li>
  103. <span class="var-type">string</span>
  104. <span class="var-name">$secret_phrase</span><span class="var-description">: secret_phrase The phrase used to create the auth key returned by getAuthKey</span> </li>
  105. </ul>
  106. </div>
  107. <a name="methodgetAssociation" id="getAssociation"><!-- --></a>
  108. <div class="oddrow">
  109. <div class="method-header">
  110. <span class="method-title">getAssociation</span> (line <span class="line-number">68</span>)
  111. </div>
  112. <!-- ========== Info from phpDoc block ========= -->
  113. <p class="short-description">This implementation always returns null.</p>
  114. <div class="method-signature">
  115. <span class="method-result">void</span>
  116. <span class="method-name">
  117. getAssociation
  118. </span>
  119. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, [<span class="var-type"></span>&nbsp;<span class="var-name">$handle</span> = <span class="var-default">null</span>])
  120. </div>
  121. <ul class="parameters">
  122. <li>
  123. <span class="var-type"></span>
  124. <span class="var-name">$server_url</span> </li>
  125. <li>
  126. <span class="var-type"></span>
  127. <span class="var-name">$handle</span> </li>
  128. </ul>
  129. <hr class="separator" />
  130. <div class="notes">Redefinition of:</div>
  131. <dl>
  132. <dt><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodgetAssociation">Auth_OpenID_OpenIDStore::getAssociation()</a></dt>
  133. <dd>This method returns an Association object from storage that matches the server URL and, if specified, handle. It returns null if no such association is found or if the matching association is expired.</dd>
  134. </dl>
  135. </div>
  136. <a name="methodgetAuthKey" id="getAuthKey"><!-- --></a>
  137. <div class="evenrow">
  138. <div class="method-header">
  139. <span class="method-title">getAuthKey</span> (line <span class="line-number">94</span>)
  140. </div>
  141. <!-- ========== Info from phpDoc block ========= -->
  142. <p class="short-description">This method returns the auth key generated by the constructor.</p>
  143. <div class="method-signature">
  144. <span class="method-result">void</span>
  145. <span class="method-name">
  146. getAuthKey
  147. </span>
  148. ()
  149. </div>
  150. </div>
  151. <a name="methodremoveAssociation" id="removeAssociation"><!-- --></a>
  152. <div class="oddrow">
  153. <div class="method-header">
  154. <span class="method-title">removeAssociation</span> (line <span class="line-number">76</span>)
  155. </div>
  156. <!-- ========== Info from phpDoc block ========= -->
  157. <p class="short-description">This implementation always returns false.</p>
  158. <div class="method-signature">
  159. <span class="method-result">void</span>
  160. <span class="method-name">
  161. removeAssociation
  162. </span>
  163. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$handle</span>)
  164. </div>
  165. <ul class="parameters">
  166. <li>
  167. <span class="var-type"></span>
  168. <span class="var-name">$server_url</span> </li>
  169. <li>
  170. <span class="var-type"></span>
  171. <span class="var-name">$handle</span> </li>
  172. </ul>
  173. <hr class="separator" />
  174. <div class="notes">Redefinition of:</div>
  175. <dl>
  176. <dt><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodremoveAssociation">Auth_OpenID_OpenIDStore::removeAssociation()</a></dt>
  177. <dd>This method removes the matching association if it's found, and returns whether the association was removed or not.</dd>
  178. </dl>
  179. </div>
  180. <a name="methodstoreAssociation" id="storeAssociation"><!-- --></a>
  181. <div class="evenrow">
  182. <div class="method-header">
  183. <span class="method-title">storeAssociation</span> (line <span class="line-number">61</span>)
  184. </div>
  185. <!-- ========== Info from phpDoc block ========= -->
  186. <p class="short-description">This implementation does nothing.</p>
  187. <div class="method-signature">
  188. <span class="method-result">void</span>
  189. <span class="method-name">
  190. storeAssociation
  191. </span>
  192. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$association</span>)
  193. </div>
  194. <ul class="parameters">
  195. <li>
  196. <span class="var-type"></span>
  197. <span class="var-name">$server_url</span> </li>
  198. <li>
  199. <span class="var-type"></span>
  200. <span class="var-name">$association</span> </li>
  201. </ul>
  202. <hr class="separator" />
  203. <div class="notes">Redefinition of:</div>
  204. <dl>
  205. <dt><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodstoreAssociation">Auth_OpenID_OpenIDStore::storeAssociation()</a></dt>
  206. <dd>This method puts an Association object into storage, retrievable by server URL and handle.</dd>
  207. </dl>
  208. </div>
  209. <a name="methoduseNonce" id="useNonce"><!-- --></a>
  210. <div class="oddrow">
  211. <div class="method-header">
  212. <span class="method-title">useNonce</span> (line <span class="line-number">86</span>)
  213. </div>
  214. <!-- ========== Info from phpDoc block ========= -->
  215. <p class="short-description">In a system truly limited to dumb mode, nonces must all be accepted. This therefore always returns true, which makes replay attacks feasible.</p>
  216. <div class="method-signature">
  217. <span class="method-result">void</span>
  218. <span class="method-name">
  219. useNonce
  220. </span>
  221. (<span class="var-type"></span>&nbsp;<span class="var-name">$server_url</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$timestamp</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$salt</span>)
  222. </div>
  223. <ul class="parameters">
  224. <li>
  225. <span class="var-type"></span>
  226. <span class="var-name">$server_url</span> </li>
  227. <li>
  228. <span class="var-type"></span>
  229. <span class="var-name">$timestamp</span> </li>
  230. <li>
  231. <span class="var-type"></span>
  232. <span class="var-name">$salt</span> </li>
  233. </ul>
  234. <hr class="separator" />
  235. <div class="notes">Redefinition of:</div>
  236. <dl>
  237. <dt><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methoduseNonce">Auth_OpenID_OpenIDStore::useNonce()</a></dt>
  238. <dd>Called when using a nonce.</dd>
  239. </dl>
  240. </div>
  241. <h4>Inherited Methods</h4>
  242. <a name='inherited_methods'><!-- --></a>
  243. <!-- =========== Summary =========== -->
  244. <p>Inherited From <span class="classname"><a href="../OpenID/Auth_OpenID_OpenIDStore.html">Auth_OpenID_OpenIDStore</a></span></p>
  245. <blockquote>
  246. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodcleanup">Auth_OpenID_OpenIDStore::cleanup()</a></span><br>
  247. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodcleanupAssociations">Auth_OpenID_OpenIDStore::cleanupAssociations()</a></span><br>
  248. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodcleanupNonces">Auth_OpenID_OpenIDStore::cleanupNonces()</a></span><br>
  249. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodgetAssociation">Auth_OpenID_OpenIDStore::getAssociation()</a></span><br>
  250. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodremoveAssociation">Auth_OpenID_OpenIDStore::removeAssociation()</a></span><br>
  251. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodreset">Auth_OpenID_OpenIDStore::reset()</a></span><br>
  252. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methodstoreAssociation">Auth_OpenID_OpenIDStore::storeAssociation()</a></span><br>
  253. <span class="method-name"><a href="../OpenID/Auth_OpenID_OpenIDStore.html#methoduseNonce">Auth_OpenID_OpenIDStore::useNonce()</a></span><br>
  254. </blockquote>
  255. </div>
  256. </div>
  257. <p class="notes" id="credit">
  258. Documentation generated on Wed, 05 Dec 2007 14:02:12 -0800 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.3.2</a>
  259. </p>
  260. </div></body>
  261. </html>