ill only take place (should no errors occur) after the authentication mechanism
 in which this call takes place returns control back to the container (runtime).
 
 <p>
 As a convenience this method returns SUCCESS, so this method can be used in
 one fluent return statement from an <a href="HttpAuthenticationMechanism.html" title="interface in jakarta.security.enterprise.authentication.mechanism.http"><code>HttpAuthenticationMechanism</code></a></div>
<dl class="notes">
<dt>Parameters:</dt>
<dd><code>princip