ITenantProvider.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251
  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>ITenantProvider</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="ITenantProvider";
  16. }
  17. }
  18. catch(err) {
  19. }
  20. //-->
  21. var methods = {"i0":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/ISortProperty.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/ITextDisplayObject.html" title="interface 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/ITenantProvider.html" target="_top">Frames</a></li>
  56. <li><a href="ITenantProvider.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 ="ITenantProvider" aria-labelledby ="Header1"/>
  94. <div class="header">
  95. <div class="subTitle">com.cognos.CAM_AAA.authentication</div>
  96. <h2 title="Interface ITenantProvider" class="title" id="Header1">Interface ITenantProvider</h2>
  97. </div>
  98. <div class="contentContainer">
  99. <div class="description">
  100. <ul class="blockList">
  101. <li class="blockList">
  102. <dl>
  103. <dt>All Superinterfaces:</dt>
  104. <dd><a href="../../../../com/cognos/CAM_AAA/authentication/IProvider.html" title="interface in com.cognos.CAM_AAA.authentication">IProvider</a></dd>
  105. </dl>
  106. <hr>
  107. <br>
  108. <pre>public interface <span class="typeNameLabel">ITenantProvider</span>
  109. extends <a href="../../../../com/cognos/CAM_AAA/authentication/IProvider.html" title="interface in com.cognos.CAM_AAA.authentication">IProvider</a></pre>
  110. <div class="block">Defines the interface for implementing a custom tenant identifier provider for use in a multi-tenant environment. <br>
  111. During system startup <a href="../../../../com/cognos/CAM_AAA/authentication/IProvider.html#init-java.util.Map-java.lang.String-"><code>IProvider.init(Map, String)</code></a> will be called once per configured instance. While the system is running
  112. <a href="../../../../com/cognos/CAM_AAA/authentication/ITenantProvider.html#getTenantId-com.cognos.CAM_AAA.authentication.IAccount-"><code>getTenantId(IAccount)</code></a> will be called as accounts are logged on to. The <a href="../../../../com/cognos/CAM_AAA/authentication/IProvider.html#destroy--"><code>IProvider.destroy()</code></a> method will be called at
  113. system shutdown. It is possible that multiple instances of the provider are created for a single namespace, this occurs when more
  114. than one CAM AAA service exists on the machine.</div>
  115. </li>
  116. </ul>
  117. </div>
  118. <div class="summary">
  119. <ul class="blockList">
  120. <li class="blockList">
  121. <!-- ========== METHOD SUMMARY =========== -->
  122. <ul class="blockList">
  123. <li class="blockList"><a name="method.summary">
  124. <!-- -->
  125. </a>
  126. <h3>Method Summary</h3>
  127. <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
  128. <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>
  129. <tr>
  130. <th class="colFirst" scope="col">Modifier and Type</th>
  131. <th class="colLast" scope="col">Method and Description</th>
  132. </tr>
  133. <tr id="i0" class="altColor">
  134. <td class="colFirst"><code>java.lang.String</code></td>
  135. <td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/cognos/CAM_AAA/authentication/ITenantProvider.html#getTenantId-com.cognos.CAM_AAA.authentication.IAccount-">getTenantId</a></span>(<a href="../../../../com/cognos/CAM_AAA/authentication/IAccount.html" title="interface in com.cognos.CAM_AAA.authentication">IAccount</a>&nbsp;account)</code>
  136. <div class="block">Any Unicode character is allowed in a tenantID, with the exception of tabs, carriage returns, and line feeds.</div>
  137. </td>
  138. </tr>
  139. </table>
  140. <ul class="blockList">
  141. <li class="blockList"><a name="methods.inherited.from.class.com.cognos.CAM_AAA.authentication.IProvider">
  142. <!-- -->
  143. </a>
  144. <h3>Methods inherited from interface&nbsp;com.cognos.CAM_AAA.authentication.<a href="../../../../com/cognos/CAM_AAA/authentication/IProvider.html" title="interface in com.cognos.CAM_AAA.authentication">IProvider</a></h3>
  145. <code><a href="../../../../com/cognos/CAM_AAA/authentication/IProvider.html#destroy--">destroy</a>, <a href="../../../../com/cognos/CAM_AAA/authentication/IProvider.html#init-java.util.Map-java.lang.String-">init</a></code></li>
  146. </ul>
  147. </li>
  148. </ul>
  149. </li>
  150. </ul>
  151. </div>
  152. <div class="details">
  153. <ul class="blockList">
  154. <li class="blockList">
  155. <!-- ============ METHOD DETAIL ========== -->
  156. <ul class="blockList">
  157. <li class="blockList"><a name="method.detail">
  158. <!-- -->
  159. </a>
  160. <h3>Method Detail</h3>
  161. <a name="getTenantId-com.cognos.CAM_AAA.authentication.IAccount-">
  162. <!-- -->
  163. </a>
  164. <ul class="blockListLast">
  165. <li class="blockList">
  166. <h4>getTenantId</h4>
  167. <pre>java.lang.String&nbsp;getTenantId(<a href="../../../../com/cognos/CAM_AAA/authentication/IAccount.html" title="interface in com.cognos.CAM_AAA.authentication">IAccount</a>&nbsp;account)
  168. throws <a href="../../../../com/cognos/CAM_AAA/authentication/UnrecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UnrecoverableException</a></pre>
  169. <div class="block">Any Unicode character is allowed in a tenantID, with the exception of tabs, carriage returns, and line feeds. Leading and
  170. trailing spaces are trimmed, and consecutive internal spaces are reduced to one. A tenantID consisting only of spaces is
  171. reduced to an empty string which is reserved for public content.</div>
  172. <dl>
  173. <dt><span class="paramLabel">Parameters:</span></dt>
  174. <dd><code>account</code> - The account that has been logged on to.</dd>
  175. <dt><span class="returnLabel">Returns:</span></dt>
  176. <dd>The identifier of the tenant the account belongs to.</dd>
  177. <dt><span class="throwsLabel">Throws:</span></dt>
  178. <dd><code><a href="../../../../com/cognos/CAM_AAA/authentication/UnrecoverableException.html" title="class in com.cognos.CAM_AAA.authentication">UnrecoverableException</a></code> - An exception occurred while determining which tenant the account belongs to.</dd>
  179. </dl>
  180. </li>
  181. </ul>
  182. </li>
  183. </ul>
  184. </li>
  185. </ul>
  186. </div>
  187. </div>
  188. <!-- ========= END OF CLASS DATA ========= -->
  189. <!-- ======= START OF BOTTOM NAVBAR ====== -->
  190. <div role="navigation" title ="Bottom_NAVIGATION" aria-label ="Bottom Navigation Bar"/>
  191. <div class="bottomNav"><a name="navbar.bottom">
  192. <!-- -->
  193. </a>
  194. <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
  195. <a name="navbar.bottom.firstrow">
  196. <!-- -->
  197. </a>
  198. <ul class="navList" title="Navigation">
  199. <li><a href="../../../../com/cognos/CAM_AAA/authentication/package-summary.html">Package</a></li>
  200. <li class="navBarCell1Rev">Class</li>
  201. <li><a href="package-tree.html">Tree</a></li>
  202. <li><a href="../../../../deprecated-list.html">Deprecated</a></li>
  203. <li><a href="../../../../index-all.html">Index</a></li>
  204. <li><a href="../../../../help-doc.html">Help</a></li>
  205. </ul>
  206. </div>
  207. <div class="subNav">
  208. <ul class="navList">
  209. <li><a href="../../../../com/cognos/CAM_AAA/authentication/ISortProperty.html" title="interface in com.cognos.CAM_AAA.authentication"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
  210. <li><a href="../../../../com/cognos/CAM_AAA/authentication/ITextDisplayObject.html" title="interface in com.cognos.CAM_AAA.authentication"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
  211. </ul>
  212. <ul class="navList">
  213. <li><a href="../../../../index.html?com/cognos/CAM_AAA/authentication/ITenantProvider.html" target="_top">Frames</a></li>
  214. <li><a href="ITenantProvider.html" target="_top">No&nbsp;Frames</a></li>
  215. </ul>
  216. <ul class="navList" id="allclasses_navbar_bottom">
  217. <li><a href="../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
  218. </ul>
  219. <div>
  220. <script type="text/javascript"><!--
  221. allClassesLink = document.getElementById("allclasses_navbar_bottom");
  222. if(window==top) {
  223. allClassesLink.style.display = "block";
  224. }
  225. else {
  226. allClassesLink.style.display = "none";
  227. }
  228. //-->
  229. </script>
  230. </div>
  231. <div>
  232. <ul class="subNavList">
  233. <li>Summary:&nbsp;</li>
  234. <li>Nested&nbsp;|&nbsp;</li>
  235. <li>Field&nbsp;|&nbsp;</li>
  236. <li>Constr&nbsp;|&nbsp;</li>
  237. <li><a href="#method.summary">Method</a></li>
  238. </ul>
  239. <ul class="subNavList">
  240. <li>Detail:&nbsp;</li>
  241. <li>Field&nbsp;|&nbsp;</li>
  242. <li>Constr&nbsp;|&nbsp;</li>
  243. <li><a href="#method.detail">Method</a></li>
  244. </ul>
  245. </div>
  246. <a name="skip.navbar.bottom">
  247. <!-- -->
  248. </a></div>
  249. <!-- ======== END OF BOTTOM NAVBAR ======= -->
  250. </body>
  251. </html>