Metacat

We ended up not being able to use IO::Socket::SSL, so I removed the import statement. Also, add the new Perl module dependencies to the installation documentation.

refs https://github.nceas.ucsb.edu/KNB/arctic-data/issues/42

Change getUsername() to also support adding usernames into an EML access element from the authentication token's 'sub' claim.
Also, add a bit of debugging output for tracing the flow of the XML generation.

refs https://github.nceas.ucsb.edu/KNB/arctic-data/issues/42

Modify the Metacat.pm upload() method to use the correct Content-Type for the form. RFC 2388 specifies that the Content-Type should be "multipart/form-data", and that the Content-Disposition should be "form-data", along with the "name" parameter.

dd the hasValidAuthToken() method to determine if the current token (if any) is valid. Use this and validateSession() within the script to determine if we need to call Metacat->login() or not. Add some minor debugging to work through the code stages using auth tokens....

Fix a couple of syntax issues.

refs https://github.nceas.ucsb.edu/KNB/arctic-data/issues/42

Don't forget to set the token variable from the HTTP_AUTHORIZATION environment variable.

refs https://github.nceas.ucsb.edu/KNB/arctic-data/issues/42

Add a setAuthToken() method. when the HTTP_AUTHORIZATION environment variable is set, set the value as the `auth_token_header` instance variable in the Metacat instance passed in. This requires that the Apache installation includes an HTTP rewrite rule to pass the header on to an CGI processing the request. Call this method whenever we instantiate a Metacat object....

Modify the Metacat.pm sendData() method to include the Authorization HTTP header when it's available as an instance variable.

refs https://github.nceas.ucsb.edu/KNB/arctic-data/issues/41

If the user doesn's specify the ldap ca file path on the metacat.properties, it will use the default one.

correct logout method (old change still in workspace)