############
CustomerAuth
############


****
NAME
****


Kernel::System::CustomerAuth - customer authentication module.


***********
DESCRIPTION
***********


The authentication module for the customer interface.


****************
PUBLIC INTERFACE
****************


new()
=====


Don't use the constructor directly, use the ObjectManager instead:


.. code-block:: perl

     my $CustomerAuthObject = $Kernel::OM->Get('Kernel::System::CustomerAuth');



GetOption()
===========


Get module options. Currently there is just one option, "PreAuth".


.. code-block:: perl

     if ($AuthObject->GetOption(What => 'PreAuth')) {
         print "No login screen is needed. Authentication is based on other options. E. g. $ENV{REMOTE_USER}\n";
     }



Auth()
======


The authentication function.


.. code-block:: perl

     if ($AuthObject->Auth(User => $User, Pw => $Pw)) {
         print "Auth ok!\n";
     }
     else {
         print "Auth invalid!\n";
     }



GetLastErrorMessage()
=====================


Retrieve $Self->{LastErrorMessage} content.


.. code-block:: perl

     my $AuthErrorMessage = $AuthObject->GetLastErrorMessage();
 
     Result:
 
         $AuthErrorMessage = "An error string message.";