Retrieves authentication data from an implementation-specific datasource (RDBMS, LDAP, etc) for the given
authentication token.
<p/>
For most datasources, this means just 'pulling' authentication data for an associated subject/user and nothing
more and letting Shiro do the rest. But in some systems, this method could actually perform EIS specific
log-in logic in addition to just retrieving data - it is up to the Realm implementation.
<p/>
A {@code null} return value means that no account could be associated with the specified token.
@param token the authentication token containing the user's principal and credentials.
@return an {@link AuthenticationInfo} object containing account data resulting from the
authentication ONLY if the lookup is successful (i.e. account exists and is valid, etc.)
@throws AuthenticationException if there is an error acquiring data or performing
realm-specific authentication logic for the specified <tt>token</tt>
Retrieves authentication data from an implementation-specific datasource (RDBMS, LDAP, etc) for the given authentication token. <p/> For most datasources, this means just 'pulling' authentication data for an associated subject/user and nothing more and letting Shiro do the rest. But in some systems, this method could actually perform EIS specific log-in logic in addition to just retrieving data - it is up to the Realm implementation. <p/> A {@code null} return value means that no account could be associated with the specified token.
@param token the authentication token containing the user's principal and credentials. @return an {@link AuthenticationInfo} object containing account data resulting from the authentication ONLY if the lookup is successful (i.e. account exists and is valid, etc.) @throws AuthenticationException if there is an error acquiring data or performing realm-specific authentication logic for the specified <tt>token</tt>