First pass refactoring for SSO Login authentication flow (#59)

* Start refactoring to support both username and password auth, as well as SSO login flows

* Wrap up refactor

* Start cleaning up

* more cleanup

* Properly handle SSO Session expiration

* bump to release version 3.0.0

* start on docs

* start on docs

* start on docs

* update docs

* update readme

* update docs

* finishd ocs

* finishd ocs

Author: Crim

.gitignore

@@ -4,3 +4,4 @@ target/
 
 ## Ignore credentials for running integration tests
 src/test/resources/test_credentials.properties
+src/test/resources/*_credentials.properties

3_0_0_migration_notes.MD

@@ -0,0 +1,51 @@
+# Pardot Java API Client 2.x.x to 3.0.0 Migration Guide
+
+## Authentication & Configuration Breaking Changes
+
+In order to properly support the transition of the Pardot API from authenticating using Pardot username, password, and user keys, to 
+Salesforce Single Signon, several breaking changes were made to how you configure the Pardot API Client.
+
+### Configuration class replaced with ConfigurationBuilder.
+
+Where before you created a `Configuration` object, that class has now been replaced by `ConfigurationBuilder`.
+
+**Code that may have looked like this previously**
+```java
+final Configuration configuration = new Configuration("YourPardotUserNameHere", "PardotPassword", "UserKey");
+final PardotClient client = new PardotClient(configuration);
+```
+
+**Should now look like this**
+```java
+final ConfigurationBuilder configuration = Configuration.newBuilder()
+    // NOTE: Authenticating using this method will cease to function after ~ Feb. 1 2021.
+    //       See section below about migrating to SSO authentication.
+    .withUsernameAndPasswordLogin(
+        "YourPardotUsername",
+        "YourPardotPassword",
+        "YourPardotUserKey"
+    );
+
+// Call other methods on configuration instance as needed to complete configuration.
+final PardotClient client = new PardotClient(configuration);
+```
+
+### Pardot Username and Password Authentication Scheme deprecated in favor of Salesforce SSO Authentication.
+
+From February 1, 2021 Pardot is removing the now legacy Pardot Username and Password authentication scheme ([Salesforce EOL Notice](https://help.salesforce.com/articleView?id=000353746&type=1&mode=1&language=en_US&utm_source=techcomms&utm_medium=email&utm_campaign=eol)).
+
+You should switch to configuring authentication using the following method:
+
+```java
+final ConfigurationBuilder configuration = Configuration.newBuilder()
+    .withSsoLogin(
+        "YourSalesforceUsername",
+        "YourSalesforcePassword",
+        "YourConnectedAppClientId",
+        "YourConnectedAppClientSecret",
+        "YourPardotBusinessUnitId"
+    );
+final PardotClient client = new PardotClient(configuration);
+```
+
+See [Offical Pardot Developer Documentation](https://developer.pardot.com/kb/authentication/) and [Salesforce OAuth Setup](https://help.salesforce.com/articleView?id=remoteaccess_oauth_flows.htm) for details on how to obtain the above required properties.

CHANGELOG.md

@@ -2,6 +2,12 @@
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## 3.0.0 (UNRELEASED)
+- [ISSUE-58](https://github.com/Crim/pardot-java-client/issues/58) Add support for Salesforce SSO authentication.
+
+### Breaking Change
+See [3.0.0 Migration Notes](3_0_0_migration_notes.MD) for details on breaking changes and how to upgrade.
+
 ## 2.1.0 (07/30/2020)
 - [ISSUE-56](https://github.com/Crim/pardot-java-client/issues/56) Adds support for Dynamic Content.
 

README.md

@@ -4,9 +4,18 @@
 
 ## What is it? 
 
-A fluent-ish style API client for Pardot's API (version 3 and 4).
+This library is a fluent style API client for Pardot's API (version 3 and 4).
 
-**Note** It currently is not fully featured/fully implemented. If there is a feature/end point that you
+## Important Breaking Change to Pardot API
+
+From February 1, 2021 Pardot is removing the ability to authenticate to the Pardot API using your Pardot username, password, and userkey ([Salesforce EOL Notice](https://help.salesforce.com/articleView?id=000353746&type=1&mode=1&language=en_US&utm_source=techcomms&utm_medium=email&utm_campaign=eol)).
+This means that versions of this library **prior to 3.0.0** will cease to be able to authenticate to the Pardot Api.
+
+Everyone is encouraged to update the library to version **3.0.0 or newer** and switch to using Salesforce SSO authentication prior to February 1, 2021. 
+To support Salesforce SSO authentication required backwards compatibility breaking changes to be made to this library, so please read the [2.x.x to 3.0.0 Migration Guide](3_0_0_migration_notes.MD) 
+which details the changes required to upgrade.
+
+**Note** While most of Pardot's API is supported by this library, if there is a feature/end point that you
 need that is not yet implemented, please read the **[How to Contribute](#how-to-contribute)** section, or **[Create an issue](https://github.com/Crim/pardot-java-client/issues)** 
 requesting it. 
 
@@ -21,23 +30,31 @@ This client library is released on Maven Central.  Add a new dependency to your
 <dependency>
     <groupId>com.darksci</groupId>
     <artifactId>pardot-api-client</artifactId>
-    <version>2.1.0</version>
+    <version>3.0.0</version>
 </dependency>
 ```
 
-Example Code:
+Example Code using Salesforce SSO Authentication:
 ```java
 /*
- * Create a new configuration object with your Pardot credentials.
+ * Create a new configuration object with your Salesforce SSO credentials.
  *
  * This configuration also allows you to define some optional details on your connection,
  * such as using an outbound proxy (authenticated or not).
  */
-final Configuration configuration = new Configuration("YourPardotUserNameHere", "PardotPassword", "UserKey");
+final ConfigurationBuilder configuration = Configuration.newBuilder()
+    .withSsoLogin(
+        "YourSalesforceUsername",
+        "YourSalesforcePassword",
+        "YourConnectedAppClientId",
+        "YourConnectedAppClientSecret",
+        "YourPardotBusinessUnitId"
+    );
 
 /*
- * Optionally select which API version to use, if none is explicitly selected
- * the library will default to version 3.
+ * Optionally you can explicitly select which API version to use. If none is explicitly selected
+ * the library will default to version 3, but the library will automatically upgrade to version
+ * 4 if required to do so.
  */
 configuration.withApiVersion3();
 
@@ -58,7 +75,6 @@ final PardotClient client = new PardotClient(configuration);
 final AccountReadRequest accountReadRequest = new AccountReadRequest();
 final Account account = client.accountRead(accountReadRequest);
 
-
 /*
  * Or lets do a more complex Campaign search.
  */
@@ -80,7 +96,6 @@ Or Using the Try-With-Resources Pattern:
 /*
  * Since PardotClient implements Autoclosable, you can also use the try-with-resources pattern.
  */
-final Configuration configuration = new Configuration("YourPardotUserNameHere", "PardotPassword", "UserKey");
 try (final PardotClient client = new PardotClient(configuration)) {
     // Use client instance as needed
     client.accountRead(new AccountReadRequest());
@@ -92,16 +107,16 @@ try (final PardotClient client = new PardotClient(configuration)) {
 ## What Features are implemented?
 
 ### Authentication
-Official Documentation: [Authentication](http://developer.pardot.com/#authentication)
+Official Documentation: [Authentication](https://developer.pardot.com/kb/authentication/)
 
-Authenticating with Pardot's API using your Pardot Username, Password, and User Token.  
+- Authenticating with Pardot's API using your Salesforce SSO Username, Password, and Connected Application details. [See Example](src/main/java/com/darksci/pardot/api/Example.java#L37).
+- Legacy authentication using your Pardot Username, Password, and User Token. [See Example](src/main/java/com/darksci/pardot/api/Example.java#L98). 
 
 ### Accounts
 Official Documentation: [Accounts](http://developer.pardot.com/kb/api-version-3/accounts/)
 
 - Read
 
-
 ### Campaigns
 Official Documentation: [Campaigns](http://developer.pardot.com/kb/api-version-3/campaigns/)
 
@@ -228,14 +243,6 @@ Official Documentation: [VisitorActivities](http://developer.pardot.com/kb/api-v
 - Query
 - Read
 
-## Important Breaking Change to Pardot API
-
-As of October 31, 2018 Pardot is disabling the TLS 1.0 encryption protocol.  This means that versions of this library
-**prior to 1.0.0** will cease to be able to connect to the Pardot Api.
-
-Version 1.0.0+ updates the library to use TLS 1.1 and 1.2 protocols. Everyone is encouraged to update
-the library prior to October 31st 2018.
-
 ## How to Contribute 
 
 Want to help implement the missing API end points?  Fork the repository, write some code, and 

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.darksci</groupId>
     <artifactId>pardot-api-client</artifactId>
-    <version>2.1.0</version>
+    <version>3.0.0</version>
     <packaging>jar</packaging>
 
     <!-- Require Maven 3.5.0 -->