Method invoked by the ModularAuthenticator signifying that the authentication process is about to begin for the
specified {@code token} - called before any {@code Realm} is actually invoked.
<p>The {@code AuthenticationInfo} object returned from this method is essentially an empty place holder for
aggregating account data across multiple realms. It should be populated by the strategy implementation over the
course of authentication attempts across the multiple realms. It will be passed into the
{@link #beforeAttempt} calls, allowing inspection of the aggregated account data up to that point in the
multi-realm authentication, allowing any logic to be executed accordingly.
@param realms the Realms that will be consulted during the authentication process for the specified token.
@param token the Principal/Credential representation to be used during authentication for a corresponding subject.
@return an empty AuthenticationInfo object that will populated with data from multiple realms.
@throws AuthenticationException if the strategy implementation does not wish the Authentication attempt to execute.
Method invoked by the ModularAuthenticator signifying that the authentication process is about to begin for the specified {@code token} - called before any {@code Realm} is actually invoked.
<p>The {@code AuthenticationInfo} object returned from this method is essentially an empty place holder for aggregating account data across multiple realms. It should be populated by the strategy implementation over the course of authentication attempts across the multiple realms. It will be passed into the {@link #beforeAttempt} calls, allowing inspection of the aggregated account data up to that point in the multi-realm authentication, allowing any logic to be executed accordingly.
@param realms the Realms that will be consulted during the authentication process for the specified token. @param token the Principal/Credential representation to be used during authentication for a corresponding subject. @return an empty AuthenticationInfo object that will populated with data from multiple realms. @throws AuthenticationException if the strategy implementation does not wish the Authentication attempt to execute.