| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <!-- NewPage --> |
| <html lang="fr"> |
| <head> |
| <!-- Generated by javadoc (1.8.0_201) on Sat May 02 22:20:03 CEST 2020 --> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <title>AbstractRememberMeManager (Apache Shiro 1.5.3 API)</title> |
| <meta name="date" content="2020-05-02"> |
| <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style"> |
| <script type="text/javascript" src="../../../../script.js"></script> |
| </head> |
| <body> |
| <script type="text/javascript"><!-- |
| try { |
| if (location.href.indexOf('is-external=true') == -1) { |
| parent.document.title="AbstractRememberMeManager (Apache Shiro 1.5.3 API)"; |
| } |
| } |
| catch(err) { |
| } |
| //--> |
| var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":6,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":6,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":6,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10}; |
| var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]}; |
| var altColor = "altColor"; |
| var rowColor = "rowColor"; |
| var tableTab = "tableTab"; |
| var activeTableTab = "activeTableTab"; |
| </script> |
| <noscript> |
| <div>JavaScript is disabled on your browser.</div> |
| </noscript> |
| |
| <!-- ========= START OF TOP NAVBAR ======= --> |
| <div class="topNav"><a name="navbar.top"> |
| <!-- --> |
| </a> |
| <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div> |
| <a name="navbar.top.firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../../overview-summary.html">Overview</a></li> |
| <li><a href="package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="class-use/AbstractRememberMeManager.html">Use</a></li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../../index-all.html">Index</a></li> |
| <li><a href="../../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li>Prev Class</li> |
| <li><a href="../../../../org/apache/shiro/mgt/AuthenticatingSecurityManager.html" title="class in org.apache.shiro.mgt"><span class="typeNameLink">Next Class</span></a></li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../../index.html?org/apache/shiro/mgt/AbstractRememberMeManager.html" target="_top">Frames</a></li> |
| <li><a href="AbstractRememberMeManager.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_top"> |
| <li><a href="../../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_top"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Nested | </li> |
| <li>Field | </li> |
| <li><a href="#constructor.summary">Constr</a> | </li> |
| <li><a href="#method.summary">Method</a></li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li><a href="#constructor.detail">Constr</a> | </li> |
| <li><a href="#method.detail">Method</a></li> |
| </ul> |
| </div> |
| <a name="skip.navbar.top"> |
| <!-- --> |
| </a></div> |
| <!-- ========= END OF TOP NAVBAR ========= --> |
| <!-- ======== START OF CLASS DATA ======== --> |
| <div class="header"> |
| <div class="subTitle">org.apache.shiro.mgt</div> |
| <h2 title="Class AbstractRememberMeManager" class="title">Class AbstractRememberMeManager</h2> |
| </div> |
| <div class="contentContainer"> |
| <ul class="inheritance"> |
| <li><a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li> |
| <li> |
| <ul class="inheritance"> |
| <li>org.apache.shiro.mgt.AbstractRememberMeManager</li> |
| </ul> |
| </li> |
| </ul> |
| <div class="description"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <dl> |
| <dt>All Implemented Interfaces:</dt> |
| <dd><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html" title="interface in org.apache.shiro.mgt">RememberMeManager</a></dd> |
| </dl> |
| <dl> |
| <dt>Direct Known Subclasses:</dt> |
| <dd><a href="../../../../org/apache/shiro/web/mgt/CookieRememberMeManager.html" title="class in org.apache.shiro.web.mgt">CookieRememberMeManager</a></dd> |
| </dl> |
| <hr> |
| <br> |
| <pre>public abstract class <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.64">AbstractRememberMeManager</a> |
| extends <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> |
| implements <a href="../../../../org/apache/shiro/mgt/RememberMeManager.html" title="interface in org.apache.shiro.mgt">RememberMeManager</a></pre> |
| <div class="block">Abstract implementation of the <code>RememberMeManager</code> interface that handles |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setSerializer-org.apache.shiro.io.Serializer-"><code>serialization</code></a> and |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService-org.apache.shiro.crypto.CipherService-"><code>encryption</code></a> of the remembered user identity. |
| <p/> |
| The remembered identity storage location and details are left to subclasses. |
| <h2>Default encryption key</h2> |
| This implementation uses an <a href="../../../../org/apache/shiro/crypto/AesCipherService.html" title="class in org.apache.shiro.crypto"><code>AesCipherService</code></a> for strong encryption by default. It also |
| uses a default generated symmetric key to both encrypt and decrypt data. As AES is a symmetric cipher, the same |
| <code>key</code> is used to both encrypt and decrypt data, BUT NOTE: |
| <p/> |
| Because Shiro is an open-source project, if anyone knew that you were using Shiro's default |
| <code>key</code>, they could download/view the source, and with enough effort, reconstruct the <code>key</code> |
| and decode encrypted data at will. |
| <p/> |
| Of course, this key is only really used to encrypt the remembered <code>PrincipalCollection</code> which is typically |
| a user id or username. So if you do not consider that sensitive information, and you think the default key still |
| makes things 'sufficiently difficult', then you can ignore this issue. |
| <p/> |
| However, if you do feel this constitutes sensitive information, it is recommended that you provide your own |
| <code>key</code> via the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherKey-byte:A-"><code>setCipherKey</code></a> method to a key known only to your application, |
| guaranteeing that no third party can decrypt your data. You can generate your own key by calling the |
| <code>CipherService</code>'s <a href="../../../../org/apache/shiro/crypto/AbstractSymmetricCipherService.html#generateNewKey--"><code>generateNewKey</code></a> method |
| and using that result as the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherKey-byte:A-"><code>cipherKey</code></a> configuration attribute.</div> |
| <dl> |
| <dt><span class="simpleTagLabel">Since:</span></dt> |
| <dd>0.9</dd> |
| </dl> |
| </li> |
| </ul> |
| </div> |
| <div class="summary"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <!-- ======== CONSTRUCTOR SUMMARY ======== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="constructor.summary"> |
| <!-- --> |
| </a> |
| <h3>Constructor Summary</h3> |
| <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> |
| <caption><span>Constructors</span><span class="tabEnd"> </span></caption> |
| <tr> |
| <th class="colOne" scope="col">Constructor and Description</th> |
| </tr> |
| <tr class="altColor"> |
| <td class="colOne"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#AbstractRememberMeManager--">AbstractRememberMeManager</a></span>()</code> |
| <div class="block">Default constructor that initializes a <a href="../../../../org/apache/shiro/io/DefaultSerializer.html" title="class in org.apache.shiro.io"><code>DefaultSerializer</code></a> as the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer--"><code>serializer</code></a> and |
| an <a href="../../../../org/apache/shiro/crypto/AesCipherService.html" title="class in org.apache.shiro.crypto"><code>AesCipherService</code></a> as the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a>.</div> |
| </td> |
| </tr> |
| </table> |
| </li> |
| </ul> |
| <!-- ========== METHOD SUMMARY =========== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="method.summary"> |
| <!-- --> |
| </a> |
| <h3>Method Summary</h3> |
| <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> |
| <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span></caption> |
| <tr> |
| <th class="colFirst" scope="col">Modifier and Type</th> |
| <th class="colLast" scope="col">Method and Description</th> |
| </tr> |
| <tr id="i0" class="altColor"> |
| <td class="colFirst"><code>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#convertBytesToPrincipals-byte:A-org.apache.shiro.subject.SubjectContext-">convertBytesToPrincipals</a></span>(byte[] bytes, |
| <a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> subjectContext)</code> |
| <div class="block">If a <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a> is available, it will be used to first decrypt the byte array.</div> |
| </td> |
| </tr> |
| <tr id="i1" class="rowColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#convertPrincipalsToBytes-org.apache.shiro.subject.PrincipalCollection-">convertPrincipalsToBytes</a></span>(<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> principals)</code> |
| <div class="block">Converts the given principal collection the byte array that will be persisted to be 'remembered' later.</div> |
| </td> |
| </tr> |
| <tr id="i2" class="altColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#decrypt-byte:A-">decrypt</a></span>(byte[] encrypted)</code> |
| <div class="block">Decrypts the byte array using the configured <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a>.</div> |
| </td> |
| </tr> |
| <tr id="i3" class="rowColor"> |
| <td class="colFirst"><code>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#deserialize-byte:A-">deserialize</a></span>(byte[] serializedIdentity)</code> |
| <div class="block">De-serializes the given byte array by using the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer--"><code>serializer</code></a>'s |
| <a href="../../../../org/apache/shiro/io/Serializer.html#deserialize-byte:A-"><code>deserialize</code></a> method.</div> |
| </td> |
| </tr> |
| <tr id="i4" class="altColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#encrypt-byte:A-">encrypt</a></span>(byte[] serialized)</code> |
| <div class="block">Encrypts the byte array by using the configured <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a>.</div> |
| </td> |
| </tr> |
| <tr id="i5" class="rowColor"> |
| <td class="colFirst"><code>protected abstract void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity-org.apache.shiro.subject.Subject-">forgetIdentity</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject)</code> |
| <div class="block">Forgets (removes) any remembered identity data for the specified <a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject"><code>Subject</code></a> instance.</div> |
| </td> |
| </tr> |
| <tr id="i6" class="altColor"> |
| <td class="colFirst"><code>byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherKey--">getCipherKey</a></span>()</code> |
| <div class="block">Convenience method that returns the cipher key to use for <em>both</em> encryption and decryption.</div> |
| </td> |
| </tr> |
| <tr id="i7" class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../org/apache/shiro/crypto/CipherService.html" title="interface in org.apache.shiro.crypto">CipherService</a></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--">getCipherService</a></span>()</code> |
| <div class="block">Returns the <code>CipherService</code> to use for encrypting and decrypting serialized identity data to prevent easy |
| inspection of Subject identity data.</div> |
| </td> |
| </tr> |
| <tr id="i8" class="altColor"> |
| <td class="colFirst"><code>byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getDecryptionCipherKey--">getDecryptionCipherKey</a></span>()</code> |
| <div class="block">Returns the decryption cipher key to use for decryption operations.</div> |
| </td> |
| </tr> |
| <tr id="i9" class="rowColor"> |
| <td class="colFirst"><code>byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getEncryptionCipherKey--">getEncryptionCipherKey</a></span>()</code> |
| <div class="block">Returns the cipher key to use for encryption operations.</div> |
| </td> |
| </tr> |
| <tr id="i10" class="altColor"> |
| <td class="colFirst"><code>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getIdentityToRemember-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationInfo-">getIdentityToRemember</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationInfo.html" title="interface in org.apache.shiro.authc">AuthenticationInfo</a> info)</code> |
| <div class="block">Returns <code>info</code>.</div> |
| </td> |
| </tr> |
| <tr id="i11" class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedPrincipals-org.apache.shiro.subject.SubjectContext-">getRememberedPrincipals</a></span>(<a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> subjectContext)</code> |
| <div class="block">Implements the interface method by first <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedSerializedIdentity-org.apache.shiro.subject.SubjectContext-"><code>acquiring</code></a> |
| the remembered serialized byte array.</div> |
| </td> |
| </tr> |
| <tr id="i12" class="altColor"> |
| <td class="colFirst"><code>protected abstract byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedSerializedIdentity-org.apache.shiro.subject.SubjectContext-">getRememberedSerializedIdentity</a></span>(<a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> subjectContext)</code> |
| <div class="block">Based on the given subject context data, retrieves the previously persisted serialized identity, or |
| <code>null</code> if there is no available data.</div> |
| </td> |
| </tr> |
| <tr id="i13" class="rowColor"> |
| <td class="colFirst"><code><a href="../../../../org/apache/shiro/io/Serializer.html" title="interface in org.apache.shiro.io">Serializer</a><<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a>></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer--">getSerializer</a></span>()</code> |
| <div class="block">Returns the <code>Serializer</code> used to serialize and deserialize <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>PrincipalCollection</code></a> instances for |
| persistent remember me storage.</div> |
| </td> |
| </tr> |
| <tr id="i14" class="altColor"> |
| <td class="colFirst"><code>protected boolean</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#isRememberMe-org.apache.shiro.authc.AuthenticationToken-">isRememberMe</a></span>(<a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token)</code> |
| <div class="block">Determines whether or not remember me services should be performed for the specified token.</div> |
| </td> |
| </tr> |
| <tr id="i15" class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#onFailedLogin-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationException-">onFailedLogin</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationException.html" title="class in org.apache.shiro.authc">AuthenticationException</a> ae)</code> |
| <div class="block">Reacts to a failed login by immediately <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity-org.apache.shiro.subject.Subject-"><code>forgetting</code></a> any |
| previously remembered identity.</div> |
| </td> |
| </tr> |
| <tr id="i16" class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#onLogout-org.apache.shiro.subject.Subject-">onLogout</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject)</code> |
| <div class="block">Reacts to a subject logging out of the application and immediately |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity-org.apache.shiro.subject.Subject-"><code>forgets</code></a> any previously stored identity and returns.</div> |
| </td> |
| </tr> |
| <tr id="i17" class="rowColor"> |
| <td class="colFirst"><code>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#onRememberedPrincipalFailure-java.lang.RuntimeException-org.apache.shiro.subject.SubjectContext-">onRememberedPrincipalFailure</a></span>(<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/RuntimeException.html?is-external=true" title="class or interface in java.lang">RuntimeException</a> e, |
| <a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> context)</code> |
| <div class="block">Called when an exception is thrown while trying to retrieve principals.</div> |
| </td> |
| </tr> |
| <tr id="i18" class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#onSuccessfulLogin-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationInfo-">onSuccessfulLogin</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationInfo.html" title="interface in org.apache.shiro.authc">AuthenticationInfo</a> info)</code> |
| <div class="block">Reacts to the successful login attempt by first always <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity-org.apache.shiro.subject.Subject-"><code>forgetting</code></a> any previously |
| stored identity.</div> |
| </td> |
| </tr> |
| <tr id="i19" class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberIdentity-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationInfo-">rememberIdentity</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationInfo.html" title="interface in org.apache.shiro.authc">AuthenticationInfo</a> authcInfo)</code> |
| <div class="block">Remembers a subject-unique identity for retrieval later.</div> |
| </td> |
| </tr> |
| <tr id="i20" class="altColor"> |
| <td class="colFirst"><code>protected void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberIdentity-org.apache.shiro.subject.Subject-org.apache.shiro.subject.PrincipalCollection-">rememberIdentity</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> accountPrincipals)</code> |
| <div class="block">Remembers the specified account principals by first |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#convertPrincipalsToBytes-org.apache.shiro.subject.PrincipalCollection-"><code>converting</code></a> them to a byte |
| array and then <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberSerializedIdentity-org.apache.shiro.subject.Subject-byte:A-"><code>remembers</code></a> that |
| byte array.</div> |
| </td> |
| </tr> |
| <tr id="i21" class="rowColor"> |
| <td class="colFirst"><code>protected abstract void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberSerializedIdentity-org.apache.shiro.subject.Subject-byte:A-">rememberSerializedIdentity</a></span>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| byte[] serialized)</code> |
| <div class="block">Persists the identity bytes to a persistent store for retrieval later via the |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedSerializedIdentity-org.apache.shiro.subject.SubjectContext-"><code>getRememberedSerializedIdentity(SubjectContext)</code></a> method.</div> |
| </td> |
| </tr> |
| <tr id="i22" class="altColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#serialize-org.apache.shiro.subject.PrincipalCollection-">serialize</a></span>(<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> principals)</code> |
| <div class="block">Serializes the given <code>principals</code> by serializing them to a byte array by using the |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer--"><code>serializer</code></a>'s <a href="../../../../org/apache/shiro/io/Serializer.html#serialize-T-"><code>serialize</code></a> method.</div> |
| </td> |
| </tr> |
| <tr id="i23" class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherKey-byte:A-">setCipherKey</a></span>(byte[] cipherKey)</code> |
| <div class="block">Convenience method that sets the cipher key to use for <em>both</em> encryption and decryption.</div> |
| </td> |
| </tr> |
| <tr id="i24" class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService-org.apache.shiro.crypto.CipherService-">setCipherService</a></span>(<a href="../../../../org/apache/shiro/crypto/CipherService.html" title="interface in org.apache.shiro.crypto">CipherService</a> cipherService)</code> |
| <div class="block">Sets the <code>CipherService</code> to use for encrypting and decrypting serialized identity data to prevent easy |
| inspection of Subject identity data.</div> |
| </td> |
| </tr> |
| <tr id="i25" class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setDecryptionCipherKey-byte:A-">setDecryptionCipherKey</a></span>(byte[] decryptionCipherKey)</code> |
| <div class="block">Sets the decryption key to use for decryption operations.</div> |
| </td> |
| </tr> |
| <tr id="i26" class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setEncryptionCipherKey-byte:A-">setEncryptionCipherKey</a></span>(byte[] encryptionCipherKey)</code> |
| <div class="block">Sets the encryption key to use for encryption operations.</div> |
| </td> |
| </tr> |
| <tr id="i27" class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setSerializer-org.apache.shiro.io.Serializer-">setSerializer</a></span>(<a href="../../../../org/apache/shiro/io/Serializer.html" title="interface in org.apache.shiro.io">Serializer</a><<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a>> serializer)</code> |
| <div class="block">Sets the <code>Serializer</code> used to serialize and deserialize <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>PrincipalCollection</code></a> instances for |
| persistent remember me storage.</div> |
| </td> |
| </tr> |
| </table> |
| <ul class="blockList"> |
| <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object"> |
| <!-- --> |
| </a> |
| <h3>Methods inherited from class java.lang.<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3> |
| <code><a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li> |
| </ul> |
| <ul class="blockList"> |
| <li class="blockList"><a name="methods.inherited.from.class.org.apache.shiro.mgt.RememberMeManager"> |
| <!-- --> |
| </a> |
| <h3>Methods inherited from interface org.apache.shiro.mgt.<a href="../../../../org/apache/shiro/mgt/RememberMeManager.html" title="interface in org.apache.shiro.mgt">RememberMeManager</a></h3> |
| <code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html#forgetIdentity-org.apache.shiro.subject.SubjectContext-">forgetIdentity</a></code></li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </div> |
| <div class="details"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <!-- ========= CONSTRUCTOR DETAIL ======== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="constructor.detail"> |
| <!-- --> |
| </a> |
| <h3>Constructor Detail</h3> |
| <a name="AbstractRememberMeManager--"> |
| <!-- --> |
| </a> |
| <ul class="blockListLast"> |
| <li class="blockList"> |
| <h4>AbstractRememberMeManager</h4> |
| <pre>public <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.95">AbstractRememberMeManager</a>()</pre> |
| <div class="block">Default constructor that initializes a <a href="../../../../org/apache/shiro/io/DefaultSerializer.html" title="class in org.apache.shiro.io"><code>DefaultSerializer</code></a> as the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer--"><code>serializer</code></a> and |
| an <a href="../../../../org/apache/shiro/crypto/AesCipherService.html" title="class in org.apache.shiro.crypto"><code>AesCipherService</code></a> as the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a>.</div> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| <!-- ============ METHOD DETAIL ========== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="method.detail"> |
| <!-- --> |
| </a> |
| <h3>Method Detail</h3> |
| <a name="getSerializer--"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getSerializer</h4> |
| <pre>public <a href="../../../../org/apache/shiro/io/Serializer.html" title="interface in org.apache.shiro.io">Serializer</a><<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a>> <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.112">getSerializer</a>()</pre> |
| <div class="block">Returns the <code>Serializer</code> used to serialize and deserialize <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>PrincipalCollection</code></a> instances for |
| persistent remember me storage. |
| <p/> |
| Unless overridden by the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setSerializer-org.apache.shiro.io.Serializer-"><code>setSerializer(org.apache.shiro.io.Serializer<org.apache.shiro.subject.PrincipalCollection>)</code></a> method, the default instance is a |
| <a href="../../../../org/apache/shiro/io/DefaultSerializer.html" title="class in org.apache.shiro.io"><code>DefaultSerializer</code></a>.</div> |
| <dl> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the <code>Serializer</code> used to serialize and deserialize <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>PrincipalCollection</code></a> instances for |
| persistent remember me storage.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="setSerializer-org.apache.shiro.io.Serializer-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setSerializer</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.125">setSerializer</a>(<a href="../../../../org/apache/shiro/io/Serializer.html" title="interface in org.apache.shiro.io">Serializer</a><<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a>> serializer)</pre> |
| <div class="block">Sets the <code>Serializer</code> used to serialize and deserialize <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>PrincipalCollection</code></a> instances for |
| persistent remember me storage. |
| <p/> |
| Unless overridden by this method, the default instance is a <a href="../../../../org/apache/shiro/io/DefaultSerializer.html" title="class in org.apache.shiro.io"><code>DefaultSerializer</code></a>.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>serializer</code> - the <code>Serializer</code> used to serialize and deserialize <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>PrincipalCollection</code></a> instances |
| for persistent remember me storage.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="getCipherService--"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getCipherService</h4> |
| <pre>public <a href="../../../../org/apache/shiro/crypto/CipherService.html" title="interface in org.apache.shiro.crypto">CipherService</a> <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.138">getCipherService</a>()</pre> |
| <div class="block">Returns the <code>CipherService</code> to use for encrypting and decrypting serialized identity data to prevent easy |
| inspection of Subject identity data. |
| <p/> |
| Unless overridden by the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService-org.apache.shiro.crypto.CipherService-"><code>setCipherService(org.apache.shiro.crypto.CipherService)</code></a> method, the default instance is an <a href="../../../../org/apache/shiro/crypto/AesCipherService.html" title="class in org.apache.shiro.crypto"><code>AesCipherService</code></a>.</div> |
| <dl> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the <code>Cipher</code> to use for encrypting and decrypting serialized identity data to prevent easy |
| inspection of Subject identity data</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="setCipherService-org.apache.shiro.crypto.CipherService-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setCipherService</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.161">setCipherService</a>(<a href="../../../../org/apache/shiro/crypto/CipherService.html" title="interface in org.apache.shiro.crypto">CipherService</a> cipherService)</pre> |
| <div class="block">Sets the <code>CipherService</code> to use for encrypting and decrypting serialized identity data to prevent easy |
| inspection of Subject identity data. |
| <p/> |
| If the CipherService is a symmetric CipherService (using the same key for both encryption and decryption), you |
| should set your key via the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherKey-byte:A-"><code>setCipherKey(byte[])</code></a> method. |
| <p/> |
| If the CipherService is an asymmetric CipherService (different keys for encryption and decryption, such as |
| public/private key pairs), you should set your encryption and decryption key via the respective |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setEncryptionCipherKey-byte:A-"><code>setEncryptionCipherKey(byte[])</code></a> and <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setDecryptionCipherKey-byte:A-"><code>setDecryptionCipherKey(byte[])</code></a> methods. |
| <p/> |
| <b>N.B.</b> Unless overridden by this method, the default CipherService instance is an |
| <a href="../../../../org/apache/shiro/crypto/AesCipherService.html" title="class in org.apache.shiro.crypto"><code>AesCipherService</code></a>. This <code>RememberMeManager</code> implementation already has a configured symmetric key |
| to use for encryption and decryption, but it is recommended to provide your own for added security. See the |
| class-level JavaDoc for more information and why it might be good to provide your own.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>cipherService</code> - the <code>CipherService</code> to use for encrypting and decrypting serialized identity data to |
| prevent easy inspection of Subject identity data.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="getEncryptionCipherKey--"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getEncryptionCipherKey</h4> |
| <pre>public byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.171">getEncryptionCipherKey</a>()</pre> |
| <div class="block">Returns the cipher key to use for encryption operations.</div> |
| <dl> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the cipher key to use for encryption operations.</dd> |
| <dt><span class="seeLabel">See Also:</span></dt> |
| <dd><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService-org.apache.shiro.crypto.CipherService-"><code>for a description of the various {@code get/set*Key} methods.</code></a></dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="setEncryptionCipherKey-byte:A-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setEncryptionCipherKey</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.181">setEncryptionCipherKey</a>(byte[] encryptionCipherKey)</pre> |
| <div class="block">Sets the encryption key to use for encryption operations.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>encryptionCipherKey</code> - the encryption key to use for encryption operations.</dd> |
| <dt><span class="seeLabel">See Also:</span></dt> |
| <dd><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService-org.apache.shiro.crypto.CipherService-"><code>for a description of the various {@code get/set*Key} methods.</code></a></dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="getDecryptionCipherKey--"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getDecryptionCipherKey</h4> |
| <pre>public byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.191">getDecryptionCipherKey</a>()</pre> |
| <div class="block">Returns the decryption cipher key to use for decryption operations.</div> |
| <dl> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the cipher key to use for decryption operations.</dd> |
| <dt><span class="seeLabel">See Also:</span></dt> |
| <dd><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService-org.apache.shiro.crypto.CipherService-"><code>for a description of the various {@code get/set*Key} methods.</code></a></dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="setDecryptionCipherKey-byte:A-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setDecryptionCipherKey</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.201">setDecryptionCipherKey</a>(byte[] decryptionCipherKey)</pre> |
| <div class="block">Sets the decryption key to use for decryption operations.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>decryptionCipherKey</code> - the decryption key to use for decryption operations.</dd> |
| <dt><span class="seeLabel">See Also:</span></dt> |
| <dd><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService-org.apache.shiro.crypto.CipherService-"><code>for a description of the various {@code get/set*Key} methods.</code></a></dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="getCipherKey--"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getCipherKey</h4> |
| <pre>public byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.218">getCipherKey</a>()</pre> |
| <div class="block">Convenience method that returns the cipher key to use for <em>both</em> encryption and decryption. |
| <p/> |
| <b>N.B.</b> This method can only be called if the underlying <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a> is a symmetric |
| CipherService which by definition uses the same key for both encryption and decryption. If using an asymmetric |
| CipherService public/private key pair, you cannot use this method, and should instead use the |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getEncryptionCipherKey--"><code>getEncryptionCipherKey()</code></a> and <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getDecryptionCipherKey--"><code>getDecryptionCipherKey()</code></a> methods individually. |
| <p/> |
| The default <a href="../../../../org/apache/shiro/crypto/AesCipherService.html" title="class in org.apache.shiro.crypto"><code>AesCipherService</code></a> instance is a symmetric cipher service, so this method can be used if you are |
| using the default.</div> |
| <dl> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the symmetric cipher key used for both encryption and decryption.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="setCipherKey-byte:A-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>setCipherKey</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.237">setCipherKey</a>(byte[] cipherKey)</pre> |
| <div class="block">Convenience method that sets the cipher key to use for <em>both</em> encryption and decryption. |
| <p/> |
| <b>N.B.</b> This method can only be called if the underlying <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a> is a |
| symmetric CipherService?which by definition uses the same key for both encryption and decryption. If using an |
| asymmetric CipherService?(such as a public/private key pair), you cannot use this method, and should instead use |
| the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setEncryptionCipherKey-byte:A-"><code>setEncryptionCipherKey(byte[])</code></a> and <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setDecryptionCipherKey-byte:A-"><code>setDecryptionCipherKey(byte[])</code></a> methods individually. |
| <p/> |
| The default <a href="../../../../org/apache/shiro/crypto/AesCipherService.html" title="class in org.apache.shiro.crypto"><code>AesCipherService</code></a> instance is a symmetric CipherService, so this method can be used if you |
| are using the default.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>cipherKey</code> - the symmetric cipher key to use for both encryption and decryption.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="forgetIdentity-org.apache.shiro.subject.Subject-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>forgetIdentity</h4> |
| <pre>protected abstract void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.250">forgetIdentity</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject)</pre> |
| <div class="block">Forgets (removes) any remembered identity data for the specified <a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject"><code>Subject</code></a> instance.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the subject instance for which identity data should be forgotten from the underlying persistence |
| mechanism.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="isRememberMe-org.apache.shiro.authc.AuthenticationToken-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>isRememberMe</h4> |
| <pre>protected boolean <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.265">isRememberMe</a>(<a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token)</pre> |
| <div class="block">Determines whether or not remember me services should be performed for the specified token. This method returns |
| <code>true</code> iff: |
| <ol> |
| <li>The token is not <code>null</code> and</li> |
| <li>The token is an <code>instanceof</code> <a href="../../../../org/apache/shiro/authc/RememberMeAuthenticationToken.html" title="interface in org.apache.shiro.authc"><code>RememberMeAuthenticationToken</code></a> and</li> |
| <li><code>token</code>.<a href="../../../../org/apache/shiro/authc/RememberMeAuthenticationToken.html#isRememberMe--"><code>isRememberMe()</code></a> is |
| <code>true</code></li> |
| </ol></div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>token</code> - the authentication token submitted during the successful authentication attempt.</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>true if remember me services should be performed as a result of the successful authentication attempt.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="onSuccessfulLogin-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationInfo-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>onSuccessfulLogin</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.281">onSuccessfulLogin</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationInfo.html" title="interface in org.apache.shiro.authc">AuthenticationInfo</a> info)</pre> |
| <div class="block">Reacts to the successful login attempt by first always <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity-org.apache.shiro.subject.Subject-"><code>forgetting</code></a> any previously |
| stored identity. Then if the <code>token</code> |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#isRememberMe-org.apache.shiro.authc.AuthenticationToken-"><code>is a RememberMe</code></a> token, the associated identity |
| will be <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberIdentity-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationInfo-"><code>remembered</code></a> |
| for later retrieval during a new user session.</div> |
| <dl> |
| <dt><span class="overrideSpecifyLabel">Specified by:</span></dt> |
| <dd><code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html#onSuccessfulLogin-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationInfo-">onSuccessfulLogin</a></code> in interface <code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html" title="interface in org.apache.shiro.mgt">RememberMeManager</a></code></dd> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the subject for which the principals are being remembered.</dd> |
| <dd><code>token</code> - the token that resulted in a successful authentication attempt.</dd> |
| <dd><code>info</code> - the authentication info resulting from the successful authentication attempt.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="rememberIdentity-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationInfo-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>rememberIdentity</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.309">rememberIdentity</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationInfo.html" title="interface in org.apache.shiro.authc">AuthenticationInfo</a> authcInfo)</pre> |
| <div class="block">Remembers a subject-unique identity for retrieval later. This implementation first |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getIdentityToRemember-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationInfo-"><code>resolves</code></a> the exact |
| <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>principals</code></a> to remember. It then remembers the principals by calling |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberIdentity-org.apache.shiro.subject.Subject-org.apache.shiro.subject.PrincipalCollection-"><code>rememberIdentity(org.apache.shiro.subject.Subject, org.apache.shiro.subject.PrincipalCollection)</code></a>. |
| <p/> |
| This implementation ignores the <a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc"><code>AuthenticationToken</code></a> argument, but it is available to subclasses if |
| necessary for custom logic.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the subject for which the principals are being remembered.</dd> |
| <dd><code>token</code> - the token that resulted in a successful authentication attempt.</dd> |
| <dd><code>authcInfo</code> - the authentication info resulting from the successful authentication attempt.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="getIdentityToRemember-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationInfo-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getIdentityToRemember</h4> |
| <pre>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.322">getIdentityToRemember</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationInfo.html" title="interface in org.apache.shiro.authc">AuthenticationInfo</a> info)</pre> |
| <div class="block">Returns <code>info</code>.<a href="../../../../org/apache/shiro/authc/AuthenticationInfo.html#getPrincipals--"><code>getPrincipals()</code></a> and |
| ignores the <a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject"><code>Subject</code></a> argument.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the subject for which the principals are being remembered.</dd> |
| <dd><code>info</code> - the authentication info resulting from the successful authentication attempt.</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the <code>PrincipalCollection</code> to remember.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="rememberIdentity-org.apache.shiro.subject.Subject-org.apache.shiro.subject.PrincipalCollection-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>rememberIdentity</h4> |
| <pre>protected void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.335">rememberIdentity</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> accountPrincipals)</pre> |
| <div class="block">Remembers the specified account principals by first |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#convertPrincipalsToBytes-org.apache.shiro.subject.PrincipalCollection-"><code>converting</code></a> them to a byte |
| array and then <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberSerializedIdentity-org.apache.shiro.subject.Subject-byte:A-"><code>remembers</code></a> that |
| byte array.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the subject for which the principals are being remembered.</dd> |
| <dd><code>accountPrincipals</code> - the principals to remember for retrieval later.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="convertPrincipalsToBytes-org.apache.shiro.subject.PrincipalCollection-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>convertPrincipalsToBytes</h4> |
| <pre>protected byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.349">convertPrincipalsToBytes</a>(<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> principals)</pre> |
| <div class="block">Converts the given principal collection the byte array that will be persisted to be 'remembered' later. |
| <p/> |
| This implementation first <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#serialize-org.apache.shiro.subject.PrincipalCollection-"><code>serializes</code></a> the |
| principals to a byte array and then <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#encrypt-byte:A-"><code>encrypts</code></a> that byte array.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>principals</code> - the <code>PrincipalCollection</code> to convert to a byte array</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the representative byte array to be persisted for remember me functionality.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="rememberSerializedIdentity-org.apache.shiro.subject.Subject-byte:A-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>rememberSerializedIdentity</h4> |
| <pre>protected abstract void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.364">rememberSerializedIdentity</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| byte[] serialized)</pre> |
| <div class="block">Persists the identity bytes to a persistent store for retrieval later via the |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedSerializedIdentity-org.apache.shiro.subject.SubjectContext-"><code>getRememberedSerializedIdentity(SubjectContext)</code></a> method.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the Subject for which the identity is being serialized.</dd> |
| <dd><code>serialized</code> - the serialized bytes to be persisted.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="getRememberedPrincipals-org.apache.shiro.subject.SubjectContext-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getRememberedPrincipals</h4> |
| <pre>public <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.380">getRememberedPrincipals</a>(<a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> subjectContext)</pre> |
| <div class="block">Implements the interface method by first <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedSerializedIdentity-org.apache.shiro.subject.SubjectContext-"><code>acquiring</code></a> |
| the remembered serialized byte array. Then it <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#convertBytesToPrincipals-byte:A-org.apache.shiro.subject.SubjectContext-"><code>converts</code></a> |
| them and returns the re-constituted <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject"><code>PrincipalCollection</code></a>. If no remembered principals could be |
| obtained, <code>null</code> is returned. |
| <p/> |
| If any exceptions are thrown, the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#onRememberedPrincipalFailure-java.lang.RuntimeException-org.apache.shiro.subject.SubjectContext-"><code>onRememberedPrincipalFailure(RuntimeException, SubjectContext)</code></a> method |
| is called to allow any necessary post-processing (such as immediately removing any previously remembered |
| values for safety).</div> |
| <dl> |
| <dt><span class="overrideSpecifyLabel">Specified by:</span></dt> |
| <dd><code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html#getRememberedPrincipals-org.apache.shiro.subject.SubjectContext-">getRememberedPrincipals</a></code> in interface <code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html" title="interface in org.apache.shiro.mgt">RememberMeManager</a></code></dd> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subjectContext</code> - the contextual data, usually provided by a <code>Subject.Builder</code> implementation, that |
| is being used to construct a <a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject"><code>Subject</code></a> instance.</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the remembered principals or <code>null</code> if none could be acquired.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="getRememberedSerializedIdentity-org.apache.shiro.subject.SubjectContext-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>getRememberedSerializedIdentity</h4> |
| <pre>protected abstract byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.406">getRememberedSerializedIdentity</a>(<a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> subjectContext)</pre> |
| <div class="block">Based on the given subject context data, retrieves the previously persisted serialized identity, or |
| <code>null</code> if there is no available data. The context map is usually populated by a <code>Subject.Builder</code> |
| implementation. See the <a href="../../../../org/apache/shiro/mgt/SubjectFactory.html" title="interface in org.apache.shiro.mgt"><code>SubjectFactory</code></a> class constants for Shiro's known map keys.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subjectContext</code> - the contextual data, usually provided by a <code>Subject.Builder</code> implementation, that |
| is being used to construct a <a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject"><code>Subject</code></a> instance. To be used to assist with data |
| lookup.</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the previously persisted serialized identity, or <code>null</code> if there is no available data for the |
| Subject.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="convertBytesToPrincipals-byte:A-org.apache.shiro.subject.SubjectContext-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>convertBytesToPrincipals</h4> |
| <pre>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.417">convertBytesToPrincipals</a>(byte[] bytes, |
| <a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> subjectContext)</pre> |
| <div class="block">If a <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a> is available, it will be used to first decrypt the byte array. |
| Then the bytes are then <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#deserialize-byte:A-"><code>deserialized</code></a> and then returned.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>bytes</code> - the bytes to decrypt if necessary and then deserialize.</dd> |
| <dd><code>subjectContext</code> - the contextual data, usually provided by a <code>Subject.Builder</code> implementation, that |
| is being used to construct a <a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject"><code>Subject</code></a> instance.</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the de-serialized and possibly decrypted principals</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="onRememberedPrincipalFailure-java.lang.RuntimeException-org.apache.shiro.subject.SubjectContext-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>onRememberedPrincipalFailure</h4> |
| <pre>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.441">onRememberedPrincipalFailure</a>(<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/RuntimeException.html?is-external=true" title="class or interface in java.lang">RuntimeException</a> e, |
| <a href="../../../../org/apache/shiro/subject/SubjectContext.html" title="interface in org.apache.shiro.subject">SubjectContext</a> context)</pre> |
| <div class="block">Called when an exception is thrown while trying to retrieve principals. The default implementation logs a |
| warning message and forgets ('unremembers') the problem identity by calling |
| <a href="../../../../org/apache/shiro/mgt/RememberMeManager.html#forgetIdentity-org.apache.shiro.subject.SubjectContext-"><code>forgetIdentity(context)</code></a> and then immediately re-throws the |
| exception to allow the calling component to react accordingly. |
| <p/> |
| This method implementation never returns an |
| object - it always rethrows, but can be overridden by subclasses for custom handling behavior. |
| <p/> |
| This most commonly would be called when an encryption key is updated and old principals are retrieved that have |
| been encrypted with the previous key.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>e</code> - the exception that was thrown.</dd> |
| <dd><code>context</code> - the contextual data, usually provided by a <code>Subject.Builder</code> implementation, that |
| is being used to construct a <a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject"><code>Subject</code></a> instance.</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>nothing - the original <code>RuntimeException</code> is propagated in all cases.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="encrypt-byte:A-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>encrypt</h4> |
| <pre>protected byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.462">encrypt</a>(byte[] serialized)</pre> |
| <div class="block">Encrypts the byte array by using the configured <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a>.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>serialized</code> - the serialized object byte array to be encrypted</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>an encrypted byte array returned by the configured <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>() cipher</code></a>.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="decrypt-byte:A-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>decrypt</h4> |
| <pre>protected byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.478">decrypt</a>(byte[] encrypted)</pre> |
| <div class="block">Decrypts the byte array using the configured <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>cipherService</code></a>.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>encrypted</code> - the encrypted byte array to decrypt</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the decrypted byte array returned by the configured <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService--"><code>() cipher</code></a>.</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="serialize-org.apache.shiro.subject.PrincipalCollection-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>serialize</h4> |
| <pre>protected byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.495">serialize</a>(<a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> principals)</pre> |
| <div class="block">Serializes the given <code>principals</code> by serializing them to a byte array by using the |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer--"><code>serializer</code></a>'s <a href="../../../../org/apache/shiro/io/Serializer.html#serialize-T-"><code>serialize</code></a> method.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>principals</code> - the principal collection to serialize to a byte array</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the serialized principal collection in the form of a byte array</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="deserialize-byte:A-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>deserialize</h4> |
| <pre>protected <a href="../../../../org/apache/shiro/subject/PrincipalCollection.html" title="interface in org.apache.shiro.subject">PrincipalCollection</a> <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.506">deserialize</a>(byte[] serializedIdentity)</pre> |
| <div class="block">De-serializes the given byte array by using the <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer--"><code>serializer</code></a>'s |
| <a href="../../../../org/apache/shiro/io/Serializer.html#deserialize-byte:A-"><code>deserialize</code></a> method.</div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>serializedIdentity</code> - the previously serialized <code>PrincipalCollection</code> as a byte array</dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>the de-serialized (reconstituted) <code>PrincipalCollection</code></dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="onFailedLogin-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationException-"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>onFailedLogin</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.519">onFailedLogin</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationToken.html" title="interface in org.apache.shiro.authc">AuthenticationToken</a> token, |
| <a href="../../../../org/apache/shiro/authc/AuthenticationException.html" title="class in org.apache.shiro.authc">AuthenticationException</a> ae)</pre> |
| <div class="block">Reacts to a failed login by immediately <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity-org.apache.shiro.subject.Subject-"><code>forgetting</code></a> any |
| previously remembered identity. This is an additional security feature to prevent any remenant identity data |
| from being retained in case the authentication attempt is not being executed by the expected user.</div> |
| <dl> |
| <dt><span class="overrideSpecifyLabel">Specified by:</span></dt> |
| <dd><code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html#onFailedLogin-org.apache.shiro.subject.Subject-org.apache.shiro.authc.AuthenticationToken-org.apache.shiro.authc.AuthenticationException-">onFailedLogin</a></code> in interface <code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html" title="interface in org.apache.shiro.mgt">RememberMeManager</a></code></dd> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the subject which executed the failed login attempt</dd> |
| <dd><code>token</code> - the authentication token resulting in a failed login attempt - ignored by this implementation</dd> |
| <dd><code>ae</code> - the exception thrown as a result of the failed login attempt - ignored by this implementation</dd> |
| </dl> |
| </li> |
| </ul> |
| <a name="onLogout-org.apache.shiro.subject.Subject-"> |
| <!-- --> |
| </a> |
| <ul class="blockListLast"> |
| <li class="blockList"> |
| <h4>onLogout</h4> |
| <pre>public void <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.529">onLogout</a>(<a href="../../../../org/apache/shiro/subject/Subject.html" title="interface in org.apache.shiro.subject">Subject</a> subject)</pre> |
| <div class="block">Reacts to a subject logging out of the application and immediately |
| <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity-org.apache.shiro.subject.Subject-"><code>forgets</code></a> any previously stored identity and returns.</div> |
| <dl> |
| <dt><span class="overrideSpecifyLabel">Specified by:</span></dt> |
| <dd><code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html#onLogout-org.apache.shiro.subject.Subject-">onLogout</a></code> in interface <code><a href="../../../../org/apache/shiro/mgt/RememberMeManager.html" title="interface in org.apache.shiro.mgt">RememberMeManager</a></code></dd> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>subject</code> - the subject logging out.</dd> |
| </dl> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </div> |
| </div> |
| <!-- ========= END OF CLASS DATA ========= --> |
| <!-- ======= START OF BOTTOM NAVBAR ====== --> |
| <div class="bottomNav"><a name="navbar.bottom"> |
| <!-- --> |
| </a> |
| <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> |
| <a name="navbar.bottom.firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../../overview-summary.html">Overview</a></li> |
| <li><a href="package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="class-use/AbstractRememberMeManager.html">Use</a></li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../../index-all.html">Index</a></li> |
| <li><a href="../../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li>Prev Class</li> |
| <li><a href="../../../../org/apache/shiro/mgt/AuthenticatingSecurityManager.html" title="class in org.apache.shiro.mgt"><span class="typeNameLink">Next Class</span></a></li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../../index.html?org/apache/shiro/mgt/AbstractRememberMeManager.html" target="_top">Frames</a></li> |
| <li><a href="AbstractRememberMeManager.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_bottom"> |
| <li><a href="../../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_bottom"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Nested | </li> |
| <li>Field | </li> |
| <li><a href="#constructor.summary">Constr</a> | </li> |
| <li><a href="#method.summary">Method</a></li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li><a href="#constructor.detail">Constr</a> | </li> |
| <li><a href="#method.detail">Method</a></li> |
| </ul> |
| </div> |
| <a name="skip.navbar.bottom"> |
| <!-- --> |
| </a></div> |
| <!-- ======== END OF BOTTOM NAVBAR ======= --> |
| <p class="legalCopy"><small>Copyright © 2004–2020 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> |
| </body> |
| </html> |