Added sample TPP client code

Author: tr1ck3r

README.md

@@ -12,7 +12,7 @@ VCert releases are tested using the latest version of Trust Protection Platform.
 
 ## Installation
 
-The current version of this library can be install using
+The current version of this library can be installed using Maven:
 
 ```
 mvn install
@@ -143,13 +143,13 @@ To run the acceptance tests the following environment variables must be set:
 
 | NAME | NOTES |
 |------|-------|
-| VENAFI_USER | |
-| VENAFI_PASSWORD | |
+| VENAFI_USER | Only for TPP connector tests |
+| VENAFI_PASSWORD | Only for TPP connector tests |
 | VENAFI_TPP_URL | Only for TPP connector tests |
-| VENAFI_API_KEY | Taken from account after logged in |
+| VENAFI_API_KEY | Taken from account after logged into TPP |
 | VENAFI_CERT_COMMON_NAME | Used for cert creation, should match configured domains |
 | VENAFI_CLOUD_URL | Only for cloud connector tests |
-| VENAFI_ZONE | Only for cloud connector tests |
+| VENAFI_ZONE | Policy folder for TPP |
 
 Acceptance test  are executed with:
 ```

examples/TppClient.java

@@ -0,0 +1,72 @@
+import com.venafi.vcert.sdk.Config;
+import com.venafi.vcert.sdk.VCertException;
+import com.venafi.vcert.sdk.VCertClient;
+
+import com.venafi.vcert.sdk.certificate.CertificateRequest;
+import com.venafi.vcert.sdk.certificate.KeyType;
+import com.venafi.vcert.sdk.certificate.PEMCollection;
+import com.venafi.vcert.sdk.certificate.RenewalRequest;
+import com.venafi.vcert.sdk.connectors.tpp.ZoneConfiguration;
+import com.venafi.vcert.sdk.endpoint.Authentication;
+import com.venafi.vcert.sdk.endpoint.ConnectorType;
+import org.apache.commons.codec.digest.DigestUtils;
+
+import java.security.cert.CertificateEncodingException;
+import java.security.cert.X509Certificate;
+import java.util.Arrays;
+import java.util.Collections;
+
+public class TppClient
+{
+    public static void main(String ... args) throws VCertException, CertificateEncodingException
+    {
+	String tpp_user = System.getenv("TPP_USER");
+	String tpp_passwd = System.getenv("TPP_PASSWORD");
+        String url = System.getenv("VENAFI_URL");
+	String zone = System.getenv("VENAFI_ZONE");
+
+	if ( tpp_user == null ) tpp_user = "local:admin";
+	if ( tpp_passwd == null ) tpp_passwd = "Passw0rd";
+	if ( url == null ) url = "https://tpp.venafi.example/vedsdk";
+	if ( zone == null ) zone = "Default";
+
+        final Config config = Config.builder()
+                .connectorType(ConnectorType.TPP)
+                .baseUrl(url)
+                .build();
+
+        final VCertClient client = new VCertClient(config);
+
+        final Authentication auth = Authentication.builder()
+                .user(tpp_user)
+                .password(tpp_passwd)
+                .build();
+
+        client.authenticate(auth);
+	
+        final ZoneConfiguration zoneConfiguration = client.readZoneConfiguration(zone);
+
+        // Generate a certificate
+        CertificateRequest certificateRequest = new CertificateRequest().subject(
+                new CertificateRequest.PKIXName()
+                        .commonName("vcert-java.venafi.example")
+                        .organization(Collections.singletonList("Venafi, Inc."))
+                        .organizationalUnit(Arrays.asList("Product Management"))
+                        .country(Collections.singletonList("US"))
+                        .locality(Collections.singletonList("Salt Lake City"))
+                        .province(Collections.singletonList("Utah")))
+
+                .keyType(KeyType.RSA)
+                .keyLength(2048);
+
+        certificateRequest = client.generateRequest(zoneConfiguration, certificateRequest);
+
+        // Submit the certificate request
+        String newCertId = client.requestCertificate(certificateRequest, zone);
+
+        // Retrieve PEM collection from Venafi
+        final CertificateRequest pickupRequest = new CertificateRequest().pickupId(newCertId);
+        PEMCollection pemCollection = client.retrieveCertificate(pickupRequest);
+        System.out.println(pemCollection.certificate());
+    }
+}