Allows to check if the given connection have been successfully authenticated.
Keep in mind this function will return FALSE either because the connection is not successfully authenticated or because current Vortex Library doesn't have SASL support.
Another issue is that this function will return TRUE for SASL operations requiring any SASL profile that have successfully ended. This includes ANONYMOUS profile.
Obviously, ANONYMOUS profile *DOES NOT* not provide any security measure. Inside environments that allows ANONYMOUS and other profiles such as PLAIN, CRAM-MD5 and DIGEST-MD5 could yield to authorize users that only have provided an anonymous token.
A good practice is not to mix on the same session ANONYMOUS profile and authentication based profiles. Design you code keeping this issue in mind.
|connection ||The connection to check for authentication status.|
- TRUE if the connection is authenticated, FALSE if not.