authenticate

Authenticates a user by credential and returns a UserIdPrincipal instance if the credential pair is valid.