| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <!-- NewPage --> |
| <html lang="en"> |
| <head> |
| <!-- Generated by javadoc (version 1.7.0_25) on Wed May 25 23:25:55 EDT 2016 --> |
| <meta http-equiv="Content-Type" content="text/html" charset="UTF-8"> |
| <title>AbstractRememberMeManager (Apache Shiro 1.2.5 API)</title> |
| <meta name="date" content="2016-05-25"> |
| <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style"> |
| </head> |
| <body> |
| <script type="text/javascript"><!-- |
| if (location.href.indexOf('is-external=true') == -1) { |
| parent.document.title="AbstractRememberMeManager (Apache Shiro 1.2.5 API)"; |
| } |
| //--> |
| </script> |
| <noscript> |
| <div>JavaScript is disabled on your browser.</div> |
| </noscript> |
| |
| <!-- ========= START OF TOP NAVBAR ======= --> |
| <div class="topNav"><a name="navbar_top"> |
| <!-- --> |
| </a><a href="#skip-navbar_top" title="Skip navigation links"></a><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="strong">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="http://java.sun.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="http://java.sun.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[])"><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[])"><code>cipherKey</code></a> configuration attribute.</div> |
| <dl><dt><span class="strong">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="overviewSummary" 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#AbstractRememberMeManager()">AbstractRememberMeManager</a></strong>()</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="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> |
| <caption><span>Methods</span><span class="tabEnd"> </span></caption> |
| <tr> |
| <th class="colFirst" scope="col">Modifier and Type</th> |
| <th class="colLast" scope="col">Method and Description</th> |
| </tr> |
| <tr 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#convertBytesToPrincipals(byte[], org.apache.shiro.subject.SubjectContext)">convertBytesToPrincipals</a></strong>(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 class="rowColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#convertPrincipalsToBytes(org.apache.shiro.subject.PrincipalCollection)">convertPrincipalsToBytes</a></strong>(<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 class="altColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#decrypt(byte[])">decrypt</a></strong>(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 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#deserialize(byte[])">deserialize</a></strong>(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[])"><code>deserialize</code></a> method.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#encrypt(byte[])">encrypt</a></strong>(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 class="rowColor"> |
| <td class="colFirst"><code>protected abstract void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#forgetIdentity(org.apache.shiro.subject.Subject)">forgetIdentity</a></strong>(<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 class="altColor"> |
| <td class="colFirst"><code>byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherKey()">getCipherKey</a></strong>()</code> |
| <div class="block">Convenience method that returns the cipher key to use for <em>both</em> encryption and decryption.</div> |
| </td> |
| </tr> |
| <tr 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getCipherService()">getCipherService</a></strong>()</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 class="altColor"> |
| <td class="colFirst"><code>byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getDecryptionCipherKey()">getDecryptionCipherKey</a></strong>()</code> |
| <div class="block">Returns the decryption cipher key to use for decryption operations.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code>byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getEncryptionCipherKey()">getEncryptionCipherKey</a></strong>()</code> |
| <div class="block">Returns the cipher key to use for encryption operations.</div> |
| </td> |
| </tr> |
| <tr 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getIdentityToRemember(org.apache.shiro.subject.Subject, org.apache.shiro.authc.AuthenticationInfo)">getIdentityToRemember</a></strong>(<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>.<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> |
| </td> |
| </tr> |
| <tr 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedPrincipals(org.apache.shiro.subject.SubjectContext)">getRememberedPrincipals</a></strong>(<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 class="altColor"> |
| <td class="colFirst"><code>protected abstract byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getRememberedSerializedIdentity(org.apache.shiro.subject.SubjectContext)">getRememberedSerializedIdentity</a></strong>(<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 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#getSerializer()">getSerializer</a></strong>()</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 class="altColor"> |
| <td class="colFirst"><code>protected boolean</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#isRememberMe(org.apache.shiro.authc.AuthenticationToken)">isRememberMe</a></strong>(<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 class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><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></strong>(<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 class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#onLogout(org.apache.shiro.subject.Subject)">onLogout</a></strong>(<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 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><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#onRememberedPrincipalFailure(java.lang.RuntimeException, org.apache.shiro.subject.SubjectContext)">onRememberedPrincipalFailure</a></strong>(<a href="http://java.sun.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 class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><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></strong>(<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 class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><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></strong>(<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 class="altColor"> |
| <td class="colFirst"><code>protected void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberIdentity(org.apache.shiro.subject.Subject, org.apache.shiro.subject.PrincipalCollection)">rememberIdentity</a></strong>(<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[])"><code>remembers</code></a> that |
| byte array.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code>protected abstract void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#rememberSerializedIdentity(org.apache.shiro.subject.Subject, byte[])">rememberSerializedIdentity</a></strong>(<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 class="altColor"> |
| <td class="colFirst"><code>protected byte[]</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#serialize(org.apache.shiro.subject.PrincipalCollection)">serialize</a></strong>(<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 class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherKey(byte[])">setCipherKey</a></strong>(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 class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setCipherService(org.apache.shiro.crypto.CipherService)">setCipherService</a></strong>(<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 class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setDecryptionCipherKey(byte[])">setDecryptionCipherKey</a></strong>(byte[] decryptionCipherKey)</code> |
| <div class="block">Sets the decryption key to use for decryption operations.</div> |
| </td> |
| </tr> |
| <tr class="altColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setEncryptionCipherKey(byte[])">setEncryptionCipherKey</a></strong>(byte[] encryptionCipherKey)</code> |
| <div class="block">Sets the encryption key to use for encryption operations.</div> |
| </td> |
| </tr> |
| <tr class="rowColor"> |
| <td class="colFirst"><code>void</code></td> |
| <td class="colLast"><code><strong><a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setSerializer(org.apache.shiro.io.Serializer)">setSerializer</a></strong>(<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="http://java.sun.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="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://java.sun.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="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://java.sun.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="http://java.sun.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="strong">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="strong">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="strong">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[])"><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[])"><code>setEncryptionCipherKey(byte[])</code></a> and <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setDecryptionCipherKey(byte[])"><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="strong">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="strong">Returns:</span></dt><dd>the cipher key to use for encryption operations.</dd><dt><span class="strong">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> |
| <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="strong">Parameters:</span></dt><dd><code>encryptionCipherKey</code> - the encryption key to use for encryption operations.</dd><dt><span class="strong">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="strong">Returns:</span></dt><dd>the cipher key to use for decryption operations.</dd><dt><span class="strong">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> |
| <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="strong">Parameters:</span></dt><dd><code>decryptionCipherKey</code> - the decryption key to use for decryption operations.</dd><dt><span class="strong">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="strong">Returns:</span></dt><dd>the symmetric cipher key used for both encryption and decryption.</dd></dl> |
| </li> |
| </ul> |
| <a name="setCipherKey(byte[])"> |
| <!-- --> |
| </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[])"><code>setEncryptionCipherKey(byte[])</code></a> and <a href="../../../../org/apache/shiro/mgt/AbstractRememberMeManager.html#setDecryptionCipherKey(byte[])"><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="strong">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="strong">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="strong">Parameters:</span></dt><dd><code>token</code> - the authentication token submitted during the successful authentication attempt.</dd> |
| <dt><span class="strong">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><strong>Specified by:</strong></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="strong">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="strong">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="strong">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="strong">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[])"><code>remembers</code></a> that |
| byte array.</div> |
| <dl><dt><span class="strong">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[])"><code>encrypts</code></a> that byte array.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>principals</code> - the <code>PrincipalCollection</code> to convert to a byte array</dd> |
| <dt><span class="strong">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> |
| <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="strong">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[], 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><strong>Specified by:</strong></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="strong">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="strong">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="strong">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="strong">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[], 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[])"><code>deserialized</code></a> and then returned.</div> |
| <dl><dt><span class="strong">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="strong">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="http://java.sun.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 |
| debug 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="strong">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="strong">Returns:</span></dt><dd>nothing - the original <code>RuntimeException</code> is propagated in all cases.</dd></dl> |
| </li> |
| </ul> |
| <a name="encrypt(byte[])"> |
| <!-- --> |
| </a> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>encrypt</h4> |
| <pre>protected byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.459">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="strong">Parameters:</span></dt><dd><code>serialized</code> - the serialized object byte array to be encrypted</dd> |
| <dt><span class="strong">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> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <h4>decrypt</h4> |
| <pre>protected byte[] <a href="../../../../src-html/org/apache/shiro/mgt/AbstractRememberMeManager.html#line.475">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="strong">Parameters:</span></dt><dd><code>encrypted</code> - the encrypted byte array to decrypt</dd> |
| <dt><span class="strong">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.492">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="strong">Parameters:</span></dt><dd><code>principals</code> - the principal collection to serialize to a byte array</dd> |
| <dt><span class="strong">Returns:</span></dt><dd>the serialized principal collection in the form of a byte array</dd></dl> |
| </li> |
| </ul> |
| <a name="deserialize(byte[])"> |
| <!-- --> |
| </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.503">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[])"><code>deserialize</code></a> method.</div> |
| <dl><dt><span class="strong">Parameters:</span></dt><dd><code>serializedIdentity</code> - the previously serialized <code>PrincipalCollection</code> as a byte array</dd> |
| <dt><span class="strong">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.516">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><strong>Specified by:</strong></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="strong">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.526">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><strong>Specified by:</strong></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="strong">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><a href="#skip-navbar_bottom" title="Skip navigation links"></a><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="strong">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-2016 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.</small></p> |
| </body> |
| </html> |