Authentication

Timberwolf uses JAAS authentication when interacting with Exchange. Java looks for the JAAS configuration file at "~/.java.login.config" by default, but you can also specify the configuration file with the java argument: "-Djava.security.auth.login.config=${conf_file}" (note that this argument must come before the "-jar" argument). It will look for a "Timberwolf" entry. We provide you with a very simple sample file for kerberos authentication that you can start with. It's the "sample_jaas.config" file in the root directory of the project.

Timberwolf {
    com.sun.security.auth.module.Krb5LoginModule required client=TRUE useTicketCache=true;
};

This setup will cause Timberwolf to use whoever you are currently authenticated as through "kinit". If you have not authenticated with kinit, then Timberwolf will prompt you for the password of whoever you're currently logged in as.

You can use this file if JAAS authentication is not already configured on your machine. But you can actually use JAAS to authenticate through several sort of authentication methods (NTLM, KeyStore, JNDI, ...). If you're unfamiliar with JAAS authentication, you may consider reading into the online documentation to know what it's capable of.

###Quick Walkthrough### If you just want to get started, then follow these instructions:

1. cd into the project root directory
2. copy the sample_jaas.config to ~/.java.configuration.config
3. kinit [email protected]

Choose a [email protected] who has impersonation rights on the exchange server you're hitting.