IVisa.html 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!-- NewPage -->
  3. <html lang="en">
  4. <head>
  5. <!-- Generated by javadoc (1.8.0-internal) on Thu Mar 24 15:49:00 EDT 2022 -->
  6. <title>IVisa</title>
  7. <meta name="date" content="2022-03-24">
  8. <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
  9. <script type="text/javascript" src="../../../../script.js"></script>
  10. </head>
  11. <body>
  12. <script type="text/javascript"><!--
  13. try {
  14. if (location.href.indexOf('is-external=true') == -1) {
  15. parent.document.title="IVisa";
  16. }
  17. }
  18. catch(err) {
  19. }
  20. //-->
  21. var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6};
  22. var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]};
  23. var altColor = "altColor";
  24. var rowColor = "rowColor";
  25. var tableTab = "tableTab";
  26. var activeTableTab = "activeTableTab";
  27. </script>
  28. <noscript>
  29. <div>JavaScript is disabled on your browser.</div>
  30. </noscript>
  31. <!-- ========= START OF TOP NAVBAR ======= -->
  32. <div role="navigation" title ="TOP_Navigation" aria-label ="Top Navigation Bar"/>
  33. <div class="topNav"><a name="navbar.top">
  34. <!-- -->
  35. </a>
  36. <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
  37. <a name="navbar.top.firstrow">
  38. <!-- -->
  39. </a>
  40. <ul class="navList" title="Navigation">
  41. <li><a href="../../../../com/cognos/CAM_AAA/authentication/package-summary.html">Package</a></li>
  42. <li class="navBarCell1Rev">Class</li>
  43. <li><a href="package-tree.html">Tree</a></li>
  44. <li><a href="../../../../deprecated-list.html">Deprecated</a></li>
  45. <li><a href="../../../../index-all.html">Index</a></li>
  46. <li><a href="../../../../help-doc.html">Help</a></li>
  47. </ul>
  48. </div>
  49. <div class="subNav">
  50. <ul class="navList">
  51. <li><a href="../../../../com/cognos/CAM_AAA/authentication/IVerifyTextNoEchoDisplayObject.html" title="interface in com.cognos.CAM_AAA.authentication"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
  52. <li><a href="../../../../com/cognos/CAM_AAA/authentication/MultiSelectDisplayObject.html" title="class in com.cognos.CAM_AAA.authentication"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
  53. </ul>
  54. <ul class="navList">
  55. <li><a href="../../../../index.html?com/cognos/CAM_AAA/authentication/IVisa.html" target="_top">Frames</a></li>
  56. <li><a href="IVisa.html" target="_top">No&nbsp;Frames</a></li>
  57. </ul>
  58. <ul class="navList" id="allclasses_navbar_top">
  59. <li><a href="../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
  60. </ul>
  61. <div>
  62. <script type="text/javascript"><!--
  63. allClassesLink = document.getElementById("allclasses_navbar_top");
  64. if(window==top) {
  65. allClassesLink.style.display = "block";
  66. }
  67. else {
  68. allClassesLink.style.display = "none";
  69. }
  70. //-->
  71. </script>
  72. </div>
  73. <div>
  74. <ul class="subNavList">
  75. <li>Summary:&nbsp;</li>
  76. <li>Nested&nbsp;|&nbsp;</li>
  77. <li>Field&nbsp;|&nbsp;</li>
  78. <li>Constr&nbsp;|&nbsp;</li>
  79. <li><a href="#method.summary">Method</a></li>
  80. </ul>
  81. <ul class="subNavList">
  82. <li>Detail:&nbsp;</li>
  83. <li>Field&nbsp;|&nbsp;</li>
  84. <li>Constr&nbsp;|&nbsp;</li>
  85. <li><a href="#method.detail">Method</a></li>
  86. </ul>
  87. </div>
  88. <a name="skip.navbar.top">
  89. <!-- -->
  90. </a></div>
  91. <!-- ========= END OF TOP NAVBAR ========= -->
  92. <!-- ======== START OF CLASS DATA ======== -->
  93. <div role="main" title ="IVisa" aria-labelledby ="Header1"/>
  94. <div class="header">
  95. <div class="subTitle">com.cognos.CAM_AAA.authentication</div>
  96. <h2 title="Interface IVisa" class="title" id="Header1">Interface IVisa</h2>
  97. </div>
  98. <div class="contentContainer">
  99. <div class="description">
  100. <ul class="blockList">
  101. <li class="blockList">
  102. <dl>
  103. <dt>All Known Subinterfaces:</dt>
  104. <dd><a href="../../../../com/cognos/CAM_AAA/authentication/IRestorableVisa.html" title="interface in com.cognos.CAM_AAA.authentication">IRestorableVisa</a></dd>
  105. </dl>
  106. <hr>
  107. <br>
  108. <pre>public interface <span class="typeNameLabel">IVisa</span></pre>
  109. <div class="block">Defines the interface to be used for implementing a visa. A visa is
  110. used to maintain state information for the logged on user. A visa is tied to
  111. a user's session.</div>
  112. </li>
  113. </ul>
  114. </div>
  115. <div class="summary">
  116. <ul class="blockList">
  117. <li class="blockList">
  118. <!-- ========== METHOD SUMMARY =========== -->
  119. <ul class="blockList">
  120. <li class="blockList"><a name="method.summary">
  121. <!-- -->
  122. </a>
  123. <h3>Method Summary</h3>
  124. <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
  125. <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
  126. <tr>
  127. <th class="colFirst" scope="col">Modifier and Type</th>
  128. <th class="colLast" scope="col">Method and Description</th>
  129. </tr>
  130. <tr id="i0" class="altColor">
  131. <td class="colFirst"><code><a href="../../../../com/cognos/CAM_AAA/authentication/ICredential.html" title="interface in com.cognos.CAM_AAA.authentication">ICredential</a></code></td>
  132. <td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/cognos/CAM_AAA/authentication/IVisa.html#generateCredential-com.cognos.CAM_AAA.authentication.IBiBusHeader-">generateCredential</a></span>(<a href="../../../../com/cognos/CAM_AAA/authentication/IBiBusHeader.html" title="interface in com.cognos.CAM_AAA.authentication">IBiBusHeader</a>&nbsp;theBiBusHeader)</code>
  133. <div class="block">Generates credentials for the user.</div>
  134. </td>
  135. </tr>
  136. <tr id="i1" class="rowColor">
  137. <td class="colFirst"><code><a href="../../../../com/cognos/CAM_AAA/authentication/ITrustedCredential.html" title="interface in com.cognos.CAM_AAA.authentication">ITrustedCredential</a></code></td>
  138. <td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/cognos/CAM_AAA/authentication/IVisa.html#generateTrustedCredential-com.cognos.CAM_AAA.authentication.IBiBusHeader-">generateTrustedCredential</a></span>(<a href="../../../../com/cognos/CAM_AAA/authentication/IBiBusHeader.html" title="interface in com.cognos.CAM_AAA.authentication">IBiBusHeader</a>&nbsp;theBiBusHeader)</code>
  139. <div class="block">Generates trusted credentials for the user.</div>
  140. </td>
  141. </tr>
  142. <tr id="i2" class="altColor">
  143. <td class="colFirst"><code><a href="../../../../com/cognos/CAM_AAA/authentication/IAccount.html" title="interface in com.cognos.CAM_AAA.authentication">IAccount</a></code></td>
  144. <td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/cognos/CAM_AAA/authentication/IVisa.html#getAccount--">getAccount</a></span>()</code>
  145. <div class="block">Returns information about the logged on user.</div>
  146. </td>
  147. </tr>
  148. <tr id="i3" class="rowColor">
  149. <td class="colFirst"><code><a href="../../../../com/cognos/CAM_AAA/authentication/IGroup.html" title="interface in com.cognos.CAM_AAA.authentication">IGroup</a>[]</code></td>
  150. <td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/cognos/CAM_AAA/authentication/IVisa.html#getGroups--">getGroups</a></span>()</code>
  151. <div class="block">Returns the groups of which the user is a member.</div>
  152. </td>
  153. </tr>
  154. <tr id="i4" class="altColor">
  155. <td class="colFirst"><code><a href="../../../../com/cognos/CAM_AAA/authentication/IRole.html" title="interface in com.cognos.CAM_AAA.authentication">IRole</a>[]</code></td>
  156. <td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/cognos/CAM_AAA/authentication/IVisa.html#getRoles--">getRoles</a></span>()</code>
  157. <div class="block">Returns the roles of which the user is a member.</div>
  158. </td>
  159. </tr>
  160. <tr id="i5" class="rowColor">
  161. <td class="colFirst"><code>boolean</code></td>
  162. <td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/cognos/CAM_AAA/authentication/IVisa.html#isValid--">isValid</a></span>()</code>
  163. <div class="block">Verifies whether a visa is still valid.</div>
  164. </td>
  165. </tr>
  166. </table>
  167. </li>
  168. </ul>
  169. </li>
  170. </ul>
  171. </div>
  172. <div class="details">
  173. <ul class="blockList">
  174. <li class="blockList">
  175. <!-- ============ METHOD DETAIL ========== -->
  176. <ul class="blockList">
  177. <li class="blockList"><a name="method.detail">
  178. <!-- -->
  179. </a>
  180. <h3>Method Detail</h3>
  181. <a name="generateTrustedCredential-com.cognos.CAM_AAA.authentication.IBiBusHeader-">
  182. <!-- -->
  183. </a>
  184. <ul class="blockList">
  185. <li class="blockList">
  186. <h4>generateTrustedCredential</h4>
  187. <pre><a href="../../../../com/cognos/CAM_AAA/authentication/ITrustedCredential.html" title="interface in com.cognos.CAM_AAA.authentication">ITrustedCredential</a>&nbsp;generateTrustedCredential(<a href="../../../../com/cognos/CAM_AAA/authentication/IBiBusHeader.html" title="interface in com.cognos.CAM_AAA.authentication">IBiBusHeader</a>&nbsp;theBiBusHeader)
  188. throws <a href="../../../../com/cognos/CAM_AAA/authentication/UserRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UserRecoverableException</a>,
  189. <a href="../../../../com/cognos/CAM_AAA/authentication/SystemRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">SystemRecoverableException</a>,
  190. <a href="../../../../com/cognos/CAM_AAA/authentication/UnrecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UnrecoverableException</a></pre>
  191. <div class="block">Generates trusted credentials for the user. A trusted credential
  192. contains authentication information that is stored for a later usage
  193. and does not expire.</div>
  194. <dl>
  195. <dt><span class="paramLabel">Parameters:</span></dt>
  196. <dd><code>theBiBusHeader</code> - Request containing the information used to generate this
  197. trusted credential for the user.</dd>
  198. <dt><span class="returnLabel">Returns:</span></dt>
  199. <dd>Valid trusted credentials for the owner of the visa.</dd>
  200. <dt><span class="throwsLabel">Throws:</span></dt>
  201. <dd><code><a href="../../../../com/cognos/CAM_AAA/authentication/UserRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UserRecoverableException</a></code> - Indicates that this trusted credential cannot be generated
  202. using the available information. It may be possible to
  203. generate a trusted credential after interacting with the user.</dd>
  204. <dd><code><a href="../../../../com/cognos/CAM_AAA/authentication/SystemRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">SystemRecoverableException</a></code> - Indicates that this trusted credential cannot be generated
  205. using the available information. It may be possible to
  206. generate a trusted after interacting with the system.</dd>
  207. <dd><code><a href="../../../../com/cognos/CAM_AAA/authentication/UnrecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UnrecoverableException</a></code> - Indicates that an exception has occurred that interferes with the
  208. normal operation of the namespace.</dd>
  209. </dl>
  210. </li>
  211. </ul>
  212. <a name="generateCredential-com.cognos.CAM_AAA.authentication.IBiBusHeader-">
  213. <!-- -->
  214. </a>
  215. <ul class="blockList">
  216. <li class="blockList">
  217. <h4>generateCredential</h4>
  218. <pre><a href="../../../../com/cognos/CAM_AAA/authentication/ICredential.html" title="interface in com.cognos.CAM_AAA.authentication">ICredential</a>&nbsp;generateCredential(<a href="../../../../com/cognos/CAM_AAA/authentication/IBiBusHeader.html" title="interface in com.cognos.CAM_AAA.authentication">IBiBusHeader</a>&nbsp;theBiBusHeader)
  219. throws <a href="../../../../com/cognos/CAM_AAA/authentication/UserRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UserRecoverableException</a>,
  220. <a href="../../../../com/cognos/CAM_AAA/authentication/SystemRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">SystemRecoverableException</a>,
  221. <a href="../../../../com/cognos/CAM_AAA/authentication/UnrecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UnrecoverableException</a></pre>
  222. <div class="block">Generates credentials for the user. A credential contains authentication
  223. information that can be used to achieve SSO with the database system.
  224. Unlike trusted credentials, this type of credential is not stored anywhere
  225. and can expire.</div>
  226. <dl>
  227. <dt><span class="paramLabel">Parameters:</span></dt>
  228. <dd><code>theBiBusHeader</code> - Request containing the information used to generate the
  229. credential for the caller.</dd>
  230. <dt><span class="returnLabel">Returns:</span></dt>
  231. <dd>Valid credentials for the owner of the visa.</dd>
  232. <dt><span class="throwsLabel">Throws:</span></dt>
  233. <dd><code><a href="../../../../com/cognos/CAM_AAA/authentication/UserRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UserRecoverableException</a></code> - Indicates that this trusted credential cannot be generated
  234. using the available information. It may be possible to
  235. generate a trusted credential after interacting with the user.</dd>
  236. <dd><code><a href="../../../../com/cognos/CAM_AAA/authentication/SystemRecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">SystemRecoverableException</a></code> - Indicates that this trusted credential cannot be generated
  237. using the available information. It may be possible to
  238. generate a trusted after interacting with the system.</dd>
  239. <dd><code><a href="../../../../com/cognos/CAM_AAA/authentication/UnrecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UnrecoverableException</a></code> - Indicates that an exception has occurred that interferes with the
  240. normal operation of the namespace.</dd>
  241. </dl>
  242. </li>
  243. </ul>
  244. <a name="isValid--">
  245. <!-- -->
  246. </a>
  247. <ul class="blockList">
  248. <li class="blockList">
  249. <h4>isValid</h4>
  250. <pre>boolean&nbsp;isValid()</pre>
  251. <div class="block">Verifies whether a visa is still valid.</div>
  252. <dl>
  253. <dt><span class="returnLabel">Returns:</span></dt>
  254. <dd>A boolean to indicate whether the visa is valid.</dd>
  255. </dl>
  256. </li>
  257. </ul>
  258. <a name="getAccount--">
  259. <!-- -->
  260. </a>
  261. <ul class="blockList">
  262. <li class="blockList">
  263. <h4>getAccount</h4>
  264. <pre><a href="../../../../com/cognos/CAM_AAA/authentication/IAccount.html" title="interface in com.cognos.CAM_AAA.authentication">IAccount</a>&nbsp;getAccount()</pre>
  265. <div class="block">Returns information about the logged on user.</div>
  266. <dl>
  267. <dt><span class="returnLabel">Returns:</span></dt>
  268. <dd>The account object for the logged on user.</dd>
  269. </dl>
  270. </li>
  271. </ul>
  272. <a name="getGroups--">
  273. <!-- -->
  274. </a>
  275. <ul class="blockList">
  276. <li class="blockList">
  277. <h4>getGroups</h4>
  278. <pre><a href="../../../../com/cognos/CAM_AAA/authentication/IGroup.html" title="interface in com.cognos.CAM_AAA.authentication">IGroup</a>[]&nbsp;getGroups()</pre>
  279. <div class="block">Returns the groups of which the user is a member.</div>
  280. <dl>
  281. <dt><span class="returnLabel">Returns:</span></dt>
  282. <dd>The groups of which the user is a member.</dd>
  283. </dl>
  284. </li>
  285. </ul>
  286. <a name="getRoles--">
  287. <!-- -->
  288. </a>
  289. <ul class="blockListLast">
  290. <li class="blockList">
  291. <h4>getRoles</h4>
  292. <pre><a href="../../../../com/cognos/CAM_AAA/authentication/IRole.html" title="interface in com.cognos.CAM_AAA.authentication">IRole</a>[]&nbsp;getRoles()</pre>
  293. <div class="block">Returns the roles of which the user is a member.</div>
  294. <dl>
  295. <dt><span class="returnLabel">Returns:</span></dt>
  296. <dd>The roles of which the user is a member.</dd>
  297. </dl>
  298. </li>
  299. </ul>
  300. </li>
  301. </ul>
  302. </li>
  303. </ul>
  304. </div>
  305. </div>
  306. <!-- ========= END OF CLASS DATA ========= -->
  307. <!-- ======= START OF BOTTOM NAVBAR ====== -->
  308. <div role="navigation" title ="Bottom_NAVIGATION" aria-label ="Bottom Navigation Bar"/>
  309. <div class="bottomNav"><a name="navbar.bottom">
  310. <!-- -->
  311. </a>
  312. <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
  313. <a name="navbar.bottom.firstrow">
  314. <!-- -->
  315. </a>
  316. <ul class="navList" title="Navigation">
  317. <li><a href="../../../../com/cognos/CAM_AAA/authentication/package-summary.html">Package</a></li>
  318. <li class="navBarCell1Rev">Class</li>
  319. <li><a href="package-tree.html">Tree</a></li>
  320. <li><a href="../../../../deprecated-list.html">Deprecated</a></li>
  321. <li><a href="../../../../index-all.html">Index</a></li>
  322. <li><a href="../../../../help-doc.html">Help</a></li>
  323. </ul>
  324. </div>
  325. <div class="subNav">
  326. <ul class="navList">
  327. <li><a href="../../../../com/cognos/CAM_AAA/authentication/IVerifyTextNoEchoDisplayObject.html" title="interface in com.cognos.CAM_AAA.authentication"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
  328. <li><a href="../../../../com/cognos/CAM_AAA/authentication/MultiSelectDisplayObject.html" title="class in com.cognos.CAM_AAA.authentication"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
  329. </ul>
  330. <ul class="navList">
  331. <li><a href="../../../../index.html?com/cognos/CAM_AAA/authentication/IVisa.html" target="_top">Frames</a></li>
  332. <li><a href="IVisa.html" target="_top">No&nbsp;Frames</a></li>
  333. </ul>
  334. <ul class="navList" id="allclasses_navbar_bottom">
  335. <li><a href="../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
  336. </ul>
  337. <div>
  338. <script type="text/javascript"><!--
  339. allClassesLink = document.getElementById("allclasses_navbar_bottom");
  340. if(window==top) {
  341. allClassesLink.style.display = "block";
  342. }
  343. else {
  344. allClassesLink.style.display = "none";
  345. }
  346. //-->
  347. </script>
  348. </div>
  349. <div>
  350. <ul class="subNavList">
  351. <li>Summary:&nbsp;</li>
  352. <li>Nested&nbsp;|&nbsp;</li>
  353. <li>Field&nbsp;|&nbsp;</li>
  354. <li>Constr&nbsp;|&nbsp;</li>
  355. <li><a href="#method.summary">Method</a></li>
  356. </ul>
  357. <ul class="subNavList">
  358. <li>Detail:&nbsp;</li>
  359. <li>Field&nbsp;|&nbsp;</li>
  360. <li>Constr&nbsp;|&nbsp;</li>
  361. <li><a href="#method.detail">Method</a></li>
  362. </ul>
  363. </div>
  364. <a name="skip.navbar.bottom">
  365. <!-- -->
  366. </a></div>
  367. <!-- ======== END OF BOTTOM NAVBAR ======= -->
  368. </body>
  369. </html>