Method invoked by the ModularAuthenticator just after the given realm has been consulted for authentication,
allowing post-authentication-attempt logic for that realm only.
<p>This method returns an {@code AuthenticationInfo} object that will be used for further interaction with realms. Most
implementations will merge the {@code singleRealmInfo} into the {@code aggregateInfo} and
just return the {@code aggregateInfo} for continued use throughout the authentication process.</p>
@param realm the realm that was just consulted for {@code AuthenticationInfo} for the given {@code token}.
@param token the {@code AuthenticationToken} submitted for the subject attempting system log-in.
@param singleRealmInfo the info returned from a single realm.
@param aggregateInfo the aggregate info representing all realms in a multi-realm environment.
@param t the Throwable thrown by the Realm during the attempt, or {@code null} if the method returned normally.
@return the AuthenticationInfo object that will be presented to further realms in the authentication process - returning
the {@code aggregateAccount} method argument is the normal case if no special action needs to be taken.
@throws AuthenticationException an exception thrown by the Strategy implementation if it wishes the login process
for the associated subject (user) to stop immediately.
Method invoked by the ModularAuthenticator just after the given realm has been consulted for authentication, allowing post-authentication-attempt logic for that realm only.
<p>This method returns an {@code AuthenticationInfo} object that will be used for further interaction with realms. Most implementations will merge the {@code singleRealmInfo} into the {@code aggregateInfo} and just return the {@code aggregateInfo} for continued use throughout the authentication process.</p>
@param realm the realm that was just consulted for {@code AuthenticationInfo} for the given {@code token}. @param token the {@code AuthenticationToken} submitted for the subject attempting system log-in. @param singleRealmInfo the info returned from a single realm. @param aggregateInfo the aggregate info representing all realms in a multi-realm environment. @param t the Throwable thrown by the Realm during the attempt, or {@code null} if the method returned normally. @return the AuthenticationInfo object that will be presented to further realms in the authentication process - returning the {@code aggregateAccount} method argument is the normal case if no special action needs to be taken. @throws AuthenticationException an exception thrown by the Strategy implementation if it wishes the login process for the associated subject (user) to stop immediately.